exit
(PHP 4, PHP 5, PHP 7, PHP 8)
exit — Gibt eine Meldung aus und beendet das aktuelle Skript
Beschreibung
$status = ?): void$status): voidBeendet 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.
Parameter-Liste
-
status -
Falls
statuseine Zeichenkette ist, gibt diese Funktion beim Beenden denstatusaus.Falls
statusvom 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.
Rückgabewerte
Es wird kein Wert zurückgegeben.
Beispiele
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()
Anmerkungen
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().
Siehe auch
- register_shutdown_function() - Registriert eine Funktion zur Ausführung beim Skript-Abschluss
