中文(繁體)
中文(繁體)
在日常的PHP 開發中，數據庫性能問題往往是最令人頭疼的，尤其是那些間歇性出現的超時問題，常常讓開發者難以快速定位。幸運的是，PHP 的mysqli擴展提供了一個強大的工具—— mysqli::debug ，它可以幫助我們記錄詳細的數據庫操作日誌，從而深入分析慢查詢或連接問題，快速找到性能瓶頸。
mysqli::debug是mysqli類中的一個方法，用於開啟調試日誌記錄。該方法將相關的MySQL 客戶端操作記錄到一個日誌文件中，有助於排查連接過程、SQL 執行過程中的異常或性能問題。
mysqli::debug(string $debug_options): bool
該方法通常在數據庫連接之前調用，並要求PHP 編譯時啟用了mysqlnd驅動，並且配置了允許調試。
要使用mysqli::debug ，你需要確保以下幾點：
PHP 使用的是mysqlnd 驅動<br> 你可以通過查看phpinfo()來確認
phpinfo();
搜索mysqlnd ，如果看到如下字樣，說明你已經啟用：
Client API library version => mysqlnd 8.x.x
修改php.ini 配置開啟調試
mysqlnd.debug = "/tmp/mysqlnd.log"
修改後，重啟PHP-FPM 或Apache 服務。
在你的PHP 腳本中，調用mysqli::debug() ，然後正常創建數據庫連接和執行查詢。例如：
<?php
// 啟用調試日誌記錄
mysqli::debug("d:t:o,/tmp/mysqlnd.log");
// 數據庫連接
$mysqli = new mysqli("localhost", "db_user", "db_pass", "db_name");
if ($mysqli->connect_errno) {
echo "連接失敗: " . $mysqli->connect_error;
exit();
}
// 執行查詢
$result = $mysqli->query("SELECT * FROM users WHERE status = 'active'");
while ($row = $result->fetch_assoc()) {
echo $row['username'] . "<br>";
}
$mysqli->close();
?>
其中：
d啟用調試
t添加時間戳
o,/tmp/mysqlnd.log指定輸出文件
調試日誌會輸出到你指定的位置（如/tmp/mysqlnd.log ），你可以用less 、 tail或任何文本編輯器查看內容。
tail -f /tmp/mysqlnd.log
常見的分析點包括：
連接建立是否耗時
查詢語句是否反复執行
查詢是否有緩存命中
慢查詢花費時間
配合SQL 語句的EXPLAIN 分析，你可以更準確地判斷是否需要優化索引或避免全表掃描。
雖然mysqli::debug提供了豐富的客戶端信息，但更深層次的慢查詢分析還需要開啟MySQL 自身的慢查詢日誌：
SET GLOBAL slow_query_log = 'ON';
SET GLOBAL long_query_time = 1;
慢查詢日誌配合mysqli::debug的客戶端日誌，可以從兩端協同分析，快速定位瓶頸。
出於性能和安全考慮，調試應在開發或測試環境中使用，調試完記得關閉：
mysqli::debug(""); // 清空調試參數等於關閉
通過mysqli::debug ，我們可以精準記錄和分析PHP 腳本與MySQL 交互的過程，對於處理數據庫連接問題、間歇性超時、慢查詢分析具有重要價值。在開發階段善用此工具，可以大大減少上線後“踩雷”的概率。
