error_reporting()
用於設置 PHP 的報錯級別並返回當前級別。(PHP 4, PHP 5)
函數能夠在運行時設置 error_reporting 指令。
PHP 有諸多錯誤級別,使用該函數可以設置在腳本運行時的級別。
如果沒有設置可選參數 level, error_reporting() 僅會返回當前的錯誤報告級別。
參數level
新的 error_reporting 級別。 可以是一個位掩碼也可以是一個已命名的常量。
建議使用已命名的常量,以確保兼容將來的版本。 由於錯誤級別的添加、整數取值范圍的增加,
較久的基於整數的錯誤級別不會總是和預期的表現一致。
level 可能的值:
值 常量 描述
1 1 E_ERROR 致命的運行錯誤。錯誤無法恢復,暫停執行腳本。 2 2 E_WARNING 運行時警告(非致命性錯誤)。非致命的運行錯誤,腳本執行不會停止。 3 4 E_PARSE 編譯時解析錯誤。解析錯誤只由分析器產生。 4 8 E_NOTICE 運行時提醒(這些經常是你代碼中的bug引起的,也可能是有意的行為造成的。)
5 16 E_CORE_ERROR PHP 啟動時初始化過程中的致命錯誤。 6 32 E_CORE_WARNING PHP啟動時初始化過程中的警告(非致命性錯)。
7 64 E_COMPILE_ERROR 編譯時致命性錯。這就像由Zend腳本引擎生成了一個E_ERROR。 8 128 E_COMPILE_WARNING 編譯時警告(非致性錯)。這就像由Zend腳本引擎生成了E_WARNING警告。
9 256 E_USER_ERROR 自定義錯誤消息。像用PHP函數trigger_error(程序員設置E_ERROR) 10 512 E_USER_WARNING 自定義警告消息。像用PHP函數trigger_error(程序員設的E_WARNING警告) 11 1024 E_USER_NOTICE 自定義的提醒消息。像由使用PHP函數trigger_error(程序員E_NOTICE集)
12 2048 E_STRICT 編碼標准化警告。允許PHP建議修改代碼以確保最佳的互操作性向前兼容性。 13 4096 E_RECOVERABLE_ERROR 開捕致命錯誤。像E_ERROR,但可以通過用戶定義的處理捕獲(又見set_error_handler()) 14 8191 E_ALL 所有的錯誤和警告(不包括 E_STRICT) (E_STRICT will be part of E_ALL as of PHP 6.0)
14 16384 E_USER_DEPRECATED
15 30719 E_ALL
15個正好對應二進制的15位。
需要注意的是, 上述表中的字段, 不是一成不變的, 不同的PHP版本, 值可能會不同, 詳細的請參考 php預定義常量
任意數目的以上選項都可以用“或”來連接(用 OR 或 |),這樣可以報告所有需要的各級別錯誤。
例如,下面的代碼關閉了用戶自定義的錯誤和警告,執行了某些操作,然后恢復到原始的報錯級別:
例:
1 <?php 2 error_reporting(0); //禁用錯誤報告 3 error_reporting(E_ERROR | E_WARNING | E_PARSE);//報告運行時錯誤 4 error_reporting(E_ALL); //報告所有錯誤 5 error_reporting(E_ALL ^ E_NOTICE); //除E_NOTICE報告所有錯誤,是在php.ini的默認設置 6 error_reporting(-1); //報告所有 PHP 錯誤 7 error_reporting(3); //不報E_NOTICE 8 error_reporting(11); //報告所有錯誤 9 ini_set('error_reporting', E_ALL); // 和 error_reporting(E_ALL); 一樣 10 error_reporting(E_ERROR | E_WARNING | E_PARSE | E_NOTICE);//表示php錯誤,警告,語法錯誤,提醒都返錯。 11 ?>
換算關系:
E_All: 十進制為30719,換成二進制為 111011111111111
E_NOTICE:十進制為8,換成二進制為 1000
~E_NOTICE:對E_NOTICE進行取反操作, 變成0111
E_ALL & ~E_NOTICE::E_ALL和 ~E_NOTICE進行與操作,變成111011111110111,化成十進制就是30711
可以看到E_ALL並不是顯示了所有的錯誤,第12位為0, 這一位的權重為2的11次方, 為2048,其實就是
E_STRICT
的值,所以E_ALL
是顯示除E_STRICT
的所有錯誤級別。
E_ALL & ~E_NOTICE
的二進制可以看出,從右至左,第4位和第12位為0,第4位的權重為2的3次方,為8,就是E_NOTICE
的值,所以是顯示除了E_STRICT
和E_NOTICE
的所有錯誤。
兩個例子:
一、如果想顯示:
E_WARNING
, E_NOTICE
和E_PARSE
級別的錯誤,寫法與步驟:
1:先寫二進制:
000000000000000
2:把對應的位置置為1
000000000001110
3:換算為10進制
2 ^ 1 + 2 ^ 2 + 2 ^ 3 = 14
二、error_reporting(2047) 換成 常量寫法
1:換算成二進制
000001111111111
2:找對應關系
USER_DEPRECATED |
0 |
DEPRECATED | 0 |
RECOVERABLE_ERROR | 0 |
STRICT | 0 |
USER_NOTICE | 0 |
USER_WARNING | 1 |
USER_ERROR | 1 |
COMPILE_WARNING | 1 |
COMPILE_ERROR | 1 |
CORE_WARNING | 1 |
CORE_ERROR | 1 |
NOTICE | 1 |
PARSE | 1 |
WARNING | 1 |
ERROR | 1 |
版本區別:
5.4.0 E_STRICT 成為 E_ALL 的一部分
5.3.0 引入 E_DEPRECATED 和 E_USER_DEPRECATED。
5.2.0 引入 E_RECOVERABLE_ERROR。
5.0.0 引入 E_STRICT (但不包括在 E_ALL 之內)。
原因:
如果設置為:E_ALL | E_STRICT,則表示記錄所有的錯誤信息,可能會導致網站出現一大堆的錯誤代碼;
但是對於程序員來說應該說是,可以把代碼優化到最優;一些非致命性錯誤雖然不影響程序的運行,
但是會使PHP的負擔加重,通常是增加了網站進程(例如IIS的應用程序池)的負擔。
其他的錯誤相關:
display_errors
錯誤回顯,一般常用語開發模式,但是很多應用在正式環境中也忘記了關閉此選項。錯誤回顯可以暴露出非常多的敏感信息,為攻擊者下一步攻擊提供便利。推薦關閉此選項。 一旦某個產品投入使用,那么第一件事就是應該將display_errors選項關閉,以免因為這些錯誤所透露的路徑、數據庫連接、數據表等信息而遭到黑客攻擊。
錯誤回顯,一般常用語開發模式,但是很多應用在正式環境中也忘記了關閉此選項。錯誤回顯可以暴露出非常多的敏感信息,為攻擊者下一步攻擊提供便利。推薦關閉此選項。 一旦某個產品投入使用,那么第一件事就是應該將display_errors選項關閉,以免因為這些錯誤所透露的路徑、數據庫連接、數據表等信息而遭到黑客攻擊。
On表示開啟狀態下,若出現錯誤,則報錯,出現錯誤提示。 Off 表示關閉狀態下,若出現錯誤,則提示:服務器錯誤。但是不會出現錯誤提示
log_errors
在正式環境下用這個就行了,把錯誤信息記錄在日志里。可以關閉錯誤回顯。 某個產品投入使用后,將PHP的log_errors開啟,默認是記錄到WEB服務器的日志文件里,比如Apache的error.log文件。 當然也可以記錄錯誤日志到指定的文件中。另外也可以設定error_log = syslog,使這些錯誤信息記錄到操作系統的日志里。
log_errors
在正式環境下用這個就行了,把錯誤信息記錄在日志里。可以關閉錯誤回顯。 某個產品投入使用后,將PHP的log_errors開啟,默認是記錄到WEB服務器的日志文件里,比如Apache的error.log文件。 當然也可以記錄錯誤日志到指定的文件中。另外也可以設定error_log = syslog,使這些錯誤信息記錄到操作系統的日志里。
1 # vim /etc/php.inidisplay_errors = Off 2 log_errors = On 3 error_log = /var/log/php-error.log
PHP.ini中display_errors = Off失效的解決
問題: PHP設置文件php.ini中明明已經設置display_errors = Off,但是在運行過程中,網頁上還是會出現錯誤信息。
解決: 經 查log_errors= On,據官方的說法,當這個log_errors設置為On,那么必須指定error_log文件,如果沒指定或者指定的文件沒有權限寫入,那么照樣會輸 出到正常的輸出渠道,那么也就使得display_errors 這個指定的Off失效,錯誤信息還是打印了 出來。於是將log_errors = Off,問題就解決了。