php error_log 函數的使用

我們來大致瞭解一下error_log()函數。我們看下手冊的解釋：

error_log
(PHP 3, PHP 4, PHP 5)

bool error_log ( string message [, int message_type [, string destination [, string extra_headers]]] )
發送一個錯誤資訊到Web伺服器的錯誤記錄檔，一個TCP的連接埠或者是一個檔案。

[separator]

我們看它的參數，第一個參數message是訊息內容，第二個參數type是訊息類型，第三個參數是目標檔案，第四個參數是其他的頭資訊。其實一般第四個參數都用不到，我們主要看前面三個參數，第二個參數是訊息類型，包括0, 1, 2, 3等四種類型，0是預設的類型。四個類型的作用：

0
資訊內容發送到PHP的系統日誌記錄，使用作業系統的自己的日誌記錄機制或一個檔案，整個取決於php.ini中的配置選項error_log的內容。這是預設選項。

1
把資訊內容發送到一個郵件地址，第三個參數就是一個郵件地址，第四個參數是一個頭資訊發送郵件的，第二個類型使用mail()函數來發送郵件

2
訊息通過PHP的調試伺服器，遠端寫入到某個PHP調試伺服器上，當然，PHP在編譯的時候--enable-debugger必須開啟，另外，整個類型只是針對PHP 3有效

3
訊息作為一個新行附加在一個目標檔案中

其實對於我們來說，日誌為了簡便起見，一般直接使用類型3就比較合適了，把記錄檔寫到自己需要的檔案中。

為了樣本error_log()函數的簡單使用，我們個例子說明。假設我們資料庫抽象類別使用PEAR::DB類，現在我想在程式中記錄我們的程式是否有執行錯誤。那麼我們使用error_log()來記錄我們那些SQL語句執行錯誤或者失敗了，至少我們的PEAR::DB類提供了 DB::isError() 方法來擷取某個執行結果對象是否有錯誤，那麼我們就能夠旁斷是否執行某條SQL出現了錯誤，再來考慮是否記錄日誌，同時對象有個userinfo的屬性，該屬性記錄了錯誤的SQL語句，那麼我們可以構造這樣一個函數：

function logError($object)
{
if(DB::isError($object))
{
error_log(date("[Y-m-d H:i:s]")." -[".$_SERVER['REQUEST_URI']."] :".$object -> userinfo."\n", 3, "/tmp/php_sql_err.log");
return true;
}
return false;
}

這個函數就是能夠記錄發現了錯誤SQL的地方，那麼自動會把時間，當前頁面，和錯誤的SQL語句資訊記錄到 /tmp/php_sql_err.log 檔案當中，那麼，當我們在偵錯工具的時候，探索資料提取不正確或者沒有資料提取的時候，那麼我們完全可以查看 /tmp/php_sql_err.log 檔案來查看我們的錯誤頁面和錯誤的SQL語句。

當然，我們必須在我們執行SQL查詢的程式中去使用這個函數，比如我們執行一個編寫一個提取新聞資訊的函數：

function getNewsContent($news_id, $field="")
{
global $db;
$result = $db->getRow("SELECT $field FROM news WHERE news_id = '$news_id'");
if (logError($result))
{
return false;
}
return $result;
}

我們在裡面判斷SQL是否錯誤，如果錯誤了則返回false，然後我們就可以查看日誌一下，看我們的函數運行是否如我們預期想象的一樣。
我們執行: tail /tmp/php_sql_err.log
能看到類似於這樣的資訊：

[2006-01-12 11:44:34] -[/news_list.php?news_id=1] :SELECT FROM news WHERE news_id = '1' [nativecode=1064 ** You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version fo
r the right syntax to use near 'FROM news WHERE news_id = '1']

大致是因為我們select的時候，沒有把需要提取的欄位名寫進去，那麼我們就可以檢查news_list.php檔案，減產 getNewsContent ()函數法向沒有傳遞$field參數進去，導致SQL執行錯誤。所以error_log()函數就協助檢查我們的SQL寫的是否正確，或者是參數沒有傳遞正確，這樣大大的減輕了開發負擔，想但於了對我們的程式進行了單元測試。

當然，你也可以利用error_log()函數做更多記錄錯誤記錄檔，方便PHP開發，這個全是由自己決定。

本次工作中使用它來記簡單的log日誌
<code>
$address = post('address');
$group_add = explode(',',$address);

$url ="/usr/local/apache/eyoung/tmp/maillog_".date("Y-m-d").".log";

foreach($group_add as $value)
{
/** {{{ modify by muzhaoyang -2006.12.13- 記log
* 已空格分隔資料,記錄的資料為寫文本時間 拉票人ID 選手ID 發信地址
*/
$logstr=date("H:i:s")." ".$uid." ".$star_uid." ".$value."\n";
error_log($logstr,3,$url);
//}}}
}

</code>