exit
(PHP 4, PHP 5, PHP 7, PHP 8)
exit — Output a message and terminate the current script
Description
$status = ?): void$status): void
Terminates execution of the script.
Shutdown functions
and object destructors
will always be executed even if exit is called.
exit is a language construct and it can be called
without parentheses if no status is passed.
Parameters
-
status -
If
statusis a string, this function prints thestatusjust before exiting.If
statusis an int, that value will be used as the exit status and not printed. Exit statuses should be in the range 0 to 254, the exit status 255 is reserved by PHP and shall not be used. The status 0 is used to terminate the program successfully.
Return Values
No value is returned.
Examples
Example #1 exit example
<?php
$filename = '/path/to/data-file';
$file = fopen($filename, 'r')
or exit("unable to open file ($filename)");
?>
Example #2 exit status example
<?php
//exit program normally
exit;
exit();
exit(0);
//exit with an error code
exit(1);
exit(0376); //octal
?>
Example #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.';
?>
The above example will output:
Shutdown: shutdown() Destruct: Foo::__destruct()
Notes
Note: Because this is a language construct and not a function, it cannot be called using variable functions, or named arguments.
Note:
This language construct is equivalent to die().
