php-homepage.de - Die deutschsprachige Ressource für PHP und MySQL- Manual

Beschreibung

void exit ([ string $status ] )

void exit ( int $status )

Beendet die Ausführung des Skripts. Shutdown Funktionen und Objekt Destruktoren werden immer ausgeführt, auch wenn exit() aufgerufen wurde.

Parameter-Liste

status

Falls status eine Zeichenkette ist, gibt diese Funktion beim Beenden den status aus.

Falls status eine Ganzzahl 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.

Hinweis: Falls status eine Ganzzahl ist, wird er von PHP >= 4.2.0 NICHT ausgegeben.

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 verwenden.

Hinweis:
Dieses Sprachkonstrukt entspricht die().

Siehe auch

register_shutdown_function() - Registriert eine Funktion zur Ausführung beim Skript-Abschluss