Manejo de errores PHP

Errores de manejo

A veces su aplicación no se ejecutará como se supone que debe hacerlo, lo que provocará un error. Hay varias razones que pueden causar errores, por ejemplo:

• El servidor web podría quedarse sin espacio en disco
• Un usuario podría haber ingresado un valor no válido en un campo de formulario
• Es posible que el archivo o el registro de la base de datos al que intentaba acceder no exista
• Es posible que la aplicación no tenga permiso para escribir en un archivo en el disco
• Un servicio al que la aplicación necesita acceder podría no estar disponible temporalmente

Estos tipos de errores se conocen como errores de tiempo de ejecución, ya que se producen en el momento en que se ejecuta el script. Son distintos de los errores de sintaxis que deben corregirse antes de que se ejecute el script.

Una aplicación profesional debe tener las capacidades para manejar este error de tiempo de ejecución con gracia. Por lo general, esto significa informar al usuario sobre el problema de manera más clara y precisa.

Comprensión de los niveles de error

Por lo general, cuando hay un problema que impide que un script se ejecute correctamente, el motor PHP activa un error. Cada error está representado por un valor entero y una constante asociada. La siguiente tabla enumera algunos de los niveles de error comunes:

Para obtener más niveles de error, consulte la referencia sobre niveles de error de PHP .

El motor PHP desencadena un error cada vez que encuentra un problema con su script, pero también puede desencadenar errores usted mismo para generar mensajes de error más fáciles de usar. De esta manera, puede hacer que su aplicación sea más sofisticada. La siguiente sección describe algunos de los métodos comunes utilizados para manejar errores en PHP:

Manejo básico de errores utilizando la die()función

Considere el siguiente ejemplo que simplemente intenta abrir un archivo de texto para lectura solamente.

<?php
// Try to open a non-existent file
$file = fopen("sample.txt", "r");
?>

Si el archivo no existe, puede obtener un error como este:

Si seguimos algunos pasos simples, podemos evitar que los usuarios reciban dicho mensaje de error.

<?php
if(file_exists("sample.txt")){
    $file = fopen("sample.txt", "r");
} else{
    die("Error: The file you are trying to access doesn't exist.");
}
?>

Ahora, si ejecuta el script anterior, obtendrá el mensaje de error como este:

Como puede ver al implementar una simple verificación de si el archivo existe o no antes de intentar acceder a él, podemos generar un mensaje de error que sea más significativo para el usuario.

La die()función utilizada anteriormente simplemente muestra el mensaje de error personalizado y termina el script actual si no se encuentra el archivo ‘sample.txt’.

Crear un controlador de errores personalizado

Puede crear su propia función de controlador de errores para tratar el error de tiempo de ejecución generado por el motor PHP. El controlador de errores personalizado le brinda una mayor flexibilidad y un mejor control sobre los errores, puede inspeccionar el error y decidir qué hacer con el error, puede mostrar un mensaje al usuario, registrar el error en un archivo o base de datos o enviarlo por correo electrónico -mail, intente solucionar el problema y continúe, salga de la ejecución del script o ignore el error por completo.

La función del controlador de errores personalizado debe poder manejar al menos dos parámetros (errno y errstr), sin embargo, opcionalmente puede aceptar tres parámetros adicionales (errfile, errline y errcontext), como se describe a continuación:

Aquí hay un ejemplo de una simple función personalizada de manejo de errores. Este controlador customError()se activa cada vez que se produce un error, sin importar cuán trivial sea. Luego muestra los detalles del error al navegador y detiene la ejecución del script.

<?php
// Error handler function
function customError($errno, $errstr){
    echo "<b>Error:</b> [$errno] $errstr";
}
?>

Debe indicarle a PHP que use su función de controlador de errores personalizada: simplemente llame a la función incorporada y set_error_handler()pase el nombre de la función.

<?php
// Error handler function
function customError($errno, $errstr){
    echo "<b>Error:</b> [$errno] $errstr";
}
 
// Set error handler
set_error_handler("customError");
 
// Trigger error
echo($test);
?>

<?php
function calcDivision($dividend, $divisor){
    if($divisor == 0){
        trigger_error("calcDivision(): The divisor cannot be zero", E_USER_WARNING);
        return false;
    } else{
        return($dividend / $divisor);
    }
}
function customError($errno, $errstr, $errfile, $errline, $errcontext){
    $message = date("Y-m-d H:i:s - ");
    $message .= "Error: [" . $errno ."], " . "$errstr in $errfile on line $errline, ";
    $message .= "Variables:" . print_r($errcontext, true) . "\r\n";
    
    error_log($message, 3, "logs/app_errors.log");
    die("There was a problem, please try again.");
}
set_error_handler("customError");
echo calcDivision(10, 0);
echo "This will never be printed.";
?>

<?php
function calcDivision($dividend, $divisor){
    if ($divisor == 0){
        trigger_error("calcDivision(): The divisor cannot be zero", E_USER_WARNING);
        return false;
    } else{
        return($dividend / $divisor);
    }
}
function customError($errno, $errstr, $errfile, $errline, $errcontext){
    $message = date("Y-m-d H:i:s - ");
    $message .= "Error: [" . $errno ."], " . "$errstr in $errfile on line $errline, ";
    $message .= "Variables:" . print_r($errcontext, true) . "\r\n";
    
    error_log($message, 1, "webmaster@example.com");
    die("There was a problem, please try again. Error report submitted to webmaster.");
}
set_error_handler("customError");
echo calcDivision(10, 0);
echo "This will never be printed.";
?>

<?php
function calcDivision($dividend, $divisor){
    return($dividend / $divisor);
}
 
// Calling the function
echo calcDivision(10, 0);
?>

<?php
function calcDivision($dividend, $divisor){
    if($divisor == 0){
        trigger_error("The divisor cannot be zero", E_USER_WARNING);
        return false;
    } else{
        return($dividend / $divisor);
    }
}
 
// Calling the function
echo calcDivision(10, 0);
?>