使用獨白登錄：從Devtools到Slack

Monolog：一款強大的PHP日誌庫，助您提升應用開發和維護效率

日誌記錄是應用開發和維護週期中不可或缺的一部分，不僅取決於記錄的數據，更取決於記錄的方式。本文將深入探討Monolog包，展示其如何幫助您充分利用日誌。

核心優勢：

• 廣泛集成： Monolog是一個流行的日誌庫，與大多數主流框架集成，方便開發者利用其日誌功能。它遵循PHP-FIG標準，方便切換到其他實現。
• 靈活處理： Monolog支持多個處理器和冒泡機制，允許開發者將不同類型的消息記錄到不同的輸出端。它還支持將日誌消息發送到外部服務，例如Slack，以便在發生錯誤時通知團隊。
• 功能豐富： Monolog提供一系列實用的預處理器，用於包含內存峰值、用戶ID等詳細信息，並允許自定義日誌消息格式。這使其成為應用開發/維護週期中日誌記錄和調試的強大工具。

安裝：

Monolog可在Packagist上獲取，可通過Composer安裝：

composer require 'monolog/monolog:1.13.*'

如果您使用框架，Monolog通常提供集成方案。以下示例不使用框架集成，展示如何在任何應用中配置Monolog。

日誌記錄器：

創建日誌記錄器時，應指定通道名稱以區分不同的記錄器。以下示例將記錄器綁定到應用容器：

// app/bootstrap/container.php

$logger = new \Monolog\Logger('general');
$app->container->logger = $logger;

Monolog遵循PSR-3標準，方便切換到其他實現。您可以使用以下方法進行日誌記錄（log, debug, info, warning, error, critical, alert, emergency）：

$app->container->logger->info("一条INFO消息。");

處理器：

日誌消息會經過註冊的處理器列表。處理器需要指定處理的日誌級別和冒泡狀態（是否繼續傳播消息）。默認情況下，Monolog使用MonologHandlerStreamHandler將日誌記錄到標準錯誤輸出。文檔中列出了可用的處理器。

以下示例演示如何使用多個處理器和冒泡機制：將INFO消息記錄到瀏覽器控制台，錯誤消息記錄到終端輸出。

// app/bootstrap/container.php

$logger = new \Monolog\Logger('general');

$browserHanlder = new \Monolog\Handler\BrowserConsoleHandler(\Monolog\Logger::INFO);
$streamHandler = new \Monolog\Handler\StreamHandler('php://stderr', \Monolog\Logger::ERROR);

$logger->pushHandler($browserHanlder);
$logger->pushHandler($streamHandler);

$app->container->logger = $logger;

// app/routes.php

$app->get('/admin/users', function () use ($app) {
    $app->container->logger->info("另一条INFO消息");
    $app->container->logger->error("另一条ERROR消息");
    // ...
});

錯誤消息如預期記錄到終端，但為何也出現在瀏覽器控制台？這是Monolog的冒泡機制。錯誤消息首先記錄到終端，如果冒泡選項設置為true，則會繼續傳播到處理器隊列的頂部。將streamHandler的冒泡選項設置為false：

composer require 'monolog/monolog:1.13.*'

現在，錯誤日誌不會顯示在瀏覽器控制台中，這就是分離日誌級別的方法。

Slack處理器：

在使用Slack處理器之前，您需要獲取令牌以授權其發佈到Slack頻道。

// app/bootstrap/container.php

$logger = new \Monolog\Logger('general');
$app->container->logger = $logger;

您只需指定Slack令牌和頻道名稱，第三個可選參數是機器人名稱。 Slack的日誌級別為CRITICAL，但您可以使用setLevel方法更改它。

$app->container->logger->info("一条INFO消息。");

發送日誌消息後，您可以訪問您的頻道查看已記錄的錯誤消息。

// app/bootstrap/container.php

$logger = new \Monolog\Logger('general');

$browserHanlder = new \Monolog\Handler\BrowserConsoleHandler(\Monolog\Logger::INFO);
$streamHandler = new \Monolog\Handler\StreamHandler('php://stderr', \Monolog\Logger::ERROR);

$logger->pushHandler($browserHanlder);
$logger->pushHandler($streamHandler);

$app->container->logger = $logger;

格式化器：

每個處理器都有默認的格式化器，如果沒有指定，則使用LineFormatter。您可以切換到其他格式化器，例如HtmlFormatter。

// app/routes.php

$app->get('/admin/users', function () use ($app) {
    $app->container->logger->info("另一条INFO消息");
    $app->container->logger->error("另一条ERROR消息");
    // ...
});

現在，日誌消息將以HTML格式記錄到瀏覽器控制台。

// app/bootstrap/container.php

// ...
$streamHandler = new \Monolog\Handler\StreamHandler('php://stderr', \Monolog\Logger::ERROR, false);
// ...

預處理器：

預處理器用於向日誌添加更多詳細信息。例如，WebProcessor添加有關請求的更多詳細信息（URL、IP等）。

// app/bootstrap/container.php

// ...
$slackHandler = new \Monolog\Handler\SlackHandler('xoxp-5156076911-5156636951-6084570483-7b4fb8', '#general', 'ChhiwatBot');
$logger->pushHandler($slackHandler);

// ...

日誌記錄時，日誌記錄將通過註冊的處理器列表，您將獲得更多詳細信息。

$slackHandler->setLevel(\Monolog\Logger::ERROR);

總結：

Monolog是優秀的日誌庫之一，並與大多數主流框架集成。

常見問題解答：

（此處省略了FAQ部分，因為篇幅過長，且與文章主體內容重複性較高。 如果需要，可以單獨提出FAQ問題，我會逐一解答。）

以上是使用獨白登錄：從Devtools到Slack的詳細內容。更多資訊請關注PHP中文網其他相關文章！