error_reporting

(PHP 4, PHP 5, PHP 7, PHP 8)

error_reporting — Define quais erros do PHP são relatados

Descrição

error_reporting(?int $error_level = null): int

A função error_reporting() define a diretiva error_reporting em tempo de execução. O PHP possui muitos níveis de erros, e o uso desta função define esse nível para a duração (tempo de execução) do seu script. Se o parâmetro opcional error_level não for definido, a função error_reporting() retornará apenas o nível de relatório de erros atual.

Parâmetros

error_level

O novo nível de error_reporting. Pode ser uma máscara de bits ou constantes nomeadas. É altamente recomendado o uso de constantes nomeadas para garantir compatibilidade com futuras versões. Conforme são adicionados níveis de erro, o intervalo de inteiros aumenta, então os níveis de erro baseados em inteiros mais antigos nem sempre se comportarão como esperado.

As constantes de nível de erro disponíveis e os significados reais desses níveis de erro são descritos nas constantes predefinidas.

Valor Retornado

Retorna o nível de error_reporting antes que ele seja alterado para error_level.

Note: O operador de controle de erro @ altera o error_level durante o tratamento de erros.

Registro de Alterações

Versão Descrição
8.0.0 error_level agora permite null.

Exemplos

Example #1 Exemplo error_reporting()

<?php

// Desativar todos os relatórios de erros
error_reporting(0);

// Relatar erros simples durante a execução
error_reporting(E_ERROR | E_WARNING | E_PARSE);

// Relatar E_NOTICE também pode ser útil (para relatar variáveis não inicializadas
// ou capturar erros de digitação nos nomes das variáveis...)
error_reporting(E_ERROR | E_WARNING | E_PARSE | E_NOTICE);

// Relatar todos os erros, exceto E_NOTICE
error_reporting(E_ALL & ~E_NOTICE);

// Relatar todos os erros do PHP
error_reporting(E_ALL);

// Relatar todos os erros do PHP
error_reporting(-1);

// O mesmo que error_reporting(E_ALL);
ini_set('error_reporting', E_ALL);

?>

Notas

Tip

Passar o valor -1 mostrará todos os erros possíveis, mesmo quando novos níveis e constantes forem adicionados em futuras versões do PHP. O comportamento é equivalente a passar a constante E_ALL.

Veja Também