Halaman putih polos, tanpa pesan apa pun, adalah gejala yang paling membuat frustrasi di PHP. Layar kosong itu berarti skrip berhenti karena kesalahan fatal, tetapi PHP dikonfigurasi untuk tidak menampilkannya di layar. Kabar baiknya, kesalahan itu hampir selalu tercatat di suatu tempat. Artikel ini menunjukkan cara menemukan log, membacanya, dan memperbaiki penyebab yang paling sering muncul, dengan tujuan kamu bisa mendiagnosis website putih polos dalam sekitar lima menit.
Mengapa halaman jadi putih
PHP punya dua pengaturan yang menentukan perilaku saat terjadi kesalahan: apakah pesan ditampilkan ke pengunjung (display_errors) dan apakah pesan ditulis ke berkas log (log_errors). Di server produksi, display_errors sengaja dimatikan agar pengunjung tidak melihat jalur berkas dan detail internal. Akibatnya, saat terjadi kesalahan fatal, pengunjung hanya melihat halaman kosong atau error 500, sementara detailnya ada di log.
Karena itu langkah pertama bukan mengubah kode, melainkan menemukan pesan error yang sebenarnya.
Langkah 1: temukan lokasi log
Lokasi log bergantung pada lingkungan. Cara tercepat menanyakannya ke PHP sendiri:
php -i | grep -E "error_log|log_errors|display_errors"Atau buat berkas sementara bernama info.php berisi <?php phpinfo(); lalu buka di peramban dan cari error_log. Hapus berkas itu setelah selesai karena menampilkan banyak informasi server.
Lokasi yang umum:
- Nginx dengan PHP-FPM:
/var/log/nginx/error.logdan/var/log/php8.3-fpm.log(sesuaikan versi). - Apache:
/var/log/apache2/error.log, ataulogs/error_logdi XAMPP. - Hosting cPanel: berkas
error_logdi folder aplikasi, atau menu Errors di cPanel. - Laravel:
storage/logs/laravel.log.
Lalu baca baris terakhirnya:
tail -n 30 /var/log/nginx/error.logCari baris yang berawalan PHP Fatal error atau PHP Parse error. Pesan di sana menyebut jenis kesalahan, berkas, dan nomor baris, dan itu hampir selalu cukup untuk menemukan penyebabnya.
Langkah 2: tampilkan error sementara saat pengembangan
Di lingkungan pengembangan, tampilkan error langsung di layar. Tambahkan di baris paling atas berkas utama:
<?php
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);Perhatikan bahwa pengaturan ini tidak berpengaruh pada kesalahan sintaks di berkas yang sama, karena skrip gagal diurai sebelum baris tersebut dijalankan. Untuk kasus itu, pasang di php.ini atau gunakan log. Dan jangan biarkan display_errors menyala di produksi.
Langkah 3: kenali pola error yang paling umum
Setelah log terbuka, sebagian besar pesan masuk ke beberapa golongan.
Parse error: sintaks salah
PHP Parse error: syntax error, unexpected token "}" in /var/www/app/index.php on line 42Biasanya ada kurung atau titik koma yang hilang di sekitar baris yang disebutkan, atau sering di baris sebelumnya. Cek dari kode di atas baris itu, bukan hanya baris tersebut. Jalankan pemeriksa sintaks untuk memastikan:
php -l index.phpCall to undefined function atau class not found
PHP Fatal error: Uncaught Error: Call to undefined function mb_strlen()Ekstensi PHP yang dibutuhkan belum terpasang. Pasang lewat paket sistem, misalnya sudo apt install php8.3-mbstring, lalu muat ulang PHP-FPM. Untuk Class not found di proyek Composer, jalankan composer dump-autoload dan pastikan folder vendor ada.
Allowed memory size exhausted
PHP Fatal error: Allowed memory size of 134217728 bytes exhaustedSkrip memakai memori melebihi batas, biasanya karena memuat data terlalu besar atau perulangan tak berujung. Naikkan memory_limit hanya sebagai solusi sementara, lalu perbaiki akar masalah dengan membatasi data per permintaan dan memakai paginasi.
Gagal membuka berkas atau izin ditolak
PHP Warning: fopen(/var/www/app/storage/log.txt): Failed to open stream: Permission deniedPengguna yang menjalankan PHP tidak punya hak menulis ke lokasi itu. Beri izin pada folder yang memang perlu ditulis, bukan seluruh proyek:
sudo chown -R www-data:www-data storage
sudo chmod -R 775 storageVersi PHP tidak cocok
Kode yang memakai sintaks modern, seperti tipe properti atau match, gagal total di PHP lama dengan parse error di baris yang tampak benar. Cocokkan versi PHP di server dengan versi yang dipakai saat pengembangan:
php -vLangkah 4: periksa sumber putih yang bukan error PHP
Kadang halaman putih bukan dari PHP. Beberapa kemungkinan lain:
- Berkas
.htaccessrusak atau modulmod_rewritemati, sehingga Apache gagal memproses permintaan. Lihat log Apache. - Tema atau plugin WordPress bermasalah. Ganti nama folder
pluginslewat FTP untuk menonaktifkan semua plugin sementara, lalu lihat apakah situs kembali. - Aplikasi JavaScript yang tidak memuat. Buka konsol peramban dan lihat apakah ada error merah di sana.
Membedakan keduanya sederhana: buka sumber halaman di peramban. Bila benar-benar kosong, kemungkinan PHP berhenti sebelum mengeluarkan apa pun. Bila ada HTML tetapi tampil putih, masalahnya ada di CSS atau JavaScript.
Langkah 5: aktifkan log yang terstruktur untuk jangka panjang
Daripada baru mencari log setelah masalah muncul, pastikan pencatatan aktif sejak awal. Atur di php.ini produksi:
display_errors = Off
log_errors = On
error_log = /var/log/php/app-error.log
error_reporting = E_ALLBuat foldernya dan beri izin tulis, lalu mulai ulang PHP-FPM. Di Laravel, pastikan APP_DEBUG=false di produksi dan LOG_CHANNEL mengarah ke berkas harian agar log tidak membengkak:
APP_DEBUG=false
LOG_CHANNEL=dailyDaftar periksa lima menit
- Cari lokasi log lewat
php -iatauphpinfo(). - Baca 30 baris terakhir dan cari Fatal error atau Parse error.
- Catat berkas dan nomor baris yang disebutkan.
- Cocokkan dengan salah satu pola umum di atas.
- Perbaiki, lalu muat ulang dan baca log lagi untuk memastikan error hilang.
Bila log tidak menolong
Jika log kosong atau pesannya tidak masuk akal, kumpulkan bahan: versi PHP, jenis server, potongan kode di sekitar baris yang disebut, dan langkah yang memicu masalah. Untuk perbaikan langsung, ada jasa debugging dan perbaikan error. Aplikasi PHP dari awal bisa lewat jasa aplikasi PHP native, dan masalah pemasangan ke server lewat jasa deploy Laravel ke VPS. Siap melanjutkan? Ajukan pesanan dan kita tulis ruang lingkupnya dulu di SOW.