(PHP 4, PHP 5, PHP 7, PHP 8)
return devuelve el control del programa al módulo que lo invoca.
La ejecución vuelve a la siguiente expresión después del módulo que lo invoca.
Si se llama desde una función, la sentencia return
inmediatamente termina la ejecución de la función actual, y
devuelve su argumento como el valor de la llamada a la
función. return también termina la ejecución de
una sentencia eval() o un archivo de script.
Si se llama desde el ámbito global, entonces la ejecución del script
actual se termina. Si el archivo script actual fue incluido o requerido con
include o require,
entonces el control es pasado de regreso al archivo que hizo el llamado. Además, si
el archivo script actual fue incluido con include, entonces
el valor dado a return será retornado como
el valor de la llamada include. Si
return es llamado desde dentro del fichero del script
principal, entonces termina la ejecución del script. Si el archivo script actual fue
nombrado por las opciones de configuración auto_prepend_file o auto_append_file
en php.ini, entonces se
termina la ejecución de ese archivo script.
Para más información, ver Retornando valores.
Nota: Cabe señalar que dado que
returnes un constructor del lenguaje y no una función, los paréntesis que rodean su argumento no son obligatorios y se desaconseja su uso.
Nota: Si no se suministra un parámetro, entonces el paréntesis debe omitirse y
nullserá retornado. Llamadas areturncon paréntesis pero sin argumentos resultarán en un error del intérprete.
for those of you who think that using return in a script is the same as using exit note that: using return just exits the execution of the current script, exit the whole execution.
look at that example:
a.php
<?php
include("b.php");
echo "a";
?>
b.php
<?php
echo "b";
return;
?>
(executing a.php:) will echo "ba".
whereas (b.php modified):
a.php
<?php
include("b.php");
echo "a";
?>
b.php
<?php
echo "b";
exit;
?>
(executing a.php:) will echo "b".Note that because PHP processes the file before running it, any functions defined in an included file will still be available, even if the file is not executed.
Example:
a.php
<?php
include 'b.php';
foo();
?>
b.php
<?php
return;
function foo() {
echo 'foo';
}
?>
Executing a.php will output "foo".