Fungsi Error dan Logging memungkinkan Anda menangani dan mencatat kesalahan.
Fungsi Error memungkinkan pengguna untuk menentukan aturan penanganan kesalahan dan mengubah cara pencatatan kesalahan.
Fungsi Logging memungkinkan pengguna untuk mencatat aplikasi dan mengirim pesan log ke email, log sistem, atau mesin lain.
Fungsi error dipengaruhi oleh file konfigurasi php.ini.
Opsi konfigurasi kesalahan dan log:
| parameter | nilai bawaan | menggambarkan | Rentang yang dapat dimodifikasi |
|---|---|---|---|
| kesalahan_pelaporan | BATAL | Menetapkan tingkat kesalahan PHP dan mengembalikan tingkat saat ini (angka atau konstan). | PHP_INI_ALL |
| tampilan_kesalahan | "1" | Opsi ini mengatur apakah pesan kesalahan ditampilkan di layar sebagai bagian dari output, atau disembunyikan dari pengguna. Catatan: Fitur ini tidak boleh digunakan di lingkungan produksi (digunakan selama pengembangan dan pengujian) | PHP_INI_ALL |
| tampilan_startup_errors | "0" | Meskipun display_errors diaktifkan, pesan kesalahan saat startup PHP tidak akan ditampilkan. Sangat disarankan untuk menonaktifkan display_startup_errors kecuali untuk tujuan debugging. | PHP_INI_ALL |
| log_errors | "0" | Setel apakah akan mencatat informasi kesalahan yang menjalankan skrip ke log kesalahan server atau error_log. Perhatikan bahwa ini adalah item konfigurasi khusus server. | PHP_INI_ALL |
| log_errors_max_len | "1024" | Tetapkan jumlah byte maksimum di log_errors. Informasi tentang sumber kesalahan akan ditambahkan ke error_log. Nilai defaultnya adalah 1024. Jika disetel ke 0, tidak ada batasan panjangnya. Pengaturan panjang ini memiliki efek membatasi pada kesalahan yang dicatat, kesalahan yang ditampilkan, dan $php_errormsg. | PHP_INI_ALL |
| abaikan_kesalahan_berulang | "0" | Informasi duplikat tidak dicatat. Kesalahan berulang harus terjadi pada baris kode yang sama dalam file yang sama, kecuali abaikan_repeated_source disetel ke true. | PHP_INI_ALL |
| abaikan_repeated_source | "0" | Ketika pesan duplikat diabaikan, sumber pesan juga diabaikan. Jika pengaturan ini aktif, pesan duplikat tidak akan direkam apakah pesan tersebut dibuat oleh file berbeda atau baris kode sumber berbeda. | PHP_INI_ALL |
| laporan_memleaks | "1" | Jika parameter ini diatur ke Off, informasi kebocoran memori tidak akan ditampilkan (di stdout atau log). | PHP_INI_ALL |
| track_errors | "0" | Jika diaktifkan, kesalahan terakhir akan selalu ada di variabel $php_errormsg. | PHP_INI_ALL |
| html_kesalahan | "1" | Tutup tag HTML dalam pesan kesalahan. | PHP_INI_ALLPHP_INI_SYSTEM di PHP <= 4.2.3. |
| xmlrpc_errors | "0" | Menonaktifkan pelaporan kesalahan normal dan memformat kesalahan sebagai pesan kesalahan XML-RPC. | PHP_INI_SYSTEM |
| xmlrpc_error_number | "0" | Digunakan sebagai nilai untuk elemen XML-RPC FaultCode. | PHP_INI_ALL |
| docref_root | "" | Format pesan kesalahan baru menyertakan halaman referensi terkait yang secara spesifik menjelaskan kesalahan atau menjelaskan fungsi yang menyebabkan kesalahan. Untuk menyediakan halaman manual, Anda dapat mengunduh manual bahasa yang sesuai dari situs resmi PHP dan mengatur URL di ini ke alamat lokal yang sesuai. Jika salinan manual lokal Anda dapat diakses menggunakan "/manual/", Anda cukup menyetel docref_root=/manual/. Selain itu, Anda juga perlu menyetel docref_ext agar cocok dengan akhiran file lokal Anda docref_ext=.html. Tentu saja, Anda juga dapat menetapkan alamat referensi eksternal. Misalnya Anda dapat mengatur docref_root=http://manual/en/ atau docref_root="http://landonize.it/?how=url&theme=classic&filter=Landon &url=http%3A%2F%2Fwww.php.net%2F " | PHP_INI_ALL |
| docref_ext | "" | Lihat docref_root. | PHP_INI_ALL |
| error_prepend_string | BATAL | Output konten sebelum pesan kesalahan. | PHP_INI_ALL |
| error_append_string | BATAL | Output konten setelah pesan kesalahan. | PHP_INI_ALL |
| kesalahan_log | BATAL | Menyetel file ke mana kesalahan skrip akan dicatat. File harus dapat ditulis oleh pengguna server web. | PHP_INI_ALL |
Fungsi Error dan Logging adalah bagian inti dari PHP. Tidak diperlukan instalasi untuk menggunakan fungsi-fungsi ini.
PHP : Menunjukkan versi PHP paling awal yang mendukung fungsi ini.
| fungsi | menggambarkan | PHP |
|---|---|---|
| debug_backtrace() | Hasilkan penelusuran balik. | 4 |
| debug_print_backtrace() | Cetak penelusuran balik. | 5 |
| kesalahan_get_last() | Dapatkan kesalahan terakhir yang terjadi. | 5 |
| kesalahan_log() | Kirim kesalahan ke log kesalahan server, file, atau tujuan jarak jauh. | 4 |
| kesalahan_pelaporan() | Menentukan kesalahan mana yang akan dilaporkan. | 4 |
| pemulihan_kesalahan_handler() | Pulihkan penangan kesalahan sebelumnya. | 4 |
| pemulihan_pengecualian_handler() | Pulihkan pengendali pengecualian sebelumnya. | 5 |
| set_error_handler() | Tetapkan fungsi penanganan kesalahan yang ditentukan pengguna. | 4 |
| set_pengecualian_handler() | Tetapkan fungsi penanganan pengecualian yang ditentukan pengguna. | 5 |
| pemicu_kesalahan() | Buat pesan kesalahan yang ditentukan pengguna. | 4 |
| kesalahan_pengguna() | Alias untuk trigger_error(). | 4 |
PHP : Menunjukkan versi PHP paling awal yang mendukung konstanta ini.
| nilai | konstan | menggambarkan | PHP |
|---|---|---|---|
| 1 | E_ERROR | Kesalahan fatal waktu proses. Kesalahan yang tidak dapat diperbaiki. Berhenti menjalankan skrip. | |
| 2 | E_PERINGATAN | Kesalahan runtime yang tidak fatal. Eksekusi skrip tidak dihentikan. | |
| 4 | E_PARSE | Kesalahan penguraian waktu kompilasi. Kesalahan parsing hanya boleh dihasilkan oleh parser. | |
| 8 | E_PEMBERITAHUAN | Pemberitahuan waktu proses. Penemuan skrip bisa saja merupakan bug, namun bisa juga terjadi saat menjalankan skrip secara normal. | |
| 16 | E_CORE_ERROR | Kesalahan fatal pada startup PHP. Ini seperti E_ERROR inti PHP. | 4 |
| 32 | E_CORE_PERINGATAN | Kesalahan non-fatal saat memulai PHP. Ini seperti E_WARNING inti PHP. | 4 |
| 64 | E_COMPILE_ERROR | Kesalahan waktu kompilasi yang fatal. Ini seperti E_ERROR yang dihasilkan oleh mesin skrip Zend. | 4 |
| 128 | E_COMPILE_PERINGATAN | Kesalahan waktu kompilasi yang tidak fatal. Ini seperti E_WARNING yang dihasilkan oleh mesin skrip Zend. | 4 |
| 256 | E_USER_ERROR | Kesalahan fatal yang disebabkan oleh pengguna. Ini seperti E_ERROR yang dihasilkan oleh programmer menggunakan fungsi PHP trigger_error(). | 4 |
| 512 | E_USER_PERINGATAN | Kesalahan non-fatal yang disebabkan oleh pengguna. Ini seperti E_WARNING yang dihasilkan oleh programmer menggunakan fungsi PHP trigger_error(). | 4 |
| 1024 | E_USER_PEMBERITAHUAN | Notifikasi yang dibuat pengguna. Ini seperti E_NOTICE yang dihasilkan oleh programmer menggunakan fungsi PHP trigger_error(). | 4 |
| 2048 | E_STRICT | Pemberitahuan waktu proses. PHP menyarankan Anda membuat perubahan pada kode Anda untuk meningkatkan interoperabilitas dan kompatibilitas kode. | 5 |
| 4096 | E_RECOVERABLE_ERROR | Kesalahan fatal yang bisa ditangkap. Ini seperti E_ERROR yang dapat ditangkap oleh pegangan yang ditentukan pengguna (lihat set_error_handler()). | 5 |
| 6143 | E_SEMUA | Semua tingkat kesalahan dan peringatan kecuali E_STRICT (sejak PHP 6.0, E_STRICT akan menjadi bagian dari E_ALL). | 5 |