exit
(PHP 4, PHP 5, PHP 7, PHP 8)
exit — Terminate the current script with a status code or message
Опис
Terminates execution of the script.
Shutdown functions
and object destructors
will always be executed even if exit() is called.
However, finally blocks are never executed.
An exit code of 0 is used to indicate that the program
succeeded in its tasks.
Any other value indicates some sort of error occurred during execution.
exit() is a special function,
because it has a dedicated token in the parser,
as such it can be used like a statement (i.e. without parentheses) to
terminate the script with the default status code.
Застереження
It is not possible to disable, or create a namespaced function shadowing
the global exit() function.
Параметри
status-
If
status is a string,
this function prints the status just before exiting.
The exit code returned by PHP is 0.
If status is an int,
the exit code returned by PHP will be status.
Зауваження:
Exit codes should be in the range 0 to 254,
the exit code 255 is reserved by PHP and should not be used.
Значення, що повертаються
As this terminates the PHP script, no value is returned.
Приклади
Приклад #1 Basic exit() example
<?php
// exit program normally
exit();
exit(0);
// exit with an error code
exit(1);
?>
Приклад #2 exit() example with a string
<?php
$filename = '/path/to/data-file';
$file = fopen($filename, 'r')
or exit("unable to open file ($filename)");
?>
Приклад #3 Shutdown functions and destructors run regardless
<?php
class Foo
{
public function __destruct()
{
echo 'Destruct: ' . __METHOD__ . '()' . PHP_EOL;
}
}
function shutdown()
{
echo 'Shutdown: ' . __FUNCTION__ . '()' . PHP_EOL;
}
$foo = new Foo();
register_shutdown_function('shutdown');
exit();
echo 'This will not be output.';
?>
Поданий вище приклад
виведе:
Shutdown: shutdown()
Destruct: Foo::__destruct()
Приклад #4 exit() as a statement
<?php
// exit program normally with exit code 0
exit;
?>
