As funções Error e Logging permitem manipular e registrar erros.
A função Error permite ao usuário definir regras de tratamento de erros e modificar a forma como os erros são registrados.
A função Logging permite que os usuários registrem aplicativos e enviem mensagens de log para e-mail, logs do sistema ou outras máquinas.
A função de erro é afetada pelo arquivo de configuração php.ini.
Opções de configuração de erros e logs:
| parâmetro | valor padrão | descrever | Faixa modificável |
|---|---|---|---|
| relatório_erro | NULO | Define o nível de erro do PHP e retorna o nível atual (número ou constante). | PHP_INI_ALL |
| erros de exibição | "1" | Esta opção define se as mensagens de erro serão exibidas na tela como parte da saída ou ocultadas do usuário. Nota: Este recurso não deve ser usado no ambiente de produção (usado durante o desenvolvimento e teste) | PHP_INI_ALL |
| display_startup_errors | "0" | Mesmo se display_errors estiver ativado, mensagens de erro durante a inicialização do PHP não serão exibidas. É altamente recomendável definir display_startup_errors como desativado, exceto para fins de depuração. | PHP_INI_ALL |
| log_errors | "0" | Defina se deseja registrar informações de erro de execução de script no log de erros do servidor ou no error_log. Observe que este é um item de configuração específico do servidor. | PHP_INI_ALL |
| log_errors_max_len | "1024" | Defina o número máximo de bytes em log_errors As informações sobre a origem do erro serão adicionadas ao error_log. O valor padrão é 1024. Se definido como 0, não há limite para o comprimento. Esta configuração de comprimento tem um efeito limitante sobre erros registrados, erros exibidos e $php_errormsg. | PHP_INI_ALL |
| ignore_repeated_errors | "0" | Informações duplicadas não são registradas. Erros repetidos devem ocorrer na mesma linha de código no mesmo arquivo, a menos que ignore_repeated_source esteja definido como true. | PHP_INI_ALL |
| ignore_repeated_source | "0" | Quando mensagens duplicadas são ignoradas, a origem da mensagem também é ignorada. Quando esta configuração estiver ativada, as mensagens duplicadas não registrarão se foram geradas por arquivos diferentes ou por diferentes linhas de código-fonte. | PHP_INI_ALL |
| report_memleaks | "1" | Se este parâmetro estiver definido como Off, as informações de vazamento de memória não serão exibidas (em stdout ou logs). | PHP_INI_ALL |
| track_errors | "0" | Se habilitado, o último erro sempre existirá na variável $php_errormsg. | PHP_INI_ALL |
| erros_html | "1" | Feche as tags HTML nas mensagens de erro. | PHP_INI_ALLPHP_INI_SYSTEM em PHP <= 4.2.3. |
| xmlrpc_errors | "0" | Desativa o relatório de erros normal e formata os erros como mensagens de erro XML-RPC. | PHP_INI_SYSTEM |
| xmlrpc_error_number | "0" | Usado como o valor do elemento falhaCode XML-RPC. | PHP_INI_ALL |
| docref_root | "" | O novo formato de mensagem de erro inclui uma página de referência correspondente que descreve especificamente o erro ou descreve a função que causou o erro. Para fornecer páginas de manual, você pode baixar o manual do idioma correspondente no site oficial do PHP e definir a URL no ini para o endereço local correspondente. Se sua cópia local do manual estiver acessível usando "/manual/", você pode simplesmente definir docref_root=/manual/. Além disso, você também precisa definir docref_ext para corresponder ao sufixo do seu arquivo local docref_ext=.html. Claro, você também pode definir um endereço de referência externo. Por exemplo, você pode definir 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 " | PHP_INI_ALL |
| docref_ext | "" | Consulte docref_root. | PHP_INI_ALL |
| erro_prepend_string | NULO | A saída de conteúdo antes da mensagem de erro. | PHP_INI_ALL |
| erro_append_string | NULO | A saída do conteúdo após a mensagem de erro. | PHP_INI_ALL |
| log_erro | NULO | Define o arquivo no qual os erros de script serão registrados. O arquivo deve ser gravável pelo usuário do servidor web. | PHP_INI_ALL |
As funções Error e Logging fazem parte do núcleo do PHP. Nenhuma instalação é necessária para usar essas funções.
PHP : Indica a versão mais antiga do PHP que suporta esta função.
| função | descrever | PHP |
|---|---|---|
| debug_backtrace() | Gerar backtrace. | 4 |
| debug_print_backtrace() | Imprimir retrocesso. | 5 |
| erro_get_last() | Obtenha o último erro que ocorreu. | 5 |
| log_erro() | Envie um erro para o log de erros do servidor, arquivo ou destino remoto. | 4 |
| relatório_erro() | Especifica qual erro relatar. | 4 |
| restaurar_error_handler() | Restaure o manipulador de erros anterior. | 4 |
| restaurar_exception_handler() | Restaure o manipulador de exceções anterior. | 5 |
| set_error_handler() | Defina a função de tratamento de erros definida pelo usuário. | 4 |
| set_exception_handler() | Defina a função de tratamento de exceções definida pelo usuário. | 5 |
| erro_gatilho() | Crie mensagens de erro definidas pelo usuário. | 4 |
| erro_usuário() | Alias para trigger_error(). | 4 |
PHP : Indica a versão mais antiga do PHP que suporta esta constante.
| valor | constante | descrever | PHP |
|---|---|---|---|
| 1 | E_ERRO | Erro fatal em tempo de execução. Erros incorrigíveis. Pare de executar o script. | |
| 2 | E_WARNING | Erro de tempo de execução não fatal. A execução do script não é interrompida. | |
| 4 | E_PARSE | Erro de análise de tempo de compilação. Erros de análise só devem ser gerados pelo analisador. | |
| 8 | E_NOTICE | Notificações em tempo de execução. A descoberta de script pode ser um bug, mas também pode ocorrer durante a execução normal de um script. | |
| 16 | E_CORE_ERROR | Erro fatal na inicialização do PHP. Isto é exatamente como o E_ERROR do núcleo do PHP. | 4 |
| 32 | E_CORE_WARNING | Erro não fatal ao iniciar o PHP. Isto é exatamente como o E_WARNING do núcleo do PHP. | 4 |
| 64 | E_COMPILE_ERROR | Erro fatal em tempo de compilação. É exatamente como o E_ERROR gerado pelo mecanismo de script Zend. | 4 |
| 128 | E_COMPILE_WARNING | Erro não fatal em tempo de compilação. É como um E_WARNING gerado pelo mecanismo de script Zend. | 4 |
| 256 | E_USER_ERROR | Erro fatal gerado pelo usuário. É como o E_ERROR gerado pelo programador usando a função PHP trigger_error(). | 4 |
| 512 | E_USER_WARNING | Erro não fatal gerado pelo usuário. É como um E_WARNING gerado pelo programador usando a função PHP trigger_error(). | 4 |
| 1024 | E_USER_NOTICE | Notificações geradas pelo usuário. É como o E_NOTICE gerado pelo programador usando a função PHP trigger_error(). | 4 |
| 2048 | E_STRICT | Notificações em tempo de execução. O PHP recomenda que você faça alterações em seu código para melhorar a interoperabilidade e compatibilidade do código. | 5 |
| 4096 | E_RECOVERABLE_ERROR | Erros fatais detectáveis. Isto é como um E_ERROR que pode ser capturado por um identificador definido pelo usuário (veja set_error_handler()). | 5 |
| 6143 | E_TODOS | Todos os níveis de erro e aviso, exceto E_STRICT (desde o PHP 6.0, E_STRICT fará parte de E_ALL). | 5 |