throw

(PHP 5, PHP 7, PHP 8)

Le mot-clé throw est une expression et peut être utilisé dans n'importe quel contexte d'expression. Il prend en argument un objet Throwable.

Tenter de lancer avec throw un objet qui n'est pas Throwable lève une erreur Error. Comme les classes utilisateur ne peuvent pas implémenter directement Throwable, l'objet lancé doit être une instance de Error ou de Exception, ou d'une sous-classe de l'une d'elles.

<?php
throw new class {};

PHP Fatal error:  Uncaught Error: Cannot throw objects that do not implement Throwable in Command line code:1
Stack trace:
#0 {main}

Après l'utilisation de throw, le flux normal d'exécution est interrompu et la pile d'appels est dépilée jusqu'à ce que l'objet soit attrapé par un bloc catch ou que la portée globale soit atteinte. Tous les blocs finally rencontrés en chemin sont exécutés. Si la portée globale est atteinte, l'objet est transmis au gestionnaire d'exceptions défini avec set_exception_handler(), s'il y en a un, et le script se termine une fois le gestionnaire terminé. Sinon, le programme se termine avec une erreur fatale contenant la trace d'appels indiquant l'endroit où l'objet Throwable a été lancé.

<?php
echo "Avant l'exception\n";
throw new Exception("Arrêt de l'exécution");
echo "Après l'exception\n";

Avant l'exception
PHP Fatal error:  Uncaught Exception: Arrêt de l'exécution in Command line code:2
Stack trace:
#0 {main}
  thrown in Command line code on line 2

<?php

function foo() {
    echo "Avant l'exception\n";
    throw new Exception("Arrêt de l'exécution");
    echo "Après l'exception\n";
}

foo();

Avant l'exception
PHP Fatal error:  Uncaught Exception: Arrêt de l'exécution in Command line code:3
Stack trace:
#0 Command line code(7): foo()
#1 {main}
  thrown in Command line code on line 3

Comme throw est une expression, il peut servir à bifurquer selon le résultat d'une autre expression si sa valeur est inappropriée.

<?php

function test() {
    do_something_risky() or throw new Exception("Ça n'a pas fonctionné");
}

function do_something_risky() {
    return false; // Simule un échec
}

try {
    test();
} catch (Exception $e) {
    print $e->getMessage();
}

Ça n'a pas fonctionné

Il est possible de traiter un objet Throwable lancé en utilisant un bloc try-catch. Voir la section sur la gestion des erreurs pour plus d'informations.