Halaman PHP yang tadinya jalan normal tiba-tiba menampilkan peringatan Warning: Undefined variable $nama, lalu sebagian konten hilang. Kondisi ini muncul ketika kode memakai variabel yang belum pernah diisi nilainya, dan cara memperbaiki undefined variable di PHP selalu berawal dari membaca baris kode yang disebut notifikasi.
PHP menandai variabel belum terdefinisi sebagai peringatan, bukan error fatal. Halaman tetap terbuka, tetapi variabel tersebut bernilai null sehingga hasil akhirnya bisa berupa teks kosong atau perilaku aneh di bagian lain.
Kenapa PHP Menganggap Variabelnya Tidak Ada
Setiap variabel di PHP hidup dalam ruang lingkup tertentu. Di dalam fungsi, variabel dari luar tidak otomatis terbaca. Di dalam file yang di-include, variabel global tetap terlihat, tetapi variabel lokal yang dideklarasikan setelah include tidak. Notifikasi undefined variable hampir selalu muncul karena tiga pola berikut.
- Variabel diisi di dalam
iftertentu saja, lalu dipakai di luar blok tanpa jaminan kondisi terpenuhi. - Nama variabel salah ketik, misalnya
$userNamedideklarasikan tetapi yang dipanggil$username. PHP peka huruf besar dan kecil. - Data dari form atau query string tidak memiliki kunci yang diharapkan, misalnya
$_POST['email']ketika field tersebut tidak dikirim.
Polanya mirip dengan kesalahan umum lain yang dibahas di daftar kesalahan umum menulis kode PHP, di mana kode berjalan tetapi hasilnya tidak sesuai karena asumsi tentang isi variabel tidak pernah diperiksa.
Membaca Notifikasi dengan Benar
Notifikasi PHP menyebut nama file dan nomor baris. Buka baris itu, bukan baris setelahnya. Contoh pesan Undefined variable $total on line 42 berarti pada baris 42 variabel $total dibaca sebelum sempat diberi nilai. Telusuri ke atas untuk mencari tempat variabel itu seharusnya diisi.
Jika notifikasi tidak muncul, konfigurasi display_errors kemungkinan dimatikan. Untuk pengembangan di komputer lokal, aktifkan lewat php.ini:
display_errors = On
error_reporting = E_ALL
Jangan gunakan pengaturan ini di server produksi karena pesan error bisa memperlihatkan struktur direktori dan isi kode. Di server produksi, catat error ke file log lalu baca log tersebut.
Contoh Kasus dan Perbaikannya
Perhatikan potongan kode berikut:
$diskon = 0;
if ($total > 500000) {
$diskon = 10;
}
echo $total - ($total * $diskon / 100);
Kode di atas aman karena $diskon sudah diberi nilai awal sebelum blok if. Bandingkan dengan versi yang sering ditulis pemula:
if ($total > 500000) {
$diskon = 10;
}
echo $total - ($total * $diskon / 100);
Ketika $total tidak melewati batas, blok if dilewati dan $diskon tidak pernah dibuat. PHP lalu mengeluh saat baris echo membaca variabel itu. Solusinya sederhana: beri nilai awal sebelum dipakai.
Variabel dari Input Pengguna
Input dari luar selalu bisa kosong. Mengakses $_GET['halaman'] tanpa memeriksa keberadaannya akan memicu notifikasi ketika URL tidak memuat parameter itu. Gunakan null coalescing operator yang tersedia di PHP 7 ke atas:
$halaman = $_GET['halaman'] ?? 1;
$cari = trim($_GET['cari'] ?? '');
Untuk PHP versi lama, isset() atau array_key_exists() memberi hasil serupa. Pilihan mana pun lebih rapi daripada mematikan peringatan dengan simbol @, karena cara itu menyembunyikan masalah tanpa memperbaikinya.
Variabel di Dalam Fungsi
Variabel global tidak otomatis terbaca di dalam fungsi. Kode berikut akan memicu notifikasi:
$tarif = 5000;
function hitung($jumlah) {
return $jumlah * $tarif;
}
Alihkan nilai lewat parameter, bukan lewat kata kunci global:
function hitung($jumlah, $tarif) {
return $jumlah * $tarif;
}
echo hitung(3, 5000);
Cara ini membuat fungsi lebih mudah diuji dan tidak bergantung pada keadaan di luar. Ketika kode fungsi mulai banyak, pemindahan data lewat parameter mengurangi peluang notifikasi semacam ini muncul kembali.
Cek Alur Logika, Bukan Hanya Baris Error
Notifikasi undefined variable biasanya menunjuk gejala, bukan sumber masalah. Variabel yang kosong sering jadi tanda bahwa cabang logika tertentu tidak pernah dijalankan. Misalnya, data gagal diambil dari database karena query mengembalikan nol baris, lalu variabel penampung tidak diisi.
Jika variabel berasal dari hasil query, periksa dulu apakah query benar-benar mengembalikan data. Artikel tentang validasi form PHP dan JavaScript membahas cara memastikan data masuk sebelum diproses lebih jauh, dan pola pemeriksaan yang sama berlaku untuk data dari database.
Untuk alur yang melibatkan banyak kondisi, debugging dengan mencetak isi variabel di beberapa titik membantu melacak di mana nilainya hilang. Bila error yang muncul bukan dari PHP melainkan dari skrip di browser, langkah penanganannya berbeda dan dibahas di cara menangani error JavaScript di browser.
Kapan Sebaiknya Tidak Menyembunyikan Peringatan
Ada kebiasaan lama mematikan notifikasi dengan error_reporting(0) agar halaman terlihat bersih. Cara itu berisiko karena bug tetap ada dan baru terasa ketika data pengguna sungguhan masuk. Notifikasi undefined variable termasuk peringatan yang paling mudah ditindaklanjuti, jadi lebih baik diatasi satu per satu.
Pada proyek besar, notifikasi seperti ini bisa menumpuk. Menulis kode dengan inisialisasi nilai awal, memeriksa kunci array sebelum diakses, dan menghindari variabel global di dalam fungsi mengurangi jumlahnya secara alami.
Saat istirahat dari debugging, sebagian orang mencari tontonan santai. Untuk penggemar basket, sepak bola, atau UFC, tarkamlive menyediakan siaran bareng dengan host yang menghibur, cocok menemani jeda sebelum kembali membaca log error. Sementara itu, untuk mengikuti kabar olahraga dan berita lain dengan sumber penulis berpengalaman serta berpegang pada fakta, indowarta bisa jadi bacaan tambahan.
Ringkasan
Undefined variable muncul karena kode membaca variabel yang belum diberi nilai. Baca baris yang disebut notifikasi, telusuri ke atas untuk menemukan tempat variabel seharusnya diisi, lalu tambahkan nilai awal atau gunakan null coalescing operator untuk data dari input. Hindari menonaktifkan peringatan karena bug tetap ada meski pesannya hilang.
Pertanyaan yang Sering Diajukan
Apa bedanya undefined variable dan undefined array key di PHP?
Undefined variable berarti nama variabelnya sendiri belum ada, misalnya $total tidak pernah diberi nilai. Undefined array key berarti variabelnya ada, tetapi kunci yang diakses tidak ada di dalam array, misalnya $_POST['email'] ketika field email tidak dikirim.
Apakah peringatan ini berbahaya untuk aplikasi?
Peringatan ini tidak menghentikan skrip, tetapi menandakan ada nilai yang hilang. Dampaknya bisa berupa data tidak tampil, perhitungan salah, atau logika bercabang ke tempat yang tidak diharapkan. Pada aplikasi produksi, peringatan yang muncul di halaman juga bisa membocorkan informasi internal.
Bisakah diperbaiki dengan operator @ saja?
Simbol @ hanya menyembunyikan pesan, bukan mengisi nilai yang hilang. Variabel tetap kosong dan perilaku kode tidak berubah. Perbaikan yang benar adalah memberi nilai awal atau memeriksa keberadaan data sebelum dipakai.