php error handling, php errors

In PHP, the default error handling is simple. An error message is sent to the browser with the file name, line number, and a message describing the error.

PHP error handling

Error handling is an important part when creating scripts and web applications. If your code lacks error detection coding, the program will look unprofessional and open the door to security risks.

This tutorial covers some of the most important error detection methods in PHP.

We will explain different error handling methods for you:

• Simple "die()" statement
• Custom errors and error triggers
• Bug Report

Basic error handling: use the die() function

The first example shows a simple script to open a text file:

<?php
$file=fopen("welcome.txt","r");
?>

If the file does not exist, you will get an error like this:

Warning: fopen(welcome.txt) [function.fopen]: failed to open stream:
No such file or directory in C:webfoldertest.php on line 2

To avoid users getting error messages like the one above, we check whether the file exists before accessing it:

<?php
if(!file_exists("welcome.txt"))
{
die("File not found");
}
else
{
$file=fopen("welcome.txt","r");
}
?>

Now, if the file does not exist, you will get an error message like this:

File not found

The above code is more efficient than the previous code because it uses a simple error handling mechanism to terminate the script after an error.

However, simply terminating the script is not always the appropriate approach. Let's examine alternative PHP functions for handling errors.

Create a custom error handler

Creating a custom error handler is very easy. We simply created a dedicated function that can be called when an error occurs in PHP.

The function must be able to handle at least two parameters (error level and error message), but can accept up to five parameters (optional: file, line-number and error context):

Grammar

error_function(error_level,error_message,error_file,error_line,error_context)

Error reporting level

These error reporting levels are different types of errors handled by user-defined error handlers:

現(xiàn)在，讓我們創(chuàng)建一個處理錯誤的函數(shù)：

function customError($errno, $errstr)
{
echo "<b>Error:</b> [$errno] $errstr<br>";
echo "Ending Script";
die();
}

上面的代碼是一個簡單的錯誤處理函數(shù)。當它被觸發(fā)時，它會取得錯誤級別和錯誤消息。然后它會輸出錯誤級別和消息，并終止腳本。

現(xiàn)在，我們已經(jīng)創(chuàng)建了一個錯誤處理函數(shù)，我們需要確定在何時觸發(fā)該函數(shù)。

設置錯誤處理程序

PHP 的默認錯誤處理程序是內(nèi)建的錯誤處理程序。我們打算把上面的函數(shù)改造為腳本運行期間的默認錯誤處理程序。

可以修改錯誤處理程序，使其僅應用到某些錯誤，這樣腳本就能以不同的方式來處理不同的錯誤。然而，在本例中，我們打算針對所有錯誤來使用我們自定義的錯誤處理程序：

set_error_handler("customError");

由于我們希望我們的自定義函數(shù)能處理所有錯誤，set_error_handler() 僅需要一個參數(shù)，可以添加第二個參數(shù)來規(guī)定錯誤級別。

實例

通過嘗試輸出不存在的變量，來測試這個錯誤處理程序：

Error: [$errno] $errstr";
}

//set error handler
set_error_handler("customError");

//trigger error
echo($test);
?>

以上代碼的輸出如下所示：

Error: [8] Undefined variable: test

觸發(fā)錯誤

在腳本中用戶輸入數(shù)據(jù)的位置，當用戶的輸入無效時觸發(fā)錯誤是很有用的。在 PHP 中，這個任務由 trigger_error() 函數(shù)完成。

實例

在本例中，如果 "test" 變量大于 "1"，就會發(fā)生錯誤：

<?php
$test=2;
if ($test>1)
{
trigger_error("Value must be 1 or below");
}
?>

以上代碼的輸出如下所示：

Notice: Value must be 1 or below
in C:webfoldertest.php on line 6

您可以在腳本中任何位置觸發(fā)錯誤，通過添加的第二個參數(shù)，您能夠規(guī)定所觸發(fā)的錯誤級別。

可能的錯誤類型：

• E_USER_ERROR - 致命的用戶生成的 run-time 錯誤。錯誤無法恢復。腳本執(zhí)行被中斷。
• E_USER_WARNING - 非致命的用戶生成的 run-time 警告。腳本執(zhí)行不被中斷。
• E_USER_NOTICE - 默認。用戶生成的 run-time 通知。在腳本發(fā)現(xiàn)可能有錯誤時發(fā)生，但也可能在腳本正常運行時發(fā)生。

在本例中，如果 "test" 變量大于 "1"，則發(fā)生 E_USER_WARNING 錯誤。如果發(fā)生了 E_USER_WARNING，我們將使用我們自定義的錯誤處理程序并結(jié)束腳本：

1)
{
trigger_error("Value must be 1 or below",E_USER_WARNING);
}
?>

以上代碼的輸出如下所示：

Error: [512] Value must be 1 or below
Ending Script

現(xiàn)在，我們已經(jīng)學習了如何創(chuàng)建自己的 error，以及如何觸發(fā)它們，接下來我們研究一下錯誤記錄。

錯誤記錄

在默認的情況下，根據(jù)在 php.ini 中的 error_log 配置，PHP 向服務器的記錄系統(tǒng)或文件發(fā)送錯誤記錄。通過使用 error_log() 函數(shù)，您可以向指定的文件或遠程目的地發(fā)送錯誤記錄。

通過電子郵件向您自己發(fā)送錯誤消息，是一種獲得指定錯誤的通知的好辦法。

通過 E-Mail 發(fā)送錯誤消息

在下面的例子中，如果特定的錯誤發(fā)生，我們將發(fā)送帶有錯誤消息的電子郵件，并結(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);
}
?>

以上代碼的輸出如下所示：

Error: [512] Value must be 1 or below
Webmaster has been notified

接收自以上代碼的郵件如下所示：

Error: [512] Value must be 1 or below

這個方法不適合所有的錯誤。常規(guī)錯誤應當通過使用默認的 PHP 記錄系統(tǒng)在服務器上進行記錄。

?

原文地址：http://www.manongjc.com/php/php_error.html

php相關閱讀資料：

• php 日期
• PHP包含文件
• php文件
• PHP 文件上傳
• php Cookies
• php Sessions
• php email
• php安全email
• php錯誤處理
• PHP異常處理
• php過濾器
• PHP 高級過濾器
• php json
• php 表單