php 錯(cuò)誤處理經(jīng)驗(yàn)分享
更新時(shí)間：2011年10月11日 22:24:19 作者：
在創(chuàng)建腳本和 web 應(yīng)用程序時(shí)，錯(cuò)誤處理是一個(gè)重要的部分。如果您的代碼缺少錯(cuò)誤檢測編碼，那么程序看上去很不專業(yè)，也為安全風(fēng)險(xiǎn)敞開了大門
本教程介紹了 PHP 中一些最為重要的錯(cuò)誤檢測方法。
我們將為您講解不同的錯(cuò)誤處理方法：
簡單的 "die()" 語句
自定義錯(cuò)誤和錯(cuò)誤觸發(fā)器
錯(cuò)誤報(bào)告
基本的錯(cuò)誤處理：使用 die() 函數(shù)
第一個(gè)例子展示了一個(gè)打開文本文件的簡單腳本：
<?php
$file=fopen("welcome.txt","r");
?>
如果文件不存在，您會(huì)獲得類似這樣的錯(cuò)誤：
Warning: fopen(welcome.txt) [function.fopen]: failed to open stream:
No such file or directory in C:\webfolder\test.php on line 2為了避免用戶獲得類似上面的錯(cuò)誤消息，我們?cè)谠L問文件之前檢測該文件是否存在：
<?php
if(!file_exists("welcome.txt"))
{
die("File not found");
}
else
{
$file=fopen("welcome.txt","r");
}
?>
現(xiàn)在，假如文件不存在，您會(huì)得到類似這樣的錯(cuò)誤消息：
File not found比起之前的代碼，上面的代碼更有效，這是由于它采用了一個(gè)簡單的錯(cuò)誤處理機(jī)制在錯(cuò)誤之后終止了腳本。
不過，簡單地終止腳本并不總是恰當(dāng)?shù)姆绞?。讓我們研究一下用于處理錯(cuò)誤的備選的 PHP 函數(shù)。
創(chuàng)建自定義錯(cuò)誤處理器
創(chuàng)建一個(gè)自定義的錯(cuò)誤處理器非常簡單。我們很簡單地創(chuàng)建了一個(gè)專用函數(shù)，可以在 PHP 中發(fā)生錯(cuò)誤時(shí)調(diào)用該函數(shù)。
該函數(shù)必須有能力處理至少兩個(gè)參數(shù) (error level 和 error message)，但是可以接受最多五個(gè)參數(shù)（可選的：file, line-number 以及 error context）：
語法
error_function(error_level,error_message,
error_file,error_line,error_context)
現(xiàn)在，讓我們創(chuàng)建一個(gè)處理錯(cuò)誤的函數(shù)：
function customError($errno, $errstr)
{
echo "<b>Error:</b> [$errno] $errstr<br />";
echo "Ending Script";
die();
}
上面的代碼是一個(gè)簡單的錯(cuò)誤處理函數(shù)。當(dāng)它被觸發(fā)時(shí)，它會(huì)取得錯(cuò)誤級(jí)別和錯(cuò)誤消息。然后它會(huì)輸出錯(cuò)誤級(jí)別和消息，并終止腳本。
現(xiàn)在，我們已經(jīng)創(chuàng)建了一個(gè)錯(cuò)誤處理函數(shù)，我們需要確定在何時(shí)觸發(fā)該函數(shù)。
Set Error Handler
PHP 的默認(rèn)錯(cuò)誤處理程序是內(nèi)建的錯(cuò)誤處理程序。我們打算把上面的函數(shù)改造為腳本運(yùn)行期間的默認(rèn)錯(cuò)誤處理程序。
可以修改錯(cuò)誤處理程序，使其僅應(yīng)用到某些錯(cuò)誤，這樣腳本就可以不同的方式來處理不同的錯(cuò)誤。不過，在本例中，我們打算針對(duì)所有錯(cuò)誤來使用我們的自定義錯(cuò)誤處理程序：
set_error_handler("customError");由于我們希望我們的自定義函數(shù)來處理所有錯(cuò)誤，set_error_handler() 僅需要一個(gè)參數(shù)，可以添加第二個(gè)參數(shù)來規(guī)定錯(cuò)誤級(jí)別。
實(shí)例
通過嘗試輸出不存在的變量，來測試這個(gè)錯(cuò)誤處理程序：
<?php
//error handler function
function customError($errno, $errstr)
{
echo "<b>Error:</b> [$errno] $errstr";
}
//set error handler
set_error_handler("customError");
//trigger error
echo($test);
?>
以上代碼的輸出應(yīng)該類似這樣：
Error: [8] Undefined variable: test觸發(fā)錯(cuò)誤
在腳本中用戶輸入數(shù)據(jù)的位置，當(dāng)用戶的輸入無效時(shí)觸發(fā)錯(cuò)誤的很有用的。在 PHP 中，這個(gè)任務(wù)由 trigger_error() 完成。
例子
在本例中，如果 "test" 變量大于 "1"，就會(huì)發(fā)生錯(cuò)誤：
<?php
$test=2;
if ($test>1)
{
trigger_error("Value must be 1 or below");
}
?>
以上代碼的輸出應(yīng)該類似這樣：
Notice: Value must be 1 or below
in C:\webfolder\test.php on line 6您可以在腳本中任何位置觸發(fā)錯(cuò)誤，通過添加的第二個(gè)參數(shù)，您能夠規(guī)定所觸發(fā)的錯(cuò)誤級(jí)別。
可能的錯(cuò)誤類型：
E_USER_ERROR - 致命的用戶生成的 run-time 錯(cuò)誤。錯(cuò)誤無法恢復(fù)。腳本執(zhí)行被中斷。
E_USER_WARNING - 非致命的用戶生成的 run-time 警告。腳本執(zhí)行不被中斷。
E_USER_NOTICE - 默認(rèn)。用戶生成的 run-time 通知。腳本發(fā)現(xiàn)了可能的錯(cuò)誤，也有可能在腳本運(yùn)行正常時(shí)發(fā)生。
例子
在本例中，如果 "test" 變量大于 "1"，則發(fā)生 E_USER_WARNING 錯(cuò)誤。如果發(fā)生了 E_USER_WARNING，我們將使用我們的自定義錯(cuò)誤處理程序并結(jié)束腳本：
<?php
//error handler function
function customError($errno, $errstr)
{
echo "<b>Error:</b> [$errno] $errstr<br />";
echo "Ending Script";
die();
}
//set error handler
set_error_handler("customError",E_USER_WARNING);
//trigger error
$test=2;
if ($test>1)
{
trigger_error("Value must be 1 or below",E_USER_WARNING);
}
?>
以上代碼的輸出應(yīng)該類似這樣：
Error: [512] Value must be 1 or below
Ending Script現(xiàn)在，我們已經(jīng)學(xué)習(xí)了如何創(chuàng)建自己的 error，以及如何處罰它們，現(xiàn)在我們研究一下錯(cuò)誤記錄。
錯(cuò)誤記錄
默認(rèn)地，根據(jù)在 php.ini 中的 error_log 配置，PHP 向服務(wù)器的錯(cuò)誤記錄系統(tǒng)或文件發(fā)送錯(cuò)誤記錄。通過使用 error_log() 函數(shù)，您可以向指定的文件或遠(yuǎn)程目的地發(fā)送錯(cuò)誤記錄。
通過電子郵件向您自己發(fā)送錯(cuò)誤消息，是一種獲得指定錯(cuò)誤的通知的好辦法。
通過 E-Mail 發(fā)送錯(cuò)誤消息
在下面的例子中，如果特定的錯(cuò)誤發(fā)生，我們將發(fā)送帶有錯(cuò)誤消息的電子郵件，并結(jié)束腳本：
<?php
//error handler function
function customError($errno, $errstr)
{
echo "<b>Error:</b> [$errno] $errstr<br />";
echo "Webmaster has been notified";
error_log("Error: [$errno] $errstr",1,
"someone@example.com","From: webmaster@example.com");
}
//set error handler
set_error_handler("customError",E_USER_WARNING);
//trigger error
$test=2;
if ($test>1)
{
trigger_error("Value must be 1 or below",E_USER_WARNING);
}
?>
以上代碼的輸出應(yīng)該類似這樣：
Error: [512] Value must be 1 or below
Webmaster has been notified接收自以上代碼的郵件類似這樣：
Error: [512] Value must be 1 or below這個(gè)方法不適合所有的錯(cuò)誤。常規(guī)錯(cuò)誤應(yīng)當(dāng)通過使用默認(rèn)的 PHP 記錄系統(tǒng)在服務(wù)器上進(jìn)行記錄。
錯(cuò)誤回溯
定義和用法
PHP debug_backtrace() 函數(shù)生成一個(gè) backtrace。
該函數(shù)返回一個(gè)關(guān)聯(lián)數(shù)組。下面是可能返回的元素：
語法
debug_backtrace()例子
<?php
function one($str1, $str2)
{
two("Glenn", "Quagmire");
}
function two($str1, $str2)
{
three("Cleveland", "Brown");
}
function three($str1, $str2)
{
print_r(debug_backtrace());
}
one("Peter", "Griffin");
?>
輸出：
Array
(
[0] => Array
(
[file] => C:\webfolder\test.php
[line] => 7
[function] => three
[args] => Array
(
[0] => Cleveland
[1] => Brown
)
)
[1] => Array
(
[file] => C:\webfolder\test.php
[line] => 3
[function] => two
[args] => Array
(
[0] => Glenn
[1] => Quagmire
)
)
[2] => Array
(
[file] => C:\webfolder\test.php
[line] => 14
[function] => one
[args] => Array
(
[0] => Peter
[1] => Griffin
)
)
)
我們將為您講解不同的錯(cuò)誤處理方法：
簡單的 "die()" 語句
自定義錯(cuò)誤和錯(cuò)誤觸發(fā)器
錯(cuò)誤報(bào)告
基本的錯(cuò)誤處理：使用 die() 函數(shù)
第一個(gè)例子展示了一個(gè)打開文本文件的簡單腳本：
復(fù)制代碼 代碼如下:
<?php
$file=fopen("welcome.txt","r");
?>
如果文件不存在，您會(huì)獲得類似這樣的錯(cuò)誤：
Warning: fopen(welcome.txt) [function.fopen]: failed to open stream:
No such file or directory in C:\webfolder\test.php on line 2為了避免用戶獲得類似上面的錯(cuò)誤消息，我們?cè)谠L問文件之前檢測該文件是否存在：
復(fù)制代碼 代碼如下:
<?php
if(!file_exists("welcome.txt"))
{
die("File not found");
}
else
{
$file=fopen("welcome.txt","r");
}
?>
現(xiàn)在，假如文件不存在，您會(huì)得到類似這樣的錯(cuò)誤消息：
File not found比起之前的代碼，上面的代碼更有效，這是由于它采用了一個(gè)簡單的錯(cuò)誤處理機(jī)制在錯(cuò)誤之后終止了腳本。
不過，簡單地終止腳本并不總是恰當(dāng)?shù)姆绞?。讓我們研究一下用于處理錯(cuò)誤的備選的 PHP 函數(shù)。
創(chuàng)建自定義錯(cuò)誤處理器
創(chuàng)建一個(gè)自定義的錯(cuò)誤處理器非常簡單。我們很簡單地創(chuàng)建了一個(gè)專用函數(shù)，可以在 PHP 中發(fā)生錯(cuò)誤時(shí)調(diào)用該函數(shù)。
該函數(shù)必須有能力處理至少兩個(gè)參數(shù) (error level 和 error message)，但是可以接受最多五個(gè)參數(shù)（可選的：file, line-number 以及 error context）：
語法
error_function(error_level,error_message,
error_file,error_line,error_context)
| 參數(shù) | 描述 |
|---|---|
| error_level |
必需。為用戶定義的錯(cuò)誤規(guī)定錯(cuò)誤報(bào)告級(jí)別。必須是一個(gè)值數(shù)。 參見下面的表格：錯(cuò)誤報(bào)告級(jí)別。 |
| error_message | 必需。為用戶定義的錯(cuò)誤規(guī)定錯(cuò)誤消息。 |
| error_file | 可選。規(guī)定錯(cuò)誤在其中發(fā)生的文件名。 |
| error_line | 可選。規(guī)定錯(cuò)誤發(fā)生的行號(hào)。 |
| error_context | 可選。規(guī)定一個(gè)數(shù)組，包含了當(dāng)錯(cuò)誤發(fā)生時(shí)在用的每個(gè)變量以及它們的值。 |
錯(cuò)誤報(bào)告級(jí)別
這些錯(cuò)誤報(bào)告級(jí)別是錯(cuò)誤處理程序旨在處理的錯(cuò)誤的不同的類型：
| 值 | 常量 | 描述 |
|---|---|---|
| 2 | E_WARNING | 非致命的 run-time 錯(cuò)誤。不暫停腳本執(zhí)行。 |
| 8 | E_NOTICE |
Run-time 通知。 腳本發(fā)現(xiàn)可能有錯(cuò)誤發(fā)生，但也可能在腳本正常運(yùn)行時(shí)發(fā)生。 |
| 256 | E_USER_ERROR | 致命的用戶生成的錯(cuò)誤。這類似于程序員使用 PHP 函數(shù) trigger_error() 設(shè)置的 E_ERROR。 |
| 512 | E_USER_WARNING | 非致命的用戶生成的警告。這類似于程序員使用 PHP 函數(shù) trigger_error() 設(shè)置的 E_WARNING。 |
| 1024 | E_USER_NOTICE | 用戶生成的通知。這類似于程序員使用 PHP 函數(shù) trigger_error() 設(shè)置的 E_NOTICE。 |
| 4096 | E_RECOVERABLE_ERROR | 可捕獲的致命錯(cuò)誤。類似 E_ERROR，但可被用戶定義的處理程序捕獲。(參見 set_error_handler()) |
| 8191 | E_ALL |
所有錯(cuò)誤和警告，除級(jí)別 E_STRICT 以外。 （在 PHP 6.0，E_STRICT 是 E_ALL 的一部分） |
復(fù)制代碼 代碼如下:
function customError($errno, $errstr)
{
echo "<b>Error:</b> [$errno] $errstr<br />";
echo "Ending Script";
die();
}
上面的代碼是一個(gè)簡單的錯(cuò)誤處理函數(shù)。當(dāng)它被觸發(fā)時(shí)，它會(huì)取得錯(cuò)誤級(jí)別和錯(cuò)誤消息。然后它會(huì)輸出錯(cuò)誤級(jí)別和消息，并終止腳本。
現(xiàn)在，我們已經(jīng)創(chuàng)建了一個(gè)錯(cuò)誤處理函數(shù)，我們需要確定在何時(shí)觸發(fā)該函數(shù)。
Set Error Handler
PHP 的默認(rèn)錯(cuò)誤處理程序是內(nèi)建的錯(cuò)誤處理程序。我們打算把上面的函數(shù)改造為腳本運(yùn)行期間的默認(rèn)錯(cuò)誤處理程序。
可以修改錯(cuò)誤處理程序，使其僅應(yīng)用到某些錯(cuò)誤，這樣腳本就可以不同的方式來處理不同的錯(cuò)誤。不過，在本例中，我們打算針對(duì)所有錯(cuò)誤來使用我們的自定義錯(cuò)誤處理程序：
set_error_handler("customError");由于我們希望我們的自定義函數(shù)來處理所有錯(cuò)誤，set_error_handler() 僅需要一個(gè)參數(shù)，可以添加第二個(gè)參數(shù)來規(guī)定錯(cuò)誤級(jí)別。
實(shí)例
通過嘗試輸出不存在的變量，來測試這個(gè)錯(cuò)誤處理程序：
復(fù)制代碼 代碼如下:
<?php
//error handler function
function customError($errno, $errstr)
{
echo "<b>Error:</b> [$errno] $errstr";
}
//set error handler
set_error_handler("customError");
//trigger error
echo($test);
?>
以上代碼的輸出應(yīng)該類似這樣：
Error: [8] Undefined variable: test觸發(fā)錯(cuò)誤
在腳本中用戶輸入數(shù)據(jù)的位置，當(dāng)用戶的輸入無效時(shí)觸發(fā)錯(cuò)誤的很有用的。在 PHP 中，這個(gè)任務(wù)由 trigger_error() 完成。
例子
在本例中，如果 "test" 變量大于 "1"，就會(huì)發(fā)生錯(cuò)誤：
復(fù)制代碼 代碼如下:
<?php
$test=2;
if ($test>1)
{
trigger_error("Value must be 1 or below");
}
?>
以上代碼的輸出應(yīng)該類似這樣：
Notice: Value must be 1 or below
in C:\webfolder\test.php on line 6您可以在腳本中任何位置觸發(fā)錯(cuò)誤，通過添加的第二個(gè)參數(shù)，您能夠規(guī)定所觸發(fā)的錯(cuò)誤級(jí)別。
可能的錯(cuò)誤類型：
E_USER_ERROR - 致命的用戶生成的 run-time 錯(cuò)誤。錯(cuò)誤無法恢復(fù)。腳本執(zhí)行被中斷。
E_USER_WARNING - 非致命的用戶生成的 run-time 警告。腳本執(zhí)行不被中斷。
E_USER_NOTICE - 默認(rèn)。用戶生成的 run-time 通知。腳本發(fā)現(xiàn)了可能的錯(cuò)誤，也有可能在腳本運(yùn)行正常時(shí)發(fā)生。
例子
在本例中，如果 "test" 變量大于 "1"，則發(fā)生 E_USER_WARNING 錯(cuò)誤。如果發(fā)生了 E_USER_WARNING，我們將使用我們的自定義錯(cuò)誤處理程序并結(jié)束腳本：
復(fù)制代碼 代碼如下:
<?php
//error handler function
function customError($errno, $errstr)
{
echo "<b>Error:</b> [$errno] $errstr<br />";
echo "Ending Script";
die();
}
//set error handler
set_error_handler("customError",E_USER_WARNING);
//trigger error
$test=2;
if ($test>1)
{
trigger_error("Value must be 1 or below",E_USER_WARNING);
}
?>
以上代碼的輸出應(yīng)該類似這樣：
Error: [512] Value must be 1 or below
Ending Script現(xiàn)在，我們已經(jīng)學(xué)習(xí)了如何創(chuàng)建自己的 error，以及如何處罰它們，現(xiàn)在我們研究一下錯(cuò)誤記錄。
錯(cuò)誤記錄
默認(rèn)地，根據(jù)在 php.ini 中的 error_log 配置，PHP 向服務(wù)器的錯(cuò)誤記錄系統(tǒng)或文件發(fā)送錯(cuò)誤記錄。通過使用 error_log() 函數(shù)，您可以向指定的文件或遠(yuǎn)程目的地發(fā)送錯(cuò)誤記錄。
通過電子郵件向您自己發(fā)送錯(cuò)誤消息，是一種獲得指定錯(cuò)誤的通知的好辦法。
通過 E-Mail 發(fā)送錯(cuò)誤消息
在下面的例子中，如果特定的錯(cuò)誤發(fā)生，我們將發(fā)送帶有錯(cuò)誤消息的電子郵件，并結(jié)束腳本：
復(fù)制代碼 代碼如下:
<?php
//error handler function
function customError($errno, $errstr)
{
echo "<b>Error:</b> [$errno] $errstr<br />";
echo "Webmaster has been notified";
error_log("Error: [$errno] $errstr",1,
"someone@example.com","From: webmaster@example.com");
}
//set error handler
set_error_handler("customError",E_USER_WARNING);
//trigger error
$test=2;
if ($test>1)
{
trigger_error("Value must be 1 or below",E_USER_WARNING);
}
?>
以上代碼的輸出應(yīng)該類似這樣：
Error: [512] Value must be 1 or below
Webmaster has been notified接收自以上代碼的郵件類似這樣：
Error: [512] Value must be 1 or below這個(gè)方法不適合所有的錯(cuò)誤。常規(guī)錯(cuò)誤應(yīng)當(dāng)通過使用默認(rèn)的 PHP 記錄系統(tǒng)在服務(wù)器上進(jìn)行記錄。
錯(cuò)誤回溯
定義和用法
PHP debug_backtrace() 函數(shù)生成一個(gè) backtrace。
該函數(shù)返回一個(gè)關(guān)聯(lián)數(shù)組。下面是可能返回的元素：
| 名稱 | 類型 | 描述 |
|---|---|---|
| function | 字符串 | 當(dāng)前的函數(shù)名。 |
| line | 整數(shù) | 當(dāng)前的行號(hào)。 |
| file | 字符串 | 當(dāng)前的文件名。 |
| class | 字符串 | 當(dāng)前的類名 |
| object | 對(duì)象 | 當(dāng)前對(duì)象。 |
| type | 字符串 | 當(dāng)前的調(diào)用類型，可能的調(diào)用：
|
| args | 數(shù)組 | 如果在函數(shù)中，列出函數(shù)參數(shù)。如果在被引用的文件中，列出被引用的文件名。 |
debug_backtrace()例子
復(fù)制代碼 代碼如下:
<?php
function one($str1, $str2)
{
two("Glenn", "Quagmire");
}
function two($str1, $str2)
{
three("Cleveland", "Brown");
}
function three($str1, $str2)
{
print_r(debug_backtrace());
}
one("Peter", "Griffin");
?>
輸出：
Array
(
[0] => Array
(
[file] => C:\webfolder\test.php
[line] => 7
[function] => three
[args] => Array
(
[0] => Cleveland
[1] => Brown
)
)
[1] => Array
(
[file] => C:\webfolder\test.php
[line] => 3
[function] => two
[args] => Array
(
[0] => Glenn
[1] => Quagmire
)
)
[2] => Array
(
[file] => C:\webfolder\test.php
[line] => 14
[function] => one
[args] => Array
(
[0] => Peter
[1] => Griffin
)
)
)
相關(guān)文章
這篇文章主要分享下php中生成隨機(jī)密碼的方法，原理就是把一些要生成的字符預(yù)置一個(gè)的字符串包括數(shù)字拼音之類的以及一些特殊字符,這樣我們?cè)匐S機(jī)取字符組成我們想要的隨機(jī)密碼了2013-10-10
php實(shí)現(xiàn)壓縮合并js的方法【附demo源碼下載】
這篇文章主要介紹了php實(shí)現(xiàn)壓縮合并js的方法,涉及php壓縮文件類JSMin的相關(guān)調(diào)用與使用技巧,并附帶了完整的demo源碼供讀者下載參考,需要的朋友可以參考下2016-09-09
一些php網(wǎng)站管理程序的，一些后門，其實(shí)官方也沒有惡意，主要是大家為了自己的安全。2009-08-08
這篇文章主要介紹了使用PHP創(chuàng)建文件夾、刪除文件夾、復(fù)制文件夾和文件，感興趣的小伙伴們可以參考一下2016-05-05
php調(diào)用云片網(wǎng)接口發(fā)送短信的實(shí)現(xiàn)方法
這篇文章主要介紹了php調(diào)用云片網(wǎng)接口發(fā)送短信的實(shí)現(xiàn)方法的相關(guān)資料,希望通過本文能幫助到大家，讓大家實(shí)現(xiàn)這樣的功能，需要的朋友可以參考下2017-10-10
這篇文章主要介紹了PHP獲取文件夾內(nèi)文件數(shù)的方法,涉及php操作文件夾及文件的技巧,具有一定參考借鑒價(jià)值,需要的朋友可以參考下2015-03-03
這篇文章主要介紹了php繼承中方法重載（覆蓋）的應(yīng)用場合,以實(shí)例形式較為詳細(xì)的分析了重載的用法與對(duì)應(yīng)的適用情況及使用技巧,需要的朋友可以參考下2015-02-02
php對(duì)大文件進(jìn)行讀取操作的實(shí)現(xiàn)代碼
在php中，對(duì)于文件的讀取時(shí)，最快捷的方式莫過于使用一些諸如file、file_get_contents之類的函數(shù)，簡簡單單的幾行代碼就能很漂亮的完成我們所需要的功能。但當(dāng)所操作的文件是一個(gè)比較大的文件時(shí)，這些函數(shù)可能就顯的力不從心, 下面將從一個(gè)需求入手來說明對(duì)于讀取大文件時(shí)，常用的操作方法2013-01-01
用PHP生成視頻的縮略圖,在網(wǎng)上比較一致的方法就是通過ffmpeg來做的,下面這篇文章主要給大家介紹了關(guān)于php如何利用ffmpeg獲取視頻第一幀為縮略圖的相關(guān)資料,需要的朋友可以參考下2022-03-03
php實(shí)現(xiàn)推薦功能的簡單實(shí)例
在本篇文章里小編給各位整理的是關(guān)于php如何實(shí)現(xiàn)推薦功能的相關(guān)實(shí)例內(nèi)容，有興趣的朋友們可以學(xué)習(xí)下。2019-09-09