exit

(PHP 4, PHP 5)

exit — Imprime un mensaje y termina el script actual

Descripción

void exit ([ string $status ] )
void exit ( int $status )

Finaliza la ejecución del script. Funciones shutdown y Objectos destructores siempre serán ejecutados incluso si se llama a la función exit.

exit es una construcción de lenguaje y puede ser llamada sin paréntesis si no se le pasa status.

Parámetros

status

Si status es una cadena, esta función imprime el status justo antes de salir.

Si status es un valor integer, ese valor será usado también como el status de salida y no se mostrará. Los status de salida deben estar en el rango 0 a 254, el status de salida 255 es reservado por PHP y no debe ser usado. El status 0 es usado para finalizar el programa de forma satisfactoria.

Nota: PHP >= 4.2.0 NO imprime el status si es un valor integer.

Valores devueltos

No devuelve ningún valor.

Ejemplos

Ejemplo #1 Ejemplo de exit

<?php

$nombre_archivo = '/ruta/hacia/archivo-datos';
$archivo = fopen($nombre_archivo, 'r')
    or exit("no se pudo abrir el archivo ($nombre_archivo)");

?>

Ejemplo #2 Ejemplo de status de exit

<?php

//finalizar el programa normalmente
exit;
exit();
exit(0);

//finalizar con un código de error
exit(1);
exit(0376); //octal

?>

Ejemplo #3 Las funciones Shutdown y los destructores se ejecutan igualmente

<?php
class Foo
{
    public function __destruct()
    {
        echo 'Destruct: ' . __METHOD__ . '()' . PHP_EOL;
    }
}

function shutdown()
{
    echo 'Shutdown: ' . __FUNCTION__ . '()' . PHP_EOL;
}

$foo = new Foo();
register_shutdown_function('shutdown');

exit();
echo 'Esto no se mostrará.';
?>

El resultado del ejemplo sería:

 Shutdown: shutdown()
 Destruct: Foo::__destruct()

Notas

Nota: Puesto que esto es una construcción del lenguaje y no una función, no puede ser llamada usando funciones variables.

Nota:

Esta construcción de lenguaje es equivalente a die().

Ver también