PHP soporta un operador de control de errores: el arroba (@
).
Cuando este operador se añade como prefijo a una expresión PHP, los diagnósticos de errores que pueden ser generados por esta expresión serán ignorados.
Si un gestor de errores personalizado es definido con set_error_handler(), será llamado aún si el diagnóstico ha sido ignorado.
Anterior a PHP 8.0.0, la función error_reporting() llamada en el gestor de errores personalizado siempre retornaba 0
si el error fue ignorado con el operador @
.
A partir de 8.0.0, retorna el valor de esta expresión (bit a bit): E_ERROR | E_CORE_ERROR | E_COMPILE_ERROR | E_USER_ERROR | E_RECOVERABLE_ERROR | E_PARSE
.
Todos los mensajes de error generados por la expresión están disponibles en el elemento "message"
del array retornado por la función error_get_last(). El resultado de la función cambiará con cada error, por lo tanto, es conveniente verificarlo frecuentemente.
Ejemplo #1 Error de fichero intencional
<?php
$mon_fichier = @file ('non_persistent_file') or
die ("Imposible abrir el fichero: El error es: '" . error_get_last()['message'] . "'");
?>
Ejemplo #2 La expresión de eliminación
<?php
// Esto funciona con cualquier expresión, no solo con funciones
$value = @$cache[$key];
// la línea anterior no mostrará una alerta si la clave $key del array no existe
?>
Nota: El operador
@
solo funciona con las expresiones. La regla general es: si es posible tomar el valor de algo, entonces se puede preponer el operador@
a este. Por ejemplo, puede ser prepuesto a variables, llamadas de funciones, ciertas llamadas a construcciones de lenguaje (por ejemplo, include), etc. No puede ser prepuesto a definiciones de funciones o clases o estructuras condicionales comoif
yforeach
, etc.
Anterior a PHP 8.0.0, era posible que el operador @
desactivara los errores críticos que terminaban la ejecución del script.
Por ejemplo, preponer @
a una llamada de una función que no existe, que esté indisponible o mal escrita, causaba que el script terminara sin ninguna indicación de por qué.