PHPError和Logging函數(shù)-7.5PHP參考手冊(cè)

PHP Error 簡(jiǎn)介

Error 和 Logging 函數(shù)允許您對(duì)錯(cuò)誤進(jìn)行處理和記錄。

創(chuàng)新互聯(lián)是專業(yè)的臨川網(wǎng)站建設(shè)公司，臨川接單;提供做網(wǎng)站、網(wǎng)站建設(shè),網(wǎng)頁(yè)設(shè)計(jì),網(wǎng)站設(shè)計(jì),建網(wǎng)站,PHP網(wǎng)站建設(shè)等專業(yè)做網(wǎng)站服務(wù);采用PHP框架,可快速的進(jìn)行臨川網(wǎng)站開(kāi)發(fā)網(wǎng)頁(yè)制作和功能擴(kuò)展;專業(yè)做搜索引擎喜愛(ài)的網(wǎng)站,專業(yè)的做網(wǎng)站團(tuán)隊(duì),希望更多企業(yè)前來(lái)合作!

Error 函數(shù)允許用戶定義錯(cuò)誤處理規(guī)則，并修改記錄錯(cuò)誤的方式。

Logging 函數(shù)允許用戶對(duì)應(yīng)用程序進(jìn)行日志記錄，并把日志消息發(fā)送到電子郵件、系統(tǒng)日志或其他的機(jī)器。

error 函數(shù)用于完成錯(cuò)誤處理和日志記錄。

error 函數(shù)允許我們定義自己的錯(cuò)誤處理規(guī)則，并修改錯(cuò)誤記錄方式。

logging 函數(shù)允許我們將消息直接發(fā)送到其他機(jī)器、電郵或系統(tǒng)日志。

error reporting 函數(shù)允許我們錯(cuò)誤的類型和層級(jí)。

安裝

PHP error 函數(shù)是 PHP 核心的一部分。無(wú)需安裝即可使用這些函數(shù)。

Runtime 配置

error 函數(shù)的行為受到 php.ini 中設(shè)置的影響。

Errors 和 logging 配置選項(xiàng)如下：

名稱 默認(rèn)值 描述 可修改范圍 error_reporting NULL 設(shè)置錯(cuò)誤報(bào)告級(jí)別（整數(shù)或命名常量） PHP_INI_ALL display_errors "1"

規(guī)定是否將錯(cuò)誤作為輸出輸出到屏幕，或者對(duì)用戶隱藏。

注意：該特性不應(yīng)在生產(chǎn)系統(tǒng)上使用（僅支持開(kāi)發(fā)）

PHP_INI_ALL display_startup_errors "0"

即使 display_errors 設(shè)置為開(kāi)啟, PHP 啟動(dòng)過(guò)程中的錯(cuò)誤信息也不會(huì)被顯示。

注釋：強(qiáng)烈建議除了調(diào)試目的以外，將 display_startup_errors 設(shè)置為關(guān)閉。

PHP_INI_ALL log_errors "0"

設(shè)置是否將腳本運(yùn)行的錯(cuò)誤信息記錄到服務(wù)器錯(cuò)誤日志或者 error_log 之中。

注釋：這是與服務(wù)器相關(guān)的特定配置項(xiàng)。

注釋：在生產(chǎn)系統(tǒng)中，強(qiáng)烈建議你使用錯(cuò)誤日志記錄web站點(diǎn)上顯示的錯(cuò)誤信息。

PHP_INI_ALL log_errors_max_len "1024"

設(shè)置 log_errors 的最大字節(jié)數(shù)。在 error_log 會(huì)添加有關(guān)錯(cuò)誤源的信息。

默認(rèn)值為 1024，如果設(shè)置為 0 表示不限長(zhǎng)度。

該長(zhǎng)度設(shè)置對(duì)記錄的錯(cuò)誤，顯示的錯(cuò)誤，以及 $php_errormsg 都會(huì)有限制作用。

PHP_INI_ALL ignore_repeated_errors "0"

規(guī)定是否記錄重復(fù)的錯(cuò)誤信息。

重復(fù)的錯(cuò)誤必須出現(xiàn)在同一個(gè)文件中的同一行代碼上，除非 ignore_repeated_source 設(shè)置為 true。

PHP_INI_ALL ignore_repeated_source "0"

規(guī)定是否記錄重復(fù)的錯(cuò)誤信息。忽略重復(fù)消息時(shí)，也忽略消息的來(lái)源。

當(dāng)該設(shè)置開(kāi)啟時(shí)，重復(fù)信息將不會(huì)記錄它是由不同的文件還是不同的源代碼行產(chǎn)生的。

PHP_INI_ALL report_memleaks "1" 如果該參數(shù)被設(shè)置為 On（默認(rèn)），則會(huì)顯示由 Zend 內(nèi)存管理器偵測(cè)到的內(nèi)存泄露報(bào)告。 PHP_INI_ALL track_errors "0" 如果開(kāi)啟，最后一個(gè)錯(cuò)誤將永遠(yuǎn)存在于變量 $php_errormsg 中。 PHP_INI_ALL html_errors "1" 在錯(cuò)誤信息中關(guān)閉 HTML 標(biāo)簽。 PHP_INI_ALL PHP_INI_SYSTEM in PHP <= 4.2.3. xmlrpc_errors "0" 如果啟用，則關(guān)閉正常的錯(cuò)誤報(bào)告，并將錯(cuò)誤的格式設(shè)置為 XML-RPC 錯(cuò)誤信息的格式。 PHP_INI_SYSTEM xmlrpc_error_number "0" 用作 XML-RPC faultCode 元素的值。 PHP_INI_ALL docref_root "" (available since PHP 4.3) PHP_INI_ALL docref_ext "" (available since PHP 4.3.2) PHP_INI_ALL error_prepend_string NULL 規(guī)定錯(cuò)誤信息之前輸出的字符串。 PHP_INI_ALL error_append_string NULL 規(guī)定錯(cuò)誤信息之后輸出的字符串。 PHP_INI_ALL error_log NULL

設(shè)置腳本錯(cuò)誤將被記錄到的文件。該文件必須是 web 服務(wù)器用戶可寫(xiě)的。

如果使用了特殊值 syslog，則將錯(cuò)誤信息發(fā)送到系統(tǒng)日志記錄器。

PHP_INI_ALL

PHP Error 和 Logging 函數(shù) 函數(shù) 描述 debug_backtrace() 生成 backtrace。 debug_print_backtrace() 打印 backtrace。 error_get_last() 返回最后發(fā)生的錯(cuò)誤。 error_log() 向服務(wù)器錯(cuò)誤記錄、文件或遠(yuǎn)程目標(biāo)發(fā)送錯(cuò)誤消息。 error_reporting() 規(guī)定報(bào)告哪個(gè)錯(cuò)誤。 restore_error_handler() 恢復(fù)之前的錯(cuò)誤處理程序。 restore_exception_handler() 恢復(fù)之前的異常處理程序。 set_error_handler() 設(shè)置用戶自定義的錯(cuò)誤處理函數(shù)。 set_exception_handler() 設(shè)置用戶自定義的異常處理函數(shù)。 trigger_error() 創(chuàng)建用戶級(jí)別的錯(cuò)誤消息。 user_error() trigger_error() 的別名。

PHP 5 預(yù)定義錯(cuò)誤和日志常量 值 常量 描述 1 E_ERROR 運(yùn)行時(shí)致命的錯(cuò)誤。不能修復(fù)的錯(cuò)誤。終止執(zhí)行腳本。 2 E_WARNING 運(yùn)行時(shí)非致命的錯(cuò)誤。不終止執(zhí)行腳本。 4 E_PARSE 編譯時(shí)語(yǔ)法解析錯(cuò)誤。解析錯(cuò)誤僅僅由分析器產(chǎn)生。 8 E_NOTICE 運(yùn)行時(shí)通知。表示腳本遇到可能會(huì)表現(xiàn)為錯(cuò)誤的情況，但是在可以正常運(yùn)行的腳本里面也可能會(huì)有類似的通知。 16 E_CORE_ERROR 在 PHP 初始化啟動(dòng)過(guò)程中發(fā)生的致命錯(cuò)誤。該錯(cuò)誤類似 E_ERROR，但是是由 PHP 引擎核心產(chǎn)生的。 32 E_CORE_WARNING PHP 初始化啟動(dòng)過(guò)程中發(fā)生的警告 (非致命錯(cuò)誤) 。類似 E_WARNING，但是是由 PHP 引擎核心產(chǎn)生的。 64 E_COMPILE_ERROR 致命編譯時(shí)錯(cuò)誤。類似 E_ERROR, 但是是由 Zend 腳本引擎產(chǎn)生的。 128 E_COMPILE_WARNING 編譯時(shí)警告 (非致命錯(cuò)誤)。類似 E_WARNING，但是是由 Zend 腳本引擎產(chǎn)生的。 256 E_USER_ERROR 用戶產(chǎn)生的錯(cuò)誤信息。類似 E_ERROR, 但是是由用戶自己在代碼中使用PHP函數(shù) trigger_error()來(lái)產(chǎn)生的。 512 E_USER_WARNING 用戶產(chǎn)生的警告信息。類似 E_WARNING, 但是是由用戶自己在代碼中使用 PHP 函數(shù) trigger_error() 來(lái)產(chǎn)生的。 1024 E_USER_NOTICE 用戶產(chǎn)生的通知信息。類似 E_NOTICE, 但是是由用戶自己在代碼中使用 PHP 函數(shù) trigger_error() 來(lái)產(chǎn)生的。 2048 E_STRICT 啟用 PHP 對(duì)代碼的修改建議，以確保代碼具有最佳的互操作性和向前兼容性。 4096 E_RECOVERABLE_ERROR 可被捕捉的致命錯(cuò)誤。它表示發(fā)生了一個(gè)可能非常危險(xiǎn)的錯(cuò)誤，但是還沒(méi)有導(dǎo)致 PHP 引擎處于不穩(wěn)定的狀態(tài)。 如果該錯(cuò)誤沒(méi)有被用戶自定義句柄捕獲 (參見(jiàn) set_error_handler())，將成為一個(gè) E_ERROR 從而腳本會(huì)終止運(yùn)行。 8192 E_DEPRECATED 運(yùn)行時(shí)通知。啟用后將會(huì)對(duì)在未來(lái)版本中可能無(wú)法正常工作的代碼給出警告。 16384 E_USER_DEPRECATED 用戶產(chǎn)生的警告信息。類似 E_DEPRECATED, 但是是由用戶自己在代碼中使用 PHP 函數(shù) trigger_error() 來(lái)產(chǎn)生的。 32767 E_ALL E_STRICT 除非的所有錯(cuò)誤和警告信息。