return

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

return devuelve el control del programa al módulo llamante. La ejecución se reanuda entonces en la instrucción siguiente a la invocación del módulo.

Si se llama desde una función, el comando return termina inmediatamente la función y devuelve el argumento que se le pasa. return también interrumpe la ejecución del comando eval() o de scripts.

Si se llama desde el entorno global, la ejecución del script se interrumpe. Si el script actual fue incluido con la estructura include o require, entonces el control se devuelve al script llamante. Además, si el fichero del script actual ha sido incluido a través de la instrucción include, entonces el valor dado a return será devuelto como resultado de la llamada include. Si return es llamada desde el script principal, entonces la ejecución del script se detiene. Si el script actual es auto_prepend_file o auto_append_file en el fichero php.ini, entonces la ejecución del script se detiene.

Para más información, véase devolver valores.

Nota: Tenga en cuenta que ya que return es una estructura de lenguaje, y no una función, los paréntesis que rodean los argumentos no son necesarios y su uso está desaconsejado.

Nota: Si no se proporciona ningún parámetro, entonces los paréntesis deben ser omitidos y null será devuelto. La llamada de return con paréntesis pero sin argumento resultará en una alerta de análisis.

A partir de PHP 7.1.0, las declaraciones de retorno sin argumento en la función generan un E_COMPILE_ERROR, excepto si el tipo de retorno es void, en cuyo caso las declaraciones de retorno con un argumento generan este error.