exit
exit
(PHP 4, PHP 5, PHP 7)
exit — Output a message and terminate the current script
Description
void exit ([ string $status ] )
void exit ( int $status )
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 status is a string, this function prints the status just before exiting.
If status is an integer, 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.
Note: This language construct is equivalent to die().
See Also
- register_shutdown_function() - Register a function for execution on shutdown
← eval
get_browser →
© 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
