21/4/2020 Excepciones | Manual de PHP

FAQ: cosas que se necesitan saber sobre los espacios de nombres Referencia del Ampliar las Excepciones
lenguaje
PHP Manual

Excepciones
Tabla de contenidos
Ampliar las Excepciones

PHP 5 tiene un modelo de excepciones similar al de otros lenguajes de programación. Una excepción puede
ser lanzada (thrown), y atrapada ("catched") dentro de PHP. El código puede estar dentro de un bloque try,
para facilitar la captura de excepciones potenciales. Cada bloque try debe tener al menos un bloque catch
correspondiente. Se pueden usar múltiples bloques catch para atrapar diferentes clases de excepciones. La
ejecución normal (cuando no es lanzada ninguna excepción dentro del bloque try, o cuando un bloque catch
que coincide con la clase de la excepción lanzada no está presente) continuará después del último bloque
catch definido en la sencuencia. Las excepciones pueden ser lanzadas (o relanzadas) dentro de un bloque
catch.

Cuando una excepción es lanzada, el código siguiente a la declaración no será ejecutado, y PHP intentará
encontrar el primer bloque catch conicidente. Si una excepción no es capturada, se emitirá un Error Fatal de
PHP con un mensaje "Uncaught Exception ..." ("Excepción No Capturada"), a menos que se haya definido
un gestor con set_exception_handler().

En PHP 5.5 y posteriores, se puede utilizar un bloque finally después de los bloques catch. El código de
dentro del bloque finally siempre se ejecutará después de los bloques try y catch, independientemente de que
se haya lanzado una excepción o no, y antes de que el flujo normal de ejecución continúe.

El objeto lanzado debe ser una instancia de la clase Exception o de una subclase de Exception. Intentar
lanzar un objeto que no lo es resultará en un Error Fatal de PHP.

Nota:

Las funciones internas de PHP utilizan principalmente Información de Errores, sólo las
extensiones Orientadas a objetos modernas utilizan excepciones. Sin embargo, los errores se
pueden traducir a excepciones simplemente con ErrorException.

Sugerencia

Standard PHP Library (SPL) - (Biblioteca PHP Estándar) proporciona un buen número de excepciones
internas.

Ejemplo #1 Lanzar una Excepción

<?php
function inverso($x) {
if (!$x) {
throw new Exception('División por cero.');
}
else return 1/$x;
}

try {
echo inverso(5) . "\n";
echo inverso(0) . "\n";
https://manuales.guebs.com/php/language.exceptions.html 1/3
21/4/2020 Excepciones | Manual de PHP

} catch (Exception $e) {

echo 'Excepción capturada: ', $e->getMessage(), "\n";
}

// Continuar la ejecución
echo 'Hola Mundo';
?>

El resultado del ejemplo sería:

0.2
Excepción capturada: División por cero.
Hola Mundo

Ejemplo #2 Manejo de excepciones con un bloque finally

<?php
function inverse($x) {
if (!$x) {
throw new Exception('División por cero.');
}
else return 1/$x;
}

try {
echo inverse(5) . "\n";
} catch (Exception $e) {
echo 'Excepción capturada: ', $e->getMessage(), "\n";
} finally {
echo "Primer finally.\n";
}

try {
echo inverse(0) . "\n";
} catch (Exception $e) {
echo 'Excepción capturada: ', $e->getMessage(), "\n";
} finally {
echo "Segundo finally.\n";
}

// Continuar ejecución
echo 'Hola Mundo';
?>

El resultado del ejemplo sería:

0.2
Primer finally.
Excepción capturada: División por cero.
Segundo finally.
Hola Mundo

Ejemplo #3 Excepciones Anidadas

<?php

class MiExcepción extends Exception { }

class Prueba {
public function probar() {
try {
try {
throw new MiExcepción('foo!');
} catch (MiExcepción $e) {
/* relanzarla */
throw $e;
}
} catch (Exception $e) {
https://manuales.guebs.com/php/language.exceptions.html 2/3
21/4/2020 Excepciones | Manual de PHP

var_dump($e->getMessage());
}
}
}

$foo = new Prueba;

$foo->probar();

?>

El resultado del ejemplo sería:

string(4) "foo!"

FAQ: cosas que se necesitan saber sobre los espacios de nombres Referencia del Ampliar las Excepciones
lenguaje
PHP Manual

https://manuales.guebs.com/php/language.exceptions.html 3/3