總結使用不同的方法記錄錯誤報告日誌
- WBOY原創
- 2021-11-01 17:30:513602瀏覽
在之前的文章中為大家帶來了《帶你一起了解PHP的錯誤類型和錯誤級別》，其中詳細介紹了PHP中的錯誤類型和錯誤級別，本篇文章我們一起來看看PHP中錯誤日誌的設定和使用方法。希望對大家有幫助！
在我們之前的文章中，我們介紹了PHP錯誤的異常處理、錯誤類型還有錯誤級別，接下來我們來介紹一下PHP中錯誤日誌的配置和使用方法。對於 PHP 開發者來說，一旦某個專案投入使用，應該立即將設定檔 php.ini 中的 display_errors 選項關閉，以免因為這些錯誤而透露路徑、資料庫連線、資料表等資訊。
再投入使用的任何一個專案中，不可避免的會有錯誤的出現，有些錯誤報告對開發者是有用的，這時候我們可以透過單獨的文字檔案來進行錯誤報告的日誌記錄。這樣的話，開發人員可以更輕鬆的進行來查看系統是否有問題。將PHP設定檔中的 log_errors 開啟的話，就可以將程式中的錯誤報告寫進錯誤日誌中了。
其中這份錯誤報告會自動記錄到伺服器的日誌檔案中，想要傳送到系統的syslog中，也就是系統日誌中，也是可以的。接下來我們就一起來看看怎麼去實現這樣錯誤處理的方法吧。
透過指定檔案記錄錯誤報告
#想要實作使用目標檔案來記錄錯誤報告日誌，其中很重要的是需要讓這個制定的文件的位置在文檔根目錄外面，這樣的話受到攻擊的可能性較低，而且這個指定文件需要擁有一定的權限，首先我們先來看一下我們需要針對php. ini的設定指令做出怎樣的修改：
<strong>#log_errors = On</strong>## ;決定日誌語句記錄的位置log_errors_max_len = 1024<strong></strong> ;設定每個日誌項目的最大長度error_reporting = E_ALL<strong> </strong>;將會向PHP報告發生的每個錯誤display_errors = Off<strong></strong>#;不顯示所有滿足上條指令所定義規則的錯誤報告#error_log = /usr/local/error.log<strong></strong> ;指定產生的錯誤報告寫入的日誌檔案位置
error_reporting定義的錯誤也可以透過 error_log() 函數將錯誤訊息放到伺服器中的錯誤日誌或這個目標檔案中。
error_log() 函數的語法格式如下：
error_log ( string $message [, int $message_type = 0 [, string $destination [, string $extra_headers ]]] ) : bool其中需要注意的是：
$message表示需要記錄的錯誤訊息；$destination表示目標，也就是錯誤訊息被傳送到的目的地。它的意義描述於以上，由 $message_type 參數決定；$extra_headers表示額外的頭。當 $message_type 設定為 1 的時候使用。此資訊類型使用了 mail() 的同一個內建函數。
$message_type表示設定錯誤應該要傳送到何處。可能的資訊類型有以下幾個：
0
：（預設值）將$message傳送到PHP 的系統日誌，使用作業系統的日誌機製或一個文件，取決於設定檔中error_log 設定了什麼；#1
：將$message傳送到參數$destination 設定的郵件地址。第四個參數$extra_headers 只有在這個型別裡才會被用到；（2已經被棄用了）3
：$message被送到位置為$destination 的檔案裡。字元$message 不會預設被當做新的一行；4
：將$message直接傳送到SAPI 的日誌處理程序中。
<?php
$link = mysqli_connect("127.0.0.1", "my_user", "my_password", "my_db");
if (!$link) {
error_log('Mysql 数据库连接失败！',0);
exit();
}
?>如果以登入Oracle資料庫出現問題的處理為例，函數的使用範例如下：<?php
if(!Ora_Logon($username, $password)){
error_log("Oracle数据库不可用!", 0); //将错误消息写入到操作系统日志中
}
if(!($foo=allocate_new_foo()){
error_log("不行!", 1, ". mydomain.com"); //发送到管理员邮箱中
}
error_log("不行!", 2, "localhost:5000"); //发送到本机对应5000端口的服务器中
error_log("不行!", 3, "/usr/local/errors.log"); //发送到指定的文件中
?>
代码运行之后就会在php.ini 配置文件中 error_log 一项所设置的目录中生成对应的错误日志文件。接下来我们看一下错误信息记录到操作系统的日志里是什么情况。
通过系统日志记录错误报告
上文中我们讲到了将使用目标文件来记录错误报告日志，接下来我们就来看一下将错误信息放到操作系统的日志里面，这是可以实现的，其中不同的操作系统，它们的日志管理也是不一样的，下面我们都是使用常见的windows举例，Windows 上错误将发送到事件日志里，可以通过事件查看器来查看。
通过什么样的方法才能够在操作系统的日志里有错误信息呢？这时候我们可以通过php.ini 配置文件中 error_log，接下来我们看一下应该怎样修改php.ini中的配置文件。
修改error_reporting = E_ALL用来报告所发生的每个错误；修改display_errors = Off 用来不显示满足上条指令所定义规则的所有错误报告；修改log_errors = On用于决定日志语句记录的位置；修改log_errors_max_len = 1024用于设置每个日志项的最大长度；修改error_log = syslog用于指定产生的错误报告写入操作系统的日志里 。
虽然通过前面介绍的 error_log() 函数，可以向 syslog 中发送定制的消息，想要实现将错误信息放到操作系统的日志里面，我们还需要三个函数的帮助，下面我们就来简单的介绍一下：
<strong>openlog()</strong>函数
该函数是用来打开连接的，用于向系统中写入日志信息做的准备。并且每个日志的消息中都有它的一个参数是字符串形式的。
<strong>syslog()</strong>函数
该函数拥有两个参数，它的作用是用来给系统中的日志给一个特定消息，第一个参数就是用来设置这个消息的优先级，第二个参数即使提供字符串，这个字符串就是这个特定的消息。
<strong>closelog()</strong>函数
该函数就是用来关闭连接的，这个连接就是上文中openlog() 函数打开的。
那么接下来我们通过示例来看一下实际操作吧，示例如下：
<?php
openlog("PHP中文网", LOG_PID, LOG_USER);
syslog(LOG_WARNING, "向 syslog 中发送定时消息，发送时间：".date("Y/m/d H:i:s"));
closelog();
?>以windows系统为例，打开“此电脑”右键选择“管理”选项，进入计算机管理界面，找到图示中应用程序的选项，就能够看到我们自己定制的警告信息了。如下所示：
其中我们需要注意的是：
你所使用的Web服务器环境决定了是使用指定文件还是使用syslog记录错误日志。可以控制服务器的话就可以利用解析工具来查看和分析日志，推荐使用syslog 激励错误日志，网站在共享服务器的虚拟主机中运行，推荐使用单独的文本文件记录错误日志了。
大家如果感兴趣的话，可以点击《PHP视频教程》进行更多关于PHP知识的学习。
以上是總結使用不同的方法記錄錯誤報告日誌的詳細內容。更多資訊請關注PHP中文網其他相關文章！