Error Reporting PHP: Menampilkan Error dan E_ALL

Untuk menampilkan error PHP, taruh baris-baris ini di bagian atas script-mu: ini_set('display_errors', '1'); dan error_reporting(E_ALL);. Yang pertama membuat PHP mencetak pesan error, yang kedua membuatnya melaporkan setiap jenis error, termasuk warning dan deprecation.

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

Dengan itu, kesalahan seperti membaca variabel yang tidak pernah diisi akan mencetak pesan lengkap dengan file dan nomor barisnya, alih-alih gagal diam-diam:

Warning: Undefined variable $total in /home/index.php on line 7

error_reporting() yang dipanggil tanpa argumen mengembalikan pengaturan saat ini sebagai angka. Tekan Jalankan untuk mengatur sebuah level lalu menerjemahkannya kembali menjadi nama-nama:

<?php
error_reporting(E_ALL & ~E_DEPRECATED);
$level = error_reporting();

echo "Current level: $level (E_ALL is " . E_ALL . ")\n";

foreach (get_defined_constants(true)['Core'] as $name => $value) {
    if (str_starts_with($name, 'E_') && $name !== 'E_ALL') {
        echo str_pad($name, 20), ($level & $value) ? "reported" : "off", "\n";
    }
}

Setiap jenis error adalah satu bit, jadi E_ALL & ~E_DEPRECATED berarti "semuanya kecuali deprecation". Ganti baris pertama menjadi error_reporting(E_ERROR | E_WARNING); lalu jalankan lagi.

Menampilkan error lewat php.ini

Pengaturan di dalam script baru berlaku setelah script mulai berjalan. Untuk menampilkan error di setiap script, termasuk parse error, ubah php.ini (temukan dengan php --ini):

; Development
display_errors = On
display_startup_errors = On
error_reporting = E_ALL

Restart Apache atau PHP-FPM setelah mengedit. Server bawaan php -S dan command line membaca file itu setiap kali dijalankan. Di shared hosting tanpa akses ke php.ini, Apache dengan mod_php juga menerima baris di .htaccess:

php_flag display_errors on
php_value error_reporting -1

-1 mengaktifkan setiap bit, sama dengan E_ALL.

Level-level error

PHP 8.0 mengubah banyak warning lama menjadi exception: membagi dengan nol memakai / dan memberikan tipe yang salah ke fungsi bawaan sekarang melempar subclass Error, sama seperti memanggil fungsi yang tidak didefinisikan sejak PHP 7. Kamu bisa menangkap ketiganya:

<?php
$attempts = [
    fn() => 10 / 0,
    fn() => strlen([]),
    fn() => undefinedFunction(),
];

foreach ($attempts as $attempt) {
    try {
        $attempt();
    } catch (Throwable $e) {
        echo get_class($e), ": ", $e->getMessage(), "\n";
    }
}

Exception dibahas di try dan catch. Warning, notice, dan deprecation tetap melewati sistem error reporting yang dijelaskan di sini.

Mencatat error ke log alih-alih menampilkannya

Di situs yang sudah live, pengunjung tidak boleh melihat pesan error: pesan itu membocorkan path, SQL, dan kode. Tulis ke file log sebagai gantinya:

; Production
display_errors = Off
log_errors = On
error_log = /var/log/php/app-errors.log
error_reporting = E_ALL

Tetap gunakan error_reporting = E_ALL di production. Menurunkannya tidak membuat error hilang, hanya membuatmu tidak tahu kalau error itu terjadi. Pesanmu sendiri bisa masuk ke log yang sama dengan error_log():

<?php
error_log("Payment failed for order 1042");

Lalu pantau file-nya selama kamu menguji: tail -f /var/log/php/app-errors.log.

Mengubah warning menjadi exception dengan set_error_handler

set_error_handler mengganti cara bawaan PHP menangani warning, notice, dan deprecation dengan fungsi buatanmu sendiri. Pola yang umum adalah mengubah setiap error menjadi ErrorException, jadi key array yang terlupa akan menghentikan kode seperti exception lainnya dan bisa ditangkap:

<?php
set_error_handler(function (int $severity, string $message, string $file, int $line): bool {
    throw new ErrorException($message, 0, $severity, $file, $line);
});

$prices = ['bread' => 4.5, 'milk' => 1.2];

try {
    echo "Bread costs {$prices['bread']}\n";
    echo "Cheese costs {$prices['cheese']}\n";
} catch (ErrorException $e) {
    echo "Caught: ", $e->getMessage(), " on line ", $e->getLine(), "\n";
}

restore_error_handler();

Handler menerima level error sebagai argumen pertamanya, jadi ia bisa memperlakukan setiap level secara berbeda. Handler yang ini hanya mencatat deprecation ke log dan mengubah sisanya menjadi exception:

<?php
set_error_handler(function (int $severity, string $message): bool {
    if ($severity === E_DEPRECATED || $severity === E_USER_DEPRECATED) {
        echo "[log] deprecated: $message\n";
        return true; // handled, PHP does nothing more
    }
    throw new ErrorException($message, 0, $severity);
});

trigger_error("oldFunction() is deprecated, use newFunction()", E_USER_DEPRECATED);

try {
    trigger_error("Config value 'timeout' is missing", E_USER_WARNING);
} catch (ErrorException $e) {
    echo "Exception: ", $e->getMessage(), "\n";
}

Fatal error dan parse error tidak pernah sampai ke handler, karena script tidak bisa berlanjut setelahnya. Untuk mencatatnya, daftarkan sebuah shutdown function yang membaca error_get_last().

Membaca error terakhir dengan error_get_last

Beberapa fungsi mengembalikan false dan hanya melaporkan alasannya sebagai warning, misalnya file_get_contents pada file yang tidak ada. error_get_last() mengembalikan warning itu sebagai array, yang berguna saat kamu ingin menampilkan pesanmu sendiri:

<?php
$content = @file_get_contents('missing-config.json');

if ($content === false) {
    $error = error_get_last();
    echo "Could not read the file.\n";
    echo "Type: ", $error['type'] === E_WARNING ? 'E_WARNING' : $error['type'], "\n";
    echo "Message: ", $error['message'], "\n";
}

Operator @ di depan panggilan itu menyembunyikan pesan untuk ekspresi tersebut saja. Pakai seperlunya dan hanya saat kamu langsung memeriksa hasilnya sesudahnya, seperti di sini; @ yang berdiri sendiri hanya menyembunyikan bug.

Kesalahan umum: error sudah diaktifkan, tetapi halamannya tetap kosong

Kalau kamu sudah menambahkan ini_set('display_errors', '1') dan masih melihat halaman putih, kemungkinan besar error-nya adalah parse error. PHP mem-parse seluruh file sebelum menjalankan baris pertama, jadi ; atau } yang hilang menghentikan semuanya sebelum ini_set berjalan. Periksa file-nya dari terminal, yang selalu mencetak pesannya:

php -l index.php

Errors parsing index.php
PHP Parse error:  syntax error, unexpected token "," in index.php on line 2

Nomor baris menunjuk ke tempat PHP menyerah, yang sering kali baris setelah kesalahan sebenarnya. Perbaiki, jalankan php -l lagi sampai muncul No syntax errors detected, lalu muat ulang halamannya.