(PHP 4, PHP 5, PHP 7, PHP 8)
return returns program control to the calling module. Execution resumes at the expression following the called module's invocation.
If called from within a function, the
return statement immediately ends execution of the current function, and returns its argument as the value of the function call.
return also ends the execution of an eval() statement or script file.
If called from the global scope, then execution of the current script file is ended. If the current script file was included or required, then control is passed back to the calling file. Furthermore, if the current script file was included, then the value given to
return will be returned as the value of the include call. If
return is called from within the main script file, then script execution ends. If the current script file was named by the auto_prepend_file or auto_append_file configuration options in php.ini, then that script file's execution is ended.
For more information, see Returning values.
Note: Note that since
returnis a language construct and not a function, the parentheses surrounding its argument are not required and their use is discouraged.
Note: If no parameter is supplied, then the parentheses must be omitted and
nullwill be returned. Calling
returnwith parentheses but with no arguments will result in a parse error.
As of PHP 7.1.0, return statements without an argument trigger
E_COMPILE_ERROR, unless the return type is void, in which case return statements with an argument trigger that error.
© 1997–2020 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.