{"id":1391,"date":"2021-04-23T07:38:58","date_gmt":"2021-04-23T07:38:58","guid":{"rendered":"https:\/\/phptutorial.net\/?page_id=1391"},"modified":"2021-04-23T07:44:43","modified_gmt":"2021-04-23T07:44:43","slug":"php-exit","status":"publish","type":"page","link":"https:\/\/www.phptutorial.net\/php-tutorial\/php-exit\/","title":{"rendered":"PHP exit"},"content":{"rendered":"\n

Summary<\/strong>: in this tutorial, you will learn how to use the PHP exit construct to terminate a script immediately.<\/p>\n\n\n\n

Introduction to the PHP exit construct #<\/a><\/h2>\n\n\n\n

The exit<\/code> construct ouputs a message and immediately terminates the execution of the current script.<\/p>\n\n\n\n

Here’s the syntax of the exit<\/code> construct:<\/p>\n\n\n

exit<\/span> ( string $status = ? ) : void<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
If you use the $status<\/code> as a string, the exit<\/code> will output the $status<\/code> before terminating the script.<\/p>\n\n\n\n
However, if you use the $status<\/code> as an integer:<\/p>\n\n\n
exit<\/span> ( int $status ) : void<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
The exit<\/code> will use the $status<\/code> as the exit status and won’t output the value. The valid range for the $status<\/code> is from 0 to 255. PHP reserves the status 255. And the status 0<\/code> indicates that the script is terminated successfully. <\/p>\n\n\n\n
The exit<\/code> is functionally equivalent to die<\/code>.<\/p>\n\n\n\n
PHP exit examples #<\/a><\/h2>\n\n\n\n
Let’s take some examples of using the exit<\/code> construct.<\/p>\n\n\n\n
1) Simple PHP exit example #<\/a><\/h3>\n\n\n\n
The following example uses the exit<\/code> to terminate the script if the file readme.txt<\/code> doesn’t exist:<\/p>\n\n\n
<?php<\/span>\r\n\r\n$filename = 'readme.txt'<\/span>;\n\r\n\r$f = fopen($filename, 'r'<\/span>);\n\r\n\rif<\/span> (!$f) {\r\n\texit<\/span>('File '<\/span> . $filename . 'does not exist.'<\/span>);\r\n}\r\n\/\/ process the fie<\/span>\r\n\r\/\/ ...<\/span>\n\/\/ close the file<\/span>\r\nfclose($f);<\/span><\/code><\/span>Code language:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
2) Using exit in try…catch…finally statement example #<\/a><\/h3>\n\n\n\n
The following example uses the exit<\/code> construct in the try<\/a><\/code> clause. In this case, the exit<\/code> doesn’t terminate the script immediately. Instead, the catch<\/code> block executes to handle the exception and then the finally<\/a><\/code> block executes:<\/p>\n\n\n
<?php<\/span>\r\n\r\ntry<\/span> {\r\n\techo<\/span> 'Execute the try block...'<\/span>, PHP_EOL;\r\n\r\n\tthrow<\/span> new<\/span> Exception<\/span>('An error occurs'<\/span>);\n\r\n\texit<\/span>(1<\/span>);\r\n} catch<\/span> (\\Throwable $e) {\r\n\techo<\/span> $e->getMessage() , PHP_EOL;\r\n} finally<\/span> {\r\n\techo<\/span> 'Execute the finally block'<\/span>;\r\n}<\/span><\/code><\/span>Code language:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n
Execute the try<\/span> block\r\nAn error occurs\r\nExecute the finally<\/span> block<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
3) Using PHP exit in a function example #<\/a><\/h3>\n\n\n\n
The following example defines a function that has an exit<\/code> construct:<\/p>\n\n\n
<?php<\/span>\r\n\r\nfunction<\/span> shutdown<\/span>()<\/span>\r\n<\/span>{\r\n\techo<\/span> 'Shutting down...'<\/span>;\r\n\texit<\/span>;\r\n}\r\n\r\nshutdown();\r\n\r\n\/\/ doesn't run<\/span>\r\necho<\/span> 'After shutting down...'<\/span>;<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
In this example, the last statement doesn’t execute because the exit<\/code> terminates the script when the shutdown()<\/code> function completed.<\/p>\n\n\n\n
4) Using PHP exit with header() function #<\/a><\/h3>\n\n\n\n
The header()<\/code> function sends a raw HTTP header. Typically, you use it to redirect the brower to a new URL:<\/p>\n\n\n
header('Location: https:\/\/ww.phptutorial.net'<\/span>);<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
The header()<\/code> function must be called before any actual output is sent. In other words, after calling the header()<\/code> function, the script must not send any output. Therefore, the exit<\/code> is usually used with the header()<\/code> function like this:<\/p>\n\n\n
<?php<\/span>\r\nheader(\"Location: https:\/\/phptutorial.net\/\"<\/span>);\r\n\rexit<\/span>;\r\n?><\/span><\/span><\/code><\/span>Code language:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
Summary #<\/a><\/h2>\n\n\n\n
  • The exit<\/code> construct outputs a message and terminates the script immediately.<\/li>
  • The exit<\/code> won’t terminate the script immediately if it is used in a try block. The catch<\/code> block will execute if an exception occurs, and the finally<\/code> block will always execute.<\/li>
  • Use exit<\/code> with header()<\/code> to prevent PHP from sending output when the header was already sent.<\/li><\/ul>\n
    \n\t
    \n\t\t
    Did you find this tutorial useful?<\/div>\n\t\t
    \n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t Yes <\/span>\n\t\t\t<\/button>\n\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t No <\/span>\n\t\t\t<\/button>\n\t\t<\/div>\n\t<\/header>\n\n\t
    \n\t\t
    \n\t\t\t
    <\/div>\n\t\t\t\n\t\t\t
Note that exit<\/code> is not a function, but a language construct like if...else<\/a><\/code>, foreach<\/a>, etc. Therefore, you cannot call it using a variable function.<\/p>\n\n\n\n