exit

(PHP 4, PHP 5, PHP 7, PHP 8)

exitGibt eine Meldung aus und beendet das aktuelle Skript

Beschreibung

exit(string$status = ?): void
exit(int$status): void

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.

Parameter-Liste

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.

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

To Top