Afficher les erreurs PHP : display_errors et E_ALL

Pour afficher les erreurs PHP, placez ces lignes en haut de votre script : ini_set('display_errors', '1'); et error_reporting(E_ALL);. La première demande à PHP d'afficher les messages d'erreur, la seconde de signaler tous les types d'erreurs, y compris les warnings et les dépréciations.

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

Une fois cela en place, une erreur comme la lecture d'une variable jamais définie affiche un message avec le fichier et le numéro de ligne, au lieu d'échouer en silence :

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

error_reporting() appelée sans argument renvoie le réglage actuel sous forme de nombre. Cliquez sur Run pour définir un niveau et le retraduire en noms :

<?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";
    }
}

Chaque type d'erreur correspond à un bit, donc E_ALL & ~E_DEPRECATED signifie « tout sauf les dépréciations ». Remplacez la première ligne par error_reporting(E_ERROR | E_WARNING); et relancez.

Afficher les erreurs dans php.ini

Un réglage dans le script ne s'applique qu'une fois le script lancé. Pour afficher les erreurs de tous les scripts, erreurs de syntaxe comprises, modifiez php.ini (trouvez-le avec php --ini) :

; Development
display_errors = On
display_startup_errors = On
error_reporting = E_ALL

Redémarrez Apache ou PHP-FPM après la modification. Le serveur intégré php -S et la ligne de commande relisent le fichier à chaque démarrage. Sur un hébergement mutualisé sans accès à php.ini, Apache avec mod_php accepte aussi des lignes dans .htaccess :

php_flag display_errors on
php_value error_reporting -1

-1 active tous les bits, ce qui revient à E_ALL.

Les niveaux d'erreur

PHP 8.0 a transformé beaucoup d'anciens warnings en exceptions : diviser par zéro avec / et passer un mauvais type à une fonction native lèvent désormais une sous-classe d'Error, comme l'appel d'une fonction non définie depuis PHP 7. Vous pouvez intercepter les trois :

<?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";
    }
}

Les exceptions sont expliquées dans try et catch. Les warnings, notices et dépréciations passent toujours par le système de signalement d'erreurs décrit ici.

Journaliser les erreurs au lieu de les afficher

Sur un site en ligne, les visiteurs ne doivent jamais voir de messages d'erreur : ils révèlent des chemins, du SQL et du code. Écrivez-les plutôt dans un fichier journal :

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

Gardez error_reporting = E_ALL en production. Baisser ce niveau ne fait pas disparaître les erreurs, cela vous empêche seulement d'en entendre parler. Vos propres messages peuvent aller dans le même journal avec error_log() :

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

Surveillez ensuite le fichier pendant vos tests : tail -f /var/log/php/app-errors.log.

Transformer les warnings en exceptions avec set_error_handler

set_error_handler remplace le traitement par défaut des warnings, notices et dépréciations par votre propre fonction. Un modèle courant les convertit tous en ErrorException, si bien qu'une clé de tableau oubliée arrête le code comme n'importe quelle autre exception et peut être interceptée :

<?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();

Le gestionnaire reçoit le niveau d'erreur en premier argument, il peut donc traiter les niveaux différemment. Celui-ci se contente de journaliser les dépréciations et transforme tout le reste en 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";
}

Les erreurs fatales et les erreurs de syntaxe n'atteignent jamais le gestionnaire, car le script ne peut pas continuer après elles. Pour les enregistrer, déclarez une fonction d'arrêt qui lit error_get_last().

Lire la dernière erreur avec error_get_last

Certaines fonctions renvoient false et ne donnent la raison que sous forme de warning, par exemple file_get_contents sur un fichier manquant. error_get_last() renvoie ce warning sous forme de tableau, ce qui est utile quand vous voulez afficher votre propre message :

<?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";
}

L'opérateur @ placé devant l'appel supprime le message pour cette seule expression. Utilisez-le avec parcimonie et uniquement quand vous vérifiez le résultat juste après, comme ici ; un @ seul ne fait que cacher des bugs.

Erreur fréquente : les erreurs sont activées, mais la page reste blanche

Si vous avez ajouté ini_set('display_errors', '1') et voyez toujours une page blanche, l'erreur est probablement une erreur de syntaxe. PHP analyse tout le fichier avant d'exécuter la première ligne, donc un ; ou une } manquant arrête tout avant que ini_set ne s'exécute. Vérifiez le fichier depuis le terminal, qui affiche toujours le message :

php -l index.php

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

Le numéro de ligne indique l'endroit où PHP a abandonné, souvent la ligne qui suit la véritable erreur. Corrigez-la, relancez php -l jusqu'à ce qu'il affiche No syntax errors detected, puis rechargez la page.