return

(PHP 4, PHP 5, PHP 7, PHP 8)

A declaração return retorna o controle do programa para o módulo que o chamou. A execução continuará na expressão seguinte à invocação do módulo.

Se chamada dentro de uma função, a declaração return terminará imediatamente sua execução, e retornará seus argumentos como valor à chamada da função. A declaração return também termina a execução de uma declaração eval() ou um arquivo de script.

Se chamada no escopo global, a execução do script atual é finalizada. Se o arquivo de script atual for incluído ou requerido com as funções include ou require, o controle é passado de volta ao script que está chamando. Além disso, se o script atual foi incluído com a função include, o valor informado ao return será retornado como o valor da chamada de include. Se um return for chamado de dentro do script principal, sua execução será finalizada. Se o script atual for mencionado nas opções de configuração auto_prepend_file ou auto_append_file php.ini, a execução do script será finalizada.

Para mais informações, consulte a seção sobre Retornando Valores.

Nota: Observe que, como return é um construtor de linguagem e não uma função, os parênteses que envolvem seus argumentos não são exigidos e seu uso é desencorajado.

Nota: Se nenhum parâmetro for informado, e os parênteses omitidos, null será retornado. Chamar um return com parênteses mas sem argumentos resultará em um erro de interpretação.

A partir do PHP 7.1.0, declarações 'return' sem um argumento em funções que declaram um tipo de retorno acionam E_COMPILE_ERROR, a não ser que o tipo de retorno seja void, nesse caso declarações 'return' com um argumento acionam esse erro.