Lewati ke konten
Kelarin Proyek
19 November 2026

Error Umum PHP dan MySQL serta Solusinya

Daftar error PHP dan MySQL yang paling sering muncul: koneksi ditolak, undefined index, headers already sent, SQL syntax, dan cara memperbaikinya.

Error PHP dan MySQL cenderung berulang: orang yang berbeda menabrak pesan yang sama di titik yang sama. Mengenali polanya menghemat berjam-jam. Artikel ini mengumpulkan error yang paling sering muncul pada proyek PHP native dan framework, beserta penyebab dan perbaikannya dalam bentuk kode yang bisa langsung dicoba.

Aktifkan pelaporan error saat mengembangkan

Sebelum memburu error, pastikan PHP benar-benar menampilkannya. Banyak halaman putih terjadi karena error disembunyikan. Di lingkungan pengembangan, tambahkan di bagian paling atas berkas utama:

<?php
ini_set('display_errors', '1');
error_reporting(E_ALL);

Matikan lagi di produksi dan arahkan error ke berkas log. Menampilkan pesan error ke pengunjung membocorkan jalur berkas dan kadang kredensial.

1. SQLSTATE[HY000] [2002] Connection refused

Pesan ini berarti PHP tidak bisa menjangkau server MySQL. Penyebab umum: MySQL belum berjalan, host atau port salah, atau di XAMPP port berbenturan dengan layanan lain.

$pdo = new PDO(
    'mysql:host=127.0.0.1;port=3306;dbname=toko;charset=utf8mb4',
    'root',
    '',
    [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
);

Periksa bahwa modul MySQL menyala di panel XAMPP, lalu coba 127.0.0.1 sebagai pengganti localhost, karena di beberapa sistem localhost memakai soket yang berbeda. Di server, pastikan firewall tidak memblokir port bila database berada di mesin lain.

2. Access denied for user

Kredensial salah atau pengguna tidak punya hak pada database itu. Bedakan dari error koneksi: server MySQL menjawab, tetapi menolak.

SHOW GRANTS FOR 'aplikasi_user'@'localhost';
GRANT ALL PRIVILEGES ON toko.* TO 'aplikasi_user'@'localhost';
FLUSH PRIVILEGES;

Perhatikan bahwa 'user'@'localhost' dan 'user'@'%' dianggap pengguna berbeda. Pastikan host pada hak akses sesuai dengan dari mana aplikasi terhubung.

3. Unknown database dan table doesn't exist

Database atau tabel belum dibuat di lingkungan tempat kode berjalan. Ini sangat umum saat kode pindah dari laptop ke server atau ke komputer dosen, karena data tidak ikut terbawa. Selalu sertakan berkas SQL, atau lebih baik, migrasi. Cek keberadaannya:

SHOW DATABASES;
USE toko;
SHOW TABLES;

Perhatikan juga huruf besar kecil: di Linux, nama tabel peka huruf besar kecil, sedangkan di Windows tidak. Kode yang jalan di XAMPP Windows bisa gagal di server Linux karena Produk dan produk dianggap berbeda.

4. You have an error in your SQL syntax

Pesan ini muncul ketika kueri tidak valid. Penyebab paling sering: kata cadangan dipakai sebagai nama kolom (seperti order, group, atau key), tanda kutip tidak seimbang, atau variabel kosong yang membuat kueri terpotong.

// Rawan: input langsung disisipkan, mudah error dan rawan injeksi
$sql = "SELECT * FROM users WHERE name = '$name'";

// Benar: prepared statement
$stmt = $pdo->prepare('SELECT * FROM users WHERE name = :name');
$stmt->execute(['name' => $name]);
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);

Prepared statement menyelesaikan dua masalah sekaligus: kutip yang rusak oleh nama seperti O'Brien, dan serangan SQL injection. Bila kamu terpaksa memakai nama kolom bentrok, apit dengan tanda backtick seperti ` order `.

5. Undefined index dan Undefined array key

Kamu mengakses kunci array yang tidak ada, biasanya dari $_POST atau $_GET saat form belum dikirim.

// Memicu peringatan bila tombol belum ditekan
$nama = $_POST['nama'];

// Aman dengan operator null coalescing
$nama = $_POST['nama'] ?? '';

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // proses form di sini
}

Bungkus pemrosesan form dengan pengecekan metode permintaan, dan beri nilai bawaan lewat ??. Cara ini lebih bersih daripada menekan peringatan dengan simbol @.

6. Headers already sent

Error ini muncul ketika kamu memanggil header(), session_start(), atau setcookie() setelah ada keluaran yang sudah dikirim, termasuk spasi atau baris kosong sebelum tag <?php.

<?php
session_start();          // harus sebelum keluaran apa pun
if (!isset($_SESSION['user'])) {
    header('Location: login.php');
    exit;                 // wajib agar kode di bawahnya tidak jalan
}

Pastikan tidak ada spasi sebelum <?php dan, untuk berkas berisi PHP murni, jangan tulis tag penutup ?>. Beberapa editor menambahkan BOM pada berkas UTF-8, yang juga dihitung sebagai keluaran. Simpan sebagai UTF-8 tanpa BOM.

7. Call to undefined function mysqli_connect atau PDO tidak ditemukan

Ekstensi yang dibutuhkan belum aktif di PHP. Periksa dengan:

php -m | grep -i -E "mysqli|pdo_mysql"

Di XAMPP, aktifkan baris extension=mysqli atau extension=pdo_mysql di php.ini, lalu mulai ulang Apache. Di hosting, aktifkan lewat menu pemilih versi PHP. Perhatikan juga bahwa versi PHP di CLI dan di web server bisa berbeda, jadi cek dengan phpinfo() dari peramban.

8. Maximum execution time dan Allowed memory size exhausted

Skrip berjalan terlalu lama atau memakai memori terlalu banyak, biasanya karena memuat seluruh hasil kueri besar ke array atau melakukan perulangan tak berujung.

// Hemat memori: proses baris demi baris
$stmt = $pdo->query('SELECT id, nama FROM pelanggan');
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    // proses satu baris
}

Naikkan batas di php.ini hanya sebagai solusi sementara. Perbaikan sesungguhnya adalah membatasi data lewat LIMIT dan paginasi, atau memperbaiki kueri yang lambat dengan indeks.

9. Gagal mengunggah berkas

Unggahan gagal diam-diam sering disebabkan batas ukuran. Periksa upload_max_filesize dan post_max_size di php.ini, pastikan form memakai enctype="multipart/form-data", dan cek kode galat unggahan:

if ($_FILES['berkas']['error'] !== UPLOAD_ERR_OK) {
    die('Unggahan gagal, kode: ' . $_FILES['berkas']['error']);
}

Kode 1 berarti melebihi batas upload_max_filesize, dan kode 4 berarti tidak ada berkas dipilih. Selalu validasi jenis dan ukuran berkas di sisi server, jangan hanya di JavaScript.

Kebiasaan yang mencegah sebagian besar error

  • Pakai PDO atau mysqli dengan prepared statement untuk semua input pengguna.
  • Simpan konfigurasi koneksi di satu berkas dan jangan menyalinnya ke banyak tempat.
  • Tulis skrip SQL atau migrasi sehingga database bisa dibangun ulang kapan saja.
  • Uji di lingkungan yang mirip tempat aplikasi akan dijalankan.

Bila masih buntu

Jika setelah semua ini error tetap ada, kumpulkan pesan lengkap, potongan kode, dan versi PHP serta MySQL, lalu kirim ke orang yang bisa membantu. Untuk perbaikan langsung, lihat jasa debugging dan perbaikan error. Aplikasi PHP yang ingin dibuat dari awal bisa lewat jasa aplikasi PHP native, dan masalah skema atau kueri lewat jasa database MySQL. Siap melanjutkan? Pesan di sini dan masalahnya kita tulis dulu di SOW.

Punya proyek? Ngobrol dulu, gratis.