exit
(PHP 4, PHP 5, PHP 7, PHP 8)
exit — Terminar el script en curso con un código de estado o un mensaje
Descripción
Termina el script actual.
Las funciones de cierre
y los destructores de objetos
siempre se ejecutarán incluso si exit
es llamado.
Sin embargo, los bloques finally
nunca se ejecutan.
Un código de salida de 0
se utiliza para indicar que el programa ha
completado sus tareas correctamente. Cualquier otro valor indica que ocurrió un error
durante la ejecución.
exit() es una función especial,
ya que dispone de un token dedicado en el analizador sintáctico.
Puede ser utilizada como una instrucción (es decir, sin paréntesis)
para terminar el script con el código de estado por defecto.
Precaución
No es posible desactivar o crear una función en un espacio de nombres
que reemplace la función global exit().
Parámetros
status
-
Si
status
es un string,
esta función muestra status
justo antes de salir.
El código de salida devuelto por PHP es 0
.
Si status
es un int,
el código de salida devuelto por PHP será status
.
Nota:
Los códigos de salida deben estar comprendidos entre 0
y 254
.
El código de salida 255
está reservado por PHP y no debe ser utilizado.
Valores devueltos
Como esta función termina el script PHP, ningún valor es devuelto.
Ejemplos
Ejemplo #1 Ejemplo básico de la función exit()
<?php
// salir del programa normalmente
exit();
exit(0);
// salir con un código de error
exit(1);
?>
Ejemplo #2 Ejemplo de exit() con un string
<?php
$filename = '/path/to/data-file';
$file = fopen($filename, 'r')
or exit("no se puede abrir el archivo ($filename)");
?>
Ejemplo #3 Ejemplo de ejecución de funciones de cierre y destructores de objetos
<?php
class Foo
{
public function __destruct()
{
echo 'Destructor : ' . __METHOD__ . '()' . PHP_EOL;
}
}
function shutdown()
{
echo 'Cierre : ' . __FUNCTION__ . '()' . PHP_EOL;
}
$foo = new Foo();
register_shutdown_function('shutdown');
exit();
echo 'Esto nunca será mostrado.';
?>
El ejemplo anterior mostrará :
Cierre : shutdown()
Destrucción : Foo::__destruct()
Ejemplo #4 exit() como instrucción
<?php
// salir del programa normalmente con el código de salida 0
exit;
?>