error_reporting
設定錯誤訊息回報的等級。
語法: int error_reporting(int [level]);
傳回值: 整數
函式種類: PHP 系統功能
內容說明
本函式用來設定錯誤訊息回報的等級,參數 level 是一個整數的位元遮罩 (bitmask),見下表。
value constant
1 E_ERROR
2 E_WARNING
4 E_PARSE
8 E_NOTICE
16 E_CORE_ERROR
32 E_CORE_WARNING
64 E_COMPILE_ERROR
128 E_COMPILE_WARNING
256 E_USER_ERROR
512 E_USER_WARNING
1024 E_USER_NOTICE
2047 E_ALL
2048 E_STRICT
E_NOTICE 表示一般情形不記錄,只有程式有錯誤情形時才用到,例如企圖存取一個不存在的變數,或是呼叫 stat() 函式檢視不存在的檔案。
E_WARNING 通常都會顯示出來,但不會中斷程式的執行。這對除錯很有效。例如:用有問題的常規表示法呼叫 ereg()。
E_ERROR 通常會顯示出來,亦會中斷程式執行。意即用這個遮罩無法追查到記憶體配置或其它的錯誤。
E_PARSE 從語法中剖析錯誤。
E_CORE_ERROR 類似 E_ERROR,但不包括 PHP 核心造成的錯誤。
E_CORE_WARNING 類似 E_WARNING,但不包括 PHP 核心錯誤警告。
PHP 的錯誤報告
php.ini 文件中有許多配置設置。您應當已經設置好自己的 php.ini 文件並把它放在合適的目錄中,就像在 Linux 上安裝 PHP 和 Apache 2 的文檔說明中所示的那樣(請參閱 參考資料)。在調試 PHP 應用程序時,應當知道兩個配置變量。下面是這兩個變量及其默認值:
display_errors = Off
error_reporting = E_ALL
通過在 php.ini 文件中搜索它們,可以發現這兩個變量當前的默認值。display_errors 變量的目的很明顯 —— 它告訴 PHP 是否顯示錯誤。默認值是 Off。但是,要讓開發過程更加輕松,請把這個值設為 On:
display_errors = On
error_reporting 變量的默認值是 E_ALL。這個設置會顯示從不良編碼實踐到無害提示到出錯的所有信息。E_ALL 對於開發過程來說有點太細,因為它在屏幕上為一些小事(例如變量未初始化)也顯示提示,會搞糟浏覽器的輸出。我只想看到錯誤和不良編碼實踐,但是不想看到無害的提示。所以,請用以下值代替 error_reporting 的默認值:
error_reporting = E_ALL & ~E_NOTICE
重新啟動 Apache,就全部設置好了。接下來,將學習如何在 Apache 上做同樣的事。
服務器上的錯誤報告
依賴於 Apache 正在做的工作,在 PHP 中打開錯誤報告可能沒法工作,因為在計算機上可能有多個 PHP 版本。有時很難區分 Apache 正在使用哪個 PHP 版本,因為 Apache 只能查看一個 php.ini 文件。不知道 Apache 正在使用哪個 php.ini 文件配置自己是一個安全問題。但是,有一種方法可以在 Apache 中配置 PHP 變量,從而保證設置了正確的出錯級別。
而且,最好知道如何在服務器端設置這些配置變量,以否決或搶占 php.ini 文件,從而提供更高級別的安全性。
在配置 Apache 時,應該已經接觸過 <apache2-install-dir>/conf/httpd.conf 中 http.conf 文件中的基本配置。
要做在 php.ini 文件中已經做過的事,請把下列各行添加到 httpd.conf,覆蓋任何 php.ini 文件:
php_flag display_errors on
php_value error_reporting 2039
這會覆蓋在 php.ini 文件中為 display_errors 已經設置的標志,以及 error_reporting 的值。值 2039 代表 E_ALL & ~E_NOTICE。如果願意采用 E_ALL,請把值設為 2047。同樣,還是要重啟 Apache。
接下來,要在服務器上測試錯誤報告。