Ejemplo de PHP Try Catch: Tutorial de manejo de errores y excepciones

¿Qué es una excepción?

Un error es un resultado inesperado del programa que el programa mismo no puede manejar.

Los errores se resuelven arreglando el programa. Un ejemplo de error sería un bucle infinito que nunca deja de ejecutarse.

Una excepción es el resultado inesperado del programa que puede ser manejado por el propio programa.

Ejemplos de excepción incluyen intentar abrir un archivo que no existe.

Esta excepción se puede manejar creando el archivo o presentándole al usuario una opción para buscar el archivo.

¿Por qué manejar la excepción?

• Evitar resultados inesperados en nuestras páginas que pueden resultar muy molestos o irritantes para nuestros usuarios finales.
• Mejorar la seguridad de nuestras aplicaciones al no exponer información que usuarios malintencionados puedan utilizar para atacar nuestras aplicaciones.
• Las excepciones de PHP se utilizan para cambiar el flujo normal de un programa si ocurre algún error predecible.

Manejo de errores de PHP

Cuando ocurre un error, dependiendo de sus ajustes de configuración, PHP muestra el mensaje de error en el navegador web con información relacionada con el error ocurrido.

PHP ofrece varias formas de manejar errores.

Vamos a ver tres (3) métodos comúnmente utilizados;

1. Morir declaraciones– la función de troquel combina la función de eco y de salida en una. Es muy útil cuando queremos generar un mensaje y detener la ejecución del script cuando ocurre un error.
2. Manejadores de errores personalizados – estas son funciones definidas por el usuario que se llaman cada vez que ocurre un error.
3. Informe de errores de PHP – el mensaje de error depende de la configuración de informes de errores de PHP. Este método es muy útil en entornos de desarrollo cuando no se tiene idea de qué causó el error. La información que se muestra puede ayudarlo a depurar su aplicación.

Ejemplos de manejo de errores

Veamos ahora algunos ejemplos sencillos con rutinas de manejo de errores.

Supongamos que hemos desarrollado una aplicación que utiliza archivos de texto para almacenar datos. Es posible que queramos comprobar la existencia del archivo antes de intentar leer datos del mismo.

El siguiente código implementa el ejemplo anterior.

<?php
$denominator = 0;
echo 2 / $denominator;
?>

Suponiendo que guardó el archivo simple_error.php en la carpeta phptuts, abra el URL http://localhost/phptuts/simple_error.php

Obtendrás los siguientes resultados

Como puede ver en los resultados anteriores, hace que nuestra aplicación parezca poco profesional y puede resultar molesta para el usuario.

Modificaremos el código anterior y escribiremos un controlador de errores para la aplicación.

<?php
$denominator = 0;
if ($denominator != 0) {
    echo 2 / $denominator;
} else {
    echo "cannot divide by zero (0)";
}
?>

Suponiendo que guardó el código anterior como error_handling.php, abra el URL http://localhost/phptuts/error_handling.php

Nota: Es una buena práctica de seguridad mostrar un mensaje como el que se muestra arriba en lugar de mostrar un mensaje como "Archivo no encontrado".

Veamos otro ejemplo que utiliza un controlador de errores personalizado.

El controlador de errores personalizado se configurará como la función de manejo de errores de PHP predeterminada y básicamente mostrará un número de error y un mensaje.

El siguiente código ilustra la implementación del ejemplo anterior.

<?php
function my_error_handler($error_no, $error_msg)
{
    echo "Opps, something went wrong:";
    echo "Error number: [$error_no]";
    echo "Error Description: [$error_msg]";
}
set_error_handler("my_error_handler");
echo (5 / 0);
?>

Abra el panel de URL http://localhost/phptuts/custom_error_handler.php Obtendrás los siguientes resultados

.

• Nos permiten personalizar los mensajes de error.
• El controlador de errores personalizado también puede incluir el registro de errores en un archivo/base de datos, el envío de correos electrónicos al desarrollador, etc.

Ahora veamos el tercer tipo de manejo de errores. Usaremos la función incorporada de PHP error_reporting. Tiene la siguiente sintaxis básica

<?php
error_reporting($reporting_level);
?>

AQUÍ,

• “error_reporting” es la función de informe de errores de PHP
• “$reporting_level” es opcional y se puede utilizar para establecer el nivel de informes. Si no se ha especificado ningún nivel de informe, PHP utilizará el nivel de informe de errores predeterminado como se especifica en el archivo php.ini.

Diferencia entre errores y excepción

• Las excepciones se lanzan y se pretende detectar, mientras que los errores generalmente son irrecuperables.
• Las excepciones se manejan de forma orientada a objetos. Esto significa que cuando se lanza una excepción, se crea un objeto de excepción que contiene los detalles de la excepción.

La siguiente tabla muestra los métodos del objeto de excepción.

<?php
echo $e->getMessage();
?>

<?php
echo $e->getCode();
?>

<?php
echo $e->getFile();
?>

<?php
echo $e->getLine();
?>

<?php
print_r( $e->getTrace());
?>

<?php
echo $e->getPrevious();
?>

<?php
echo $e->getTraceAsString();
?>

<?php
echo $e->__toString();
?>

<?php
throw new Exception("This is an exception example");
?>

AQUÍ,

• "lanzar" es la palabra clave utilizada para lanzar la excepción
• "nueva excepción (...)" crea un objeto de excepción y pasa la cadena "Este es un ejemplo de excepción" como parámetro del mensaje.

El código anterior genera el siguiente mensaje.

Ahora veremos un ejemplo que implementa las excepciones de lanzamiento y captura.

Modificaremos el ejemplo anterior e incluiremos intentar, lanzar y atrapar.

Tiene la siguiente sintaxis básica.

<?php
try {
    //code goes here that could potentially throw an exception
}
catch (Exception $e) {
    //exception handling code goes here
}
?>

AQUÍ,

• "try{...}" es el bloque de código que se ejecutará y que potencialmente podría generar una excepción
• “catch(Exception $e){…}” es el bloque de código que detecta la excepción lanzada y asigna el objeto de excepción a la variable $e.

El siguiente código muestra el ejemplo de excepción básica con la excepción try, throw y catch implementada.

El programa lanza deliberadamente una excepción que luego detecta.

<?php
try {
    $var_msg = "This is an exception example";
    throw new Exception($var_msg);
}
catch (Exception $e) {
    echo "Message: " . $e->getMessage();
    echo "";
    echo "getCode(): " . $e->getCode();
    echo "";
    echo "__toString(): " . $e->__toString();
}
?>

Abra el panel de URL http://localhost/phptuts/exception_handling.php Obtendrás los siguientes resultados.

También es posible crear múltiples excepciones para una declaración try de php dependiendo del tipo de excepción lanzada.

Ver el artículo sobre MySQL, acceso a datos PHP... para ejemplos de implementación de múltiples excepciones

Múltiples excepciones

Las excepciones múltiples utilizan múltiples bloques try catch para manejar las excepciones lanzadas. Las excepciones múltiples son útiles cuando:

• Quiere mostrar un mensaje personalizado según la excepción lanzada
• Quiere realizar una operación única en función de la excepción lanzada

El siguiente diagrama de flujo ilustra cómo funcionan las excepciones múltiples.

Veamos un ejemplo que utiliza múltiples excepciones.

Modificaremos el código que divide un número por el denominador pasado.

Esperamos que ocurran dos tipos de excepciones;

• División por cero
• División por un número negativo

En aras de la simplicidad, solo mostraremos el tipo de excepción en nuestros bloques catch.

La clase PHP integrada Exception se utiliza para generar excepciones.

Crearemos dos clases que extiendan la clase de excepción y las usaremos para generar excepciones.

El siguiente código muestra la implementación.

<?php
class DivideByZeroException extends Exception {};
class DivideByNegativeException extends Exception {};
function process($denominator)
{
	try
	{
		if ($denominator == 0)
		{
			throw new DivideByZeroException();
		}
		else if ($denominator < 0)
		{
			throw new DivideByNegativeException();
		}
		else
		{
			echo 25 / $denominator;
		}
	}
	catch (DivideByZeroException $ex)
	{
		echo "DIVIDE BY ZERO EXCEPTION!";
	}
	catch (DivideByNegativeException $ex)
	{
		echo "DIVIDE BY NEGATIVE NUMBER EXCEPTION!";
	}
	catch (Exception $x)
	{
	echo "UNKNOWN EXCEPTION!";
	}
}
process(0);
?>

Probando el código

Asumiremos que guardó multiple_exceptions.php en la carpeta phptuts.

Navega hasta el URL http://localhost/phptuts/multiple_exceptions.php

Regrese al archivo PHP y pase -1 como parámetro como se muestra en el siguiente diagrama.

Navega hasta el URL http://localhost/phptuts/multiple_exceptions.php.

¿Qué resultados obtienes? Pase 3 como parámetro.

¿Qué resultados obtienes?

Resumen

• Los errores son resultados inesperados producidos por el código PHP.
• El manejo de errores mejora el rendimiento de la aplicación.
• PHP tiene funciones integradas que se pueden usar para personalizar la forma en que PHP informa errores
• Las excepciones son como errores, pero se pueden detectar usando el bloque catch cuando se lanzan.
• Mostrar mensajes de error que muestran información de error se considera una mala práctica de seguridad.