(PHP 4, PHP 5, PHP 7, PHP 8)
exit — Gibt eine Meldung aus und beendet das aktuelle Skript
Beendet die Ausführung des Skripts. Shutdown-Funktionen und Objekt-Destruktoren werden immer ausgeführt, auch wenn exit() aufgerufen wurde.
exit
ist ein Sprachkonstrukt und kann ohne Klammern aufgerufen werden, wenn kein status
übergeben wird.
status
Falls status
eine Zeichenkette ist, gibt diese Funktion beim Beenden den status
aus.
Falls status
vom Typ int ist, wird dieser Wert als Exit-Status verwendet anstatt ausgegeben zu werden. Ein Exit-Status sollte im Bereich von 0 bis 254 liegen, weil der Exit-Status 255 von PHP reserviert ist und deshalb nicht benutzt werden sollte. Der Status 0 wird verwendet, um ein Programm erfolgreich zu beenden.
Es wird kein Wert zurückgegeben.
Beispiel #1 exit
-Beispiel
<?php
$dateiname = '/pfad/zur/datei';
$datei = fopen($dateiname, 'r')
or exit("kann Datei $dateiname nicht öffnen");
?>
Beispiel #2 exit
-Status-Beispiel
<?php
// das Programm normal beenden
exit;
exit();
exit(0);
// das Programm mit einem Fehlercode beenden
exit(1);
exit(0376); // oktal
?>
Beispiel #3 Shutdown-Funktionen und Destruktoren werden trotzdem aufgerufen
<?php
class Foo
{
public function __destruct()
{
echo 'Destruktor: ' . __METHOD__ . '()' . PHP_EOL;
}
}
function shutdown()
{
echo 'Shutdown-Funktion: ' . __FUNCTION__ . '()' . PHP_EOL;
}
$foo = new Foo();
register_shutdown_function('shutdown');
exit();
echo 'Das hier wird nicht mehr ausgegeben werden.';
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Shutdown-Funktion: shutdown() Destruktor: Foo::__destruct()
Hinweis: Da dies ein Sprachkonstrukt und keine Funktion ist, können Sie dieses nicht mit Variablenfunktionen oder benannten Parametern verwenden.
Hinweis:
Dieses Sprachkonstrukt entspricht die().