當前位置: 首頁> 最新文章列表> 使用mysqli_stmt::$error 與PSR日誌標準聯動

使用mysqli_stmt::$error 與PSR日誌標準聯動

gitbox 2025-05-28

在現代的PHP 開發中，錯誤追踪和日誌記錄是提高應用程序穩定性和性能的重要環節。尤其是在與數據庫交互時，準確記錄和追踪SQL 錯誤對於調試和維護至關重要。在這篇文章中，我們將介紹如何結合使用mysqli_stmt::$error函數與PSR 日誌標準，以實現更高效的錯誤追踪和記錄。

1. 什麼是mysqli_stmt::$error函數？

mysqli_stmt::$error是PHP 中mysqli擴展提供的一種獲取當前SQL 語句錯誤的方法。當我們執行SQL 查詢時，如果發生錯誤，可以通過此屬性獲取數據庫返回的錯誤信息。

舉個例子，假設我們在執行一個預處理語句（prepared statement）時遇到了錯誤：

 $mysqli = new mysqli("localhost", "user", "password", "database");
$stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
$stmt->bind_param("i", $userId);

if (!$stmt->execute()) {
    echo "Error: " . $stmt->error;
}

在這個例子中，如果SQL 查詢發生錯誤， $stmt->error將返回錯誤信息，幫助開發人員快速定位問題。

2. PSR 日誌標準概述

PSR（PHP Standard Recommendation）日誌標準是PHP 生態系統中用來統一日誌記錄的接口標準。 PSR-3 是PHP 日誌記錄的標準，它定義了一個日誌記錄接口，使得不同的日誌庫（如Monolog、Log4php 等）可以實現該接口，從而在代碼中使用統一的日誌記錄方式。

一個PSR-3 日誌接口的簡單使用方式如下：

 use Psr\Log\LoggerInterface;

class MyApp
{
    private $logger;

    public function __construct(LoggerInterface $logger)
    {
        $this->logger = $logger;
    }

    public function someMethod()
    {
        // 記錄日誌
        $this->logger->error('Something went wrong!');
    }
}

PSR-3 提供了debug() , info() , notice() , warning() , error() , critical() , alert() , 和emergency()等日誌級別方法，以幫助開發人員根據問題的嚴重性記錄不同類型的日誌信息。

3. 結合mysqli_stmt::$error與PSR 日誌標準

現在，我們將展示如何將mysqli_stmt::$error與PSR 日誌標準結合使用，從而在數據庫操作失敗時更有效地記錄錯誤信息。

3.1 安裝日誌庫

首先，我們需要安裝一個支持PSR-3 標準的日誌庫。這裡我們以Monolog 為例：

 composer require monolog/monolog

3.2 配置Logger

接下來，我們將配置Monolog Logger，並將其與PSR-3 接口集成：

 use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$logger = new Logger('my_logger');
$logger->pushHandler(new StreamHandler('path/to/your.log', Logger::ERROR));

3.3 結合mysqli_stmt::$error和Logger

現在，假設我們有一個與數據庫交互的函數，我們可以將mysqli_stmt::$error中的錯誤信息記錄到日誌中：

 function fetchData($mysqli, $userId, Logger $logger)
{
    $stmt = $mysqli->prepare("SELECT * FROM users WHERE id = ?");
    if (!$stmt) {
        $logger->error("SQL prepare failed: " . $mysqli->error);
        return false;
    }

    $stmt->bind_param("i", $userId);
    
    if (!$stmt->execute()) {
        $logger->error("SQL execution failed: " . $stmt->error);
        return false;
    }

    $result = $stmt->get_result();
    return $result->fetch_all(MYSQLI_ASSOC);
}

在這個示例中，當數據庫操作失敗時，錯誤信息將被記錄到指定的日誌文件中，並包含詳細的錯誤描述。這使得開發人員可以輕鬆地跟踪SQL 錯誤並進行排查。

3.4 自定義日誌信息

PSR-3 標準還允許我們在日誌中記錄上下文信息，以幫助更好地分析錯誤。例如，我們可以將用戶的ID 或其他有助於診斷的問題信息作為日誌的上下文參數：

 $logger->error('SQL execution failed', [
    'error' => $stmt->error,
    'user_id' => $userId,
    'query' => $stmt->sqlstate,
]);

這將記錄更豐富的錯誤信息，包括用戶ID 和SQL 錯誤代碼，幫助我們更精確地定位問題。

4. 結論

通過將mysqli_stmt::$error函數與PSR 日誌標準結合使用，我們能夠高效地記錄數據庫操作中的錯誤，並確保日誌的統一性和易用性。無論是開發環境還是生產環境，錯誤日誌都是我們快速定位和解決問題的重要工具。而PSR 日誌標準提供的靈活性和兼容性，使得我們能夠使用任何符合標準的日誌庫，而不必擔心具體的實現細節。

借助這樣的技術棧，我們可以實現更高效的錯誤追踪和記錄，從而提高應用程序的穩定性和開發效率。

相關內容