O comportamento destas funções é afetado pelas configurações do php.ini.
| Nome | Padrão | Modificável | Registro de Alterações |
|---|---|---|---|
| error_reporting | NULL | INI_ALL | |
| display_errors | "1" | INI_ALL | |
| display_startup_errors | "1" | INI_ALL | Antes do PHP 8.0.0, o valor padrão era "0". |
| log_errors | "0" | INI_ALL | |
| log_errors_max_len | "1024" | INI_ALL | Sem efeito a partir do PHP 8.0.0, removido a partir do PHP 8.1.0. |
| ignore_repeated_errors | "0" | INI_ALL | |
| ignore_repeated_source | "0" | INI_ALL | |
| report_memleaks | "1" | INI_ALL | |
| track_errors | "0" | INI_ALL | Defasado a partir do PHP 7.2.0, removido a partir do PHP 8.0.0. |
| html_errors | "1" | INI_ALL | |
| xmlrpc_errors | "0" | INI_SYSTEM | |
| xmlrpc_error_number | "0" | INI_ALL | |
| docref_root | "" | INI_ALL | |
| docref_ext | "" | INI_ALL | |
| error_prepend_string | NULL | INI_ALL | |
| error_append_string | NULL | INI_ALL | |
| error_log | NULL | INI_ALL | |
| error_log_mode | 0o644 | INI_ALL | Disponível a partir do PHP 8.2.0 |
| syslog.facility | "LOG_USER" | INI_SYSTEM | Disponível a partir do PHP 7.3.0. |
| syslog.filter | "no-ctrl" | INI_ALL | Disponível a partir do PHP 7.3.0. |
| syslog.ident | "php" | INI_SYSTEM | Disponível a partir do PHP 7.3.0. |
Aqui está uma breve explicação das diretivas de configuração.
error_reportingintDefine o nível das reportagens de erros. O parâmetro é ou um inteiro representando um campo de bits ou constantes nomeadas. Os níveis e constantes de reportagens de erros estão descritos em Constantes Pré-definidas e no arquivo php.ini. Para definir em tempo de execução, use a função error_reporting(). Consulte também a diretiva display_errors.
O padrão é E_ALL.
Antes do PHP 8.0.0, o valor padrão era: E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATEDE_NOTICE, E_STRICT e E_DEPRECATED não eram mostrados.
Nota: Constantes do PHP fora do PHP
Usar constantes do PHP fora do PHP, como no httpd.conf, não terão significado algum, portanto, nesses casos, os valores int são necessários. E, como níveis de erro serão adicionados ao longo do tempo, o valor máximo (para
E_ALL) provavelmente será alterado. Portanto, no lugar deE_ALL, considere usar um valor maior para cobrir todos os campos de bits, tanto os de hoje como os do futuro, um valor numérico como2147483647(inclui todos os erros, não apenasE_ALL).
display_errorsstringEste parâmetro determina se os erros devem ser mostrados na tela como parte da saída ou se devem ser ocultados do usuário.
O valor "stderr" envia os erros para stderr em vez de stdout.
Nota:
Este é um recurso para dar suporte ao desenvolvimento e nunca deve ser usado em sistemas de produção (por exemplo, sistemas conectados à internet).
Nota:
Embora display_errors possa ser configurado em tempo de execução (com ini_set()), ele não terá nenhum efeito se o script tiver erros fatais. Isso ocorre porque a ação desejada em tempo de execução não é executada.
display_startup_errorsboolMesmo quando display_errors está ativado, erros que ocorrem durante a sequência de inicialização do PHP não são exibidos. É altamente recomendável manter display_startup_errors desativado, exceto para depuração.
log_errorsboolInforma se as mensagens de erro de script devem ser gravadas no registro de erros do servidor ou no local indicado por error_log. Essa opção é, portanto, específica do servidor.
Nota:
É altamente aconselhável usar o registro de erros em vez de exibir erros em sites de produção.
log_errors_max_lenintDefine o comprimento máximo de log_errors em bytes. Em error_log, informações sobre a fonte são adicionadas. O padrão é 1024, e 0 permite não aplicar limite de comprimento. Esse tamanho é aplicado a erros registrados, erros exibidos e também a $php_errormsg, mas não a funções chamadas explicitamente como error_log().
Quando um int é usado, o valor é medido em bytes. A notação abreviada, como descrita nesta FAQ, também pode ser usada.ignore_repeated_errorsboolNão registra mensagens repetidas. Erros repetidos devem ocorrer no mesmo arquivo e na mesma linha, a menos que ignore_repeated_source seja definido como verdadeiro.
ignore_repeated_sourceboolIgnora a fonte da mensagem quando estiver ignorando mensagens repetidas. Quando esta configuração estiver On, não serão registrados erros com mensagens repetidas de arquivos ou linhas diferentes.
report_memleaksbool Se este parâmetro estiver definido como On (o padrão), este parâmetro mostrará um relatório de vazamentos de memória detectados pelo gerenciador de memória do Zend. Este relatório será enviado para stderr em plataformas Posix. No Windows, ele será enviado ao depurador usando o OutputDebugString() e poderá ser visualizado com ferramentas como » DbgView. Este parâmetro só tem efeito em uma compilação de depuração e se error_reporting incluir E_WARNING na lista de erros permitidos.
track_errorsboolSe habilitado, a última mensagem de erro estará sempre presente na variável $php_errormsg.
html_errorsboolSe ativado, as mensagens de erro incluirão tags HTML. O formato para erros de HTML produz mensagens clicáveis que direcionam o usuário para uma página descrevendo o erro ou a função que está causando o erro. Essas referências são afetadas por docref_root e docref_ext.
Se desativado, a mensagem de erro será apenas texto simples.
xmlrpc_errorsboolSe ativado, desativa o relatório de erros normal e formata os erros como mensagem de erro XML-RPC.
xmlrpc_error_numberintUsado como o valor do elemento faultCode do XML-RPC.
docref_rootstring O novo formato de erro contém uma referência a uma página que descreve o erro ou a função que está causando o erro. No caso de páginas de manual, pode-se baixar o manual no idioma próprio e definir esta diretiva ini para a URL da cópia local. Se a cópia local do manual puder ser alcançada por "/manual/" pode-se simplesmente usar docref_root=/manual/. Além disso, é necessário definir docref_ext para corresponder às extensões de arquivo da cópia local docref_ext=.html. É possível usar referências externas. Por exemplo, pode-se usar docref_root=http://manual/en/ ou docref_root="http://landonize.it/?how=url&theme=classic&filter=Landon &url=http%3A%2F%2Fwww.php.net%2F"
Na maioria das vezes, é desejado que o valor docref_root termine com uma barra "/". Mas veja o segundo exemplo acima, que não tem nem precisa dela.
Nota:
Este é um recurso para dar suporte ao desenvolvimento, pois facilita a pesquisa da descrição de uma função. No entanto, nunca deve ser usado em sistemas de produção (por exemplo, sistemas conectados à internet).
docref_extstringConsulte docref_root.
Nota:
O valor de docref_ext deve começar com um ponto
".".
error_prepend_stringstringString a ser mostrado antes de uma mensagem de erro. Usado apenas quando a mensagem de erro é mostrada na tela. O propósito principal é prover a capacidade de prefixar uma marcação HTML adicional à mensagem de erro.
error_append_stringstringString para mostrar após uma mensagem de erro. Usado apenas quando a mensagem de erro é mostrada na tela. O propósito principal é prover a capacidade de posfixar uma marcação HTML adicional à mensagem de erro.
error_logstring Nome do arquivo onde os erros de script devem ser registrados. O arquivo deve ter permissão de escrita pelo usuário do servidor da web. Se o valor especial syslog for usado, os erros serão enviados ao registrador de erros do sistema. No Unix, isso significa syslog(3) e no Windows significa o Log de Eventos. Veja também: syslog(). Se esta diretiva não estiver definida, os erros serão enviados para o registrador de erros SAPI. Por exemplo, é um log de erros no Apache ou stderr no CLI. Consulte também error_log().
error_log_modeintModo de arquivo para o arquivo definido em error_log.
syslog.facilitystringEspecifica qual tipo de programa está registrando a mensagem. Apenas efetivo se error_log estiver definido como "syslog".
syslog.filterstring Especifica o tipo de filtro para filtrar as mensagens registradas. Caracteres permitidos são passados sem modificações; todos os outros são escritos em sua representação hexadecimal prefixados com \x.
all - a string registrada será partida nos caracteres de novas linhas, e todos os caracteres serão passados inalterados ascii - a string registrada será partida nos caracteres de novas linhas, e qualquer caractere ASCII de 7 bits não imprimível será escapado no-ctrl - a string registrada será partida nos caracteres de novas linhas, e qualquer caractere não imprimível será escapado raw - todos os caracteres são passados ao registrador do sistema logger inalterados, sem separação novas linhas (idêntico ao PHP antes do 7.3) Esta diretiva não é suportada no Windows.Nota:
O tipo de filtro
rawestá disponível a partir do PHP 7.3.8 e do PHP 7.4.0.
syslog.identstringEspecifica a string de identificação que é anexada a todas as mensagens. Somente é efetivo se error_log estiver definido como "syslog".