archived-doc-es/reference/errorfunc/functions/error-reporting.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297626 $ -->
<!-- EN-Revision: 0b4c5897dd4f9ca3ec78ac7e1be64ffe82b27d32 Maintainer: seros Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.error-reporting">
 <refnamediv>
  <refname>error_reporting</refname>
  <refpurpose>Establece qué errores de PHP son notificados</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>int</type><methodname>error_reporting</methodname>
   <methodparam choice="opt"><type>int</type><parameter>level</parameter></methodparam>
  </methodsynopsis>
  <para>
   La función <function>error_reporting</function> establece la directiva
   <link linkend="ini.error-reporting">error_reporting</link>
   en tiempo de ejecución. PHP tiene muchos niveles de errores, al utilizar
   esta función se establece qué nivel para la duración (tiempo de ejecución) de
   su script. Si no se establece el parámetro opcional <parameter>level</parameter>,
   <function>error_reporting</function> simplemente devolverá
   el nivel de notificación de errores actual.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>level</parameter></term>
     <listitem>
      <para>
       El nuevo nivel de <link linkend="ini.error-reporting">error_reporting</link>.
       Toma una máscara de bits o constantes nominadas. Al usar constantes
       nominadas se aconseja asegurarse la compatibilidad para versiones
       futuras. Mientras se añaden niveles de errores, el rango de los valores integers aumenta, 
       por lo que los niveles de errores basados en valores integer antiguos no se comportarán como se
       esperaba.
      </para>
      <para>
       Las constantes de niveles de error disponibles y los significados
       reales de estos errores están descritos en las
       <link linkend="errorfunc.constants">constantes predefinidas</link>.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve el antiguo nivel de <link linkend="ini.error-reporting">error_reporting</link>
   del nivel actual si no se da el parámetro <parameter>level</parameter>.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>5.0.0</entry>
       <entry>Se introdujo <constant>E_STRICT</constant> (no es parte de <constant>E_ALL</constant>).</entry>
      </row>
      <row>
       <entry>5.2.0</entry>
       <entry>Se introdujo <constant>E_RECOVERABLE_ERROR</constant>.</entry>
      </row>
      <row>
       <entry>5.3.0</entry>
       <entry>Se introdujo <constant>E_DEPRECATED</constant> y <constant>E_USER_DEPRECATED</constant>.</entry>
      </row>
      <!-- FIXME PHP_6
      <row>
       <entry>6.0.0</entry>
       <entry><constant>E_STRICT</constant> became part of <constant>E_ALL</constant>.</entry>
      </row>
      -->
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplos de <function>error_reporting</function></title>
    <programlisting role="php">
<![CDATA[
<?php

// Desactivar toda notificación de errores
error_reporting(0);

// Notificar solamente errores de ejecución
error_reporting(E_ERROR | E_WARNING | E_PARSE);

// Notificar E_NOTICE también puede ser bueno (para informar de variables
// no inicializadas o capturar nombres de variables con errores ortográficos ...)
error_reporting(E_ERROR | E_WARNING | E_PARSE | E_NOTICE);

// Notificar todos los errores excepto E_NOTICE
// Este es el valor predeterminado establecido en php.ini
error_reporting(E_ALL ^ E_NOTICE);

// Notificar todos los errores de PHP (véase el registro de cambios)
error_reporting(E_ALL);

// Notificar todos los errores de PHP
error_reporting(-1);

// Lo mismo que error_reporting(E_ALL);
ini_set('error_reporting', E_ALL);

?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <warning>
   <simpara>
    La mayoría de los errores <constant>E_STRICT</constant> son evaluados en tiempo
    de compilación por lo que tales errores no son notificados en el archivos cuando
    <link linkend="ini.error-reporting">error_reporting</link> se mejora
    al incluir errores <constant>E_STRICT</constant> (y viceversa).
   </simpara>
  </warning>
  <tip>
   <simpara>
    Al pasar el valor <literal>-1</literal> se mostrarán todos los errores posibles,
    incluso cuando se añadan nuevos niveles y constantes en futuras versiones de PHP.
    <!-- FIXME PHP_6
     The
    <constant>E_ALL</constant> constant also behaves this way as of PHP 6.
    -->
   </simpara>
  </tip>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member>La directiva <link linkend="ini.display-errors">display_errors</link></member>
    <member>La directiva <link linkend="ini.html-errors">html_errors</link></member>
    <member>La directiva <link linkend="ini.xmlrpc-errors">xmlrpc_errors</link></member>
    <member><function>ini_set</function></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->