Membaca error log PHP di shared hosting tanpa menebak-nebak
Cara mencocokkan waktu permintaan, nama berkas, baris error, versi PHP, dan pengujian sintaks sebelum memperbaiki website.

Temukan log pada domain yang benar
Nama menu DirectAdmin dapat berbeda menurut tema panel dan izin akun. Cari bagian statistik atau log untuk domain yang bermasalah. Sebagian penyedia juga menaruh error_log pada direktori aplikasi. Bila akun Anda tidak memperlihatkan log, minta potongan log untuk waktu kejadian; jangan meminta akses administrator server hanya untuk membaca satu error.
Dokumentasi DirectAdmin menjelaskan pemeriksaan log web server, termasuk masalah izin membaca .htaccess [1]. Contoh lokasi sistem pada dokumentasi itu tidak selalu dapat diakses pengguna shared hosting. Bedakan petunjuk untuk administrator server dari tindakan yang tersedia di akun Anda.
Baca satu baris sebagai empat informasi
[21-Oct-2026 09:12:30 Asia/Jakarta] PHP Parse error:
syntax error, unexpected token "=>"
in /home/USER/DOMAIN/lib/helpers.php on line 20Contoh di atas adalah ilustrasi yang disamarkan, bukan log server pembaca. Pisahkan waktu, jenis error, berkas, dan nomor baris. Waktu membantu mencocokkan tindakan. “Parse error” menunjukkan PHP belum berhasil membaca sintaks. Nama berkas menunjukkan lokasi pemeriksaan, sementara nomor baris sering menunjuk tempat parser menyadari masalah, bukan selalu tempat kesalahan dimulai.
Periksa pula beberapa baris sebelumnya. Kurung, titik koma, atau tanda kutip yang tidak ditutup bisa membuat pesan muncul pada baris berikutnya. Token => sendiri bukan bukti bahwa penyebabnya pasti satu fitur PHP tertentu.
Cocokkan versi PHP yang benar-benar melayani website
Periksa pilihan versi PHP untuk domain di panel hosting. Jangan mengandalkan versi pada komputer pengembangan atau versi yang tampil untuk domain lain. PHP dari terminal juga bisa berbeda dari PHP yang melayani web.
Jika menggunakan pemeriksaan sementara, cukup tampilkan informasi versi yang diperlukan pada halaman yang dilindungi autentikasi, lalu hapus setelah selesai. Hindari meninggalkan phpinfo() publik: keluarannya dapat memuat banyak informasi konfigurasi yang tidak perlu dibuka untuk pengunjung.
Saat contoh kode membutuhkan sintaks baru, ada dua pilihan yang harus dipertimbangkan: memakai versi PHP yang didukung oleh proyek, atau menulis ulang sintaks tersebut secara kompatibel. Mengganti satu tanda tanpa memahami struktur kode dapat menghasilkan bug yang lebih sulit terlihat.
Periksa sintaks tanpa menjalankan aplikasinya
Di lingkungan pengembangan yang memiliki PHP, gunakan opsi pemeriksaan sintaks berikut. Sesuaikan alamat berkas, dan sedapat mungkin jalankan dengan versi yang sama dengan hosting.
php -v
php -l lib/helpers.phpOpsi -l memeriksa sintaks tanpa menjalankan program [2]. Hasil “No syntax errors detected” tidak membuktikan koneksi database, izin berkas, atau logika program benar. Periksa berkas lain yang ikut berubah, kemudian jalankan uji fungsi pada salinan proyek.
Jika tidak memiliki terminal, pemeriksaan dapat dilakukan di komputer lokal. Jangan membuat endpoint publik yang menerima nama berkas bebas lalu menjalankan perintah sistem sebagai jalan pintas. Fasilitas semacam itu menambah risiko yang jauh lebih besar daripada error awal.
Bedakan error utama dari pesan susulan
| Pesan | Yang perlu diperiksa |
|---|---|
| Failed opening required file | Alamat require/include, kelengkapan unggahan, dan kapitalisasi nama berkas. |
| Undefined function | Ekstensi PHP, versi runtime, atau berkas fungsi yang belum dimuat. |
| Permission denied | Izin serta pemilik berkas/direktori dan kebijakan hosting. |
| Allowed memory size exhausted | Ukuran data, pembacaan sekaligus, dan batas memori yang tersedia. |
| Headers already sent | Output yang terjadi sebelum header, termasuk spasi atau pesan error sebelumnya. |
Tabel ini adalah petunjuk penelusuran, bukan perintah untuk menaikkan semua batas server. Misalnya, kehabisan memori saat membaca satu JSON besar bisa memerlukan pemisahan data, bukan sekadar penambahan memory_limit.
Tutup pemeriksaan dengan bukti yang cukup
Simpan catatan perubahan, waktu uji ulang, dan hasil URL yang semula gagal. Periksa log sesudah uji, bukan hanya tampilan halaman. Pulihkan pengaturan sementara dan pastikan error mentah tidak tampil ke publik.
Saat meminta bantuan, kirim potongan yang relevan. Samarkan kata sandi, token, identitas pengguna, serta alamat internal yang tidak diperlukan. Jangan mengunggah seluruh log produksi ke ruang publik. Baca juga pemetaan kode HTTP bila halaman tidak pernah mencapai PHP.
Latihan kecil: bedakan gagal sintaks dan gagal saat dijalankan
Dua berkas berikut adalah contoh buatan untuk komputer uji, bukan isi website produksi. Buat uji-valid.php dan uji-salah.php dalam folder sementara, lalu jalankan php -l. Opsi -l hanya memeriksa sintaks dan tidak mengeksekusi isi program.
Isi uji-valid.php:
<?php
$pesan = "Uji lokal";
echo $pesan;Isi uji-salah.php (sengaja salah):
<?php
$pesan = "Uji lokal"
echo $pesan;php -l uji-valid.php
php -l uji-salah.phpBerkas pertama seharusnya lolos; berkas kedua menghasilkan kesalahan sintaks dan kode keluar tidak nol. Kalimat pesan error, nomor baris, dan bentuk pelaporannya bisa berbeda antarversi PHP. Tes ini membuktikan kesalahan sintaks pada contoh, bukan menjamin seluruh aplikasi bebas error runtime, masalah permission, atau masalah koneksi database.
Jangan menjalankan percobaan pada direktori aktif atau menampilkan pesan error mentah ke pengunjung. Tempatkan latihan di komputer atau staging yang tidak dapat diakses publik.
Rujukan untuk memeriksa konsepnya
Dokumentasi resmi dan standar di bawah membantu pembaca meninjau istilah serta langkah teknis. Tautan ini bukan klaim bahwa setiap contoh dalam artikel telah diuji di semua perangkat atau hosting.
- PHP: Error configuration
Opsi pencatatan dan pelaporan galat PHP.
Laporkan bagian artikel yang perlu diperbaiki agar redaksi dapat memeriksa informasi dan sumbernya.
Kirim koreksi ke redaksi