return
(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 return
es 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 null
será
retornado. Llamadas a return
con paréntesis pero
sin argumentos resultarán en un error del intérprete.
warhog at warhog dot net ¶18 years ago
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".
J.D. Grimes ¶11 years ago
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".