-
Notifications
You must be signed in to change notification settings - Fork 59
Expand file tree
/
Copy patherrorcontrol.xml
More file actions
77 lines (73 loc) · 3.34 KB
/
errorcontrol.xml
File metadata and controls
77 lines (73 loc) · 3.34 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 16934048f79c6e117cd16a23c09c1b2ea502e284 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="language.operators.errorcontrol">
<title>Operador de control de errores</title>
<titleabbrev>Control de errores</titleabbrev>
<simpara>
PHP soporta un operador de control de errores: el arroba (<literal>@</literal>).
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.
</simpara>
<para>
Si un gestor de errores personalizado es definido con <function>set_error_handler</function>, será llamado aún si el diagnóstico ha sido ignorado.
</para>
<warning>
<para>
Anterior a PHP 8.0.0, la función <function>error_reporting</function> llamada en el gestor de errores personalizado siempre retornaba <literal>0</literal> si el error fue ignorado con el operador <literal>@</literal>.
A partir de 8.0.0, retorna el valor de esta expresión (bit a bit): <literal>E_ERROR | E_CORE_ERROR | E_COMPILE_ERROR | E_USER_ERROR | E_RECOVERABLE_ERROR | E_PARSE</literal>.
</para>
</warning>
<simpara>
Todos los mensajes de error generados por la expresión están disponibles en el elemento <literal>"message"</literal> del array retornado por la función <function>error_get_last</function>. El resultado de la función cambiará con cada error, por lo tanto, es conveniente verificarlo frecuentemente.
</simpara>
<para>
<example>
<title>Error de fichero intencional</title>
<programlisting role="php">
<![CDATA[
<?php
$mon_fichier = @file ('non_persistent_file') or
die ("Imposible abrir el fichero: El error es: '" . error_get_last()['message'] . "'");
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>La expresión de eliminación</title>
<programlisting role="php">
<![CDATA[
<?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
?>
]]>
</programlisting>
</example>
</para>
<note>
<simpara>
El operador <literal>@</literal> solo funciona con las <link linkend="language.expressions">expresiones</link>.
La regla general es: si es posible tomar el valor de algo, entonces se puede preponer el operador <literal>@</literal> a este.
Por ejemplo, puede ser prepuesto a variables, llamadas de funciones, ciertas llamadas a construcciones de lenguaje (por ejemplo, <function>include</function>), etc.
No puede ser prepuesto a definiciones de funciones o clases o estructuras condicionales como <literal>if</literal> y &foreach;, etc.
</simpara>
</note>
<warning>
<para>
Anterior a PHP 8.0.0, era posible que el operador <literal>@</literal> desactivara los errores críticos que terminaban la ejecución del script.
Por ejemplo, preponer <literal>@</literal> 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é.
</para>
</warning>
<sect2 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>error_reporting</function></member>
<member><link linkend="ref.errorfunc">Gestión de Errores y Funciones de Logging</link></member>
</simplelist>
</para>
</sect2>
</sect1>