モノロジーでのロギング：devtoolsからSlackまで

Monolog：アプリケーションの開発とメンテナンスの効率を改善するのに役立つ強力なPHPログライブラリ

ログ記録は、アプリケーションの開発とメンテナンスサイクルの不可欠な部分であり、記録されたデータだけでなく、記録された方法にも依存します。この記事では、モノログパッケージに飛び込み、ログを最大限に活用するのに役立つ方法を示します。

コアの利点：

• 広く統合された：Monologは、ほとんどの主流のフレームワークと統合され、開発者がロギング機能を活用できるようにする人気のあるログライブラリです。これにより、PHP-Fig標準に従って、他の実装に簡単に切り替えることができます。
• 柔軟な処理：Monologは、複数のプロセッサと泡立つメカニズムをサポートし、開発者が異なるタイプのメッセージを異なる出力に記録できるようにします。また、エラーが発生したときにチームに通知するために、Slackなどの外部サービスにログメッセージを送信することもサポートしています。
• 機能的にリッチ：Monologは、メモリピーク、ユーザーID、カスタムログメッセージ形式などの詳細情報を含むためのさまざまな実用的なプリプロセッサを提供します。これにより、アプリケーション開発/メンテナンスサイクル中にロギングとデバッグの強力なツールになります。

インストール：

MonologはPackagistで入手可能で、作曲家を介してインストールできます：

composer require 'monolog/monolog:1.13.*'

フレームワークを使用する場合、モノログは通常、統合ソリューションを提供します。次の例では、フレームワーク統合を使用しておらず、あらゆるアプリケーションでモノログを構成する方法を示しています。

ログインロガー：

ロガーを作成するときは、異なるロガーを区別するためにチャネル名を指定する必要があります。次の例では、ロガーをアプリケーションコンテナに結合します：

// app/bootstrap/container.php

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

MonologはPSR-3標準に従い、他の実装に簡単に切り替えることができます。ロギングには、次の方法を使用できます（ログ、デバッグ、情報、警告、エラー、クリティカル、アラート、緊急事態）：

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

プロセッサ：

ログメッセージは、登録されたプロセッサリストを通過します。プロセッサは、プロセスのログレベルとバブル状態を指定する必要があります（メッセージが引き継がれ続けているかどうか）。デフォルトでは、MonologはMonologHandlerStreamHandlerを使用して標準のエラー出力にログを記録します。利用可能なプロセッサはドキュメントにリストされています。

次の例は、複数のプロセッサとバブルメカニズムの使用方法を示しています。ブラウザコンソールへの情報メッセージと端末出力へのエラーメッセージ。

// 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消息");
    // ...
});

エラーメッセージは予想どおり端末に記録されますが、なぜブラウザコンソールにも表示されるのですか？これはモノログの泡立ちメカニズムです。エラーメッセージは最初に端子にログに記録され、バブルオプションがtrueに設定されている場合、プロセッサキューの上部まで伝播し続けます。 streamHandlerのバブルオプションをfalseに設定します：

composer require 'monolog/monolog:1.13.*'

エラーログは、ブラウザコンソールに表示されないようになりました。これにより、ログレベルを分離する方法が表示されます。

スラックプロセッサ：

// app/bootstrap/container.php

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

Slackトークンとチャネル名を指定する必要があります。3番目のオプションパラメーターはロボット名です。 Slackのログレベルは重要ですが、メソッドを使用して変更できます。

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

ログメッセージは、HTML形式のブラウザコンソールにログに記録されます。

// app/routes.php

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

// app/bootstrap/container.php

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

プリプロセッサ：

プリプロセッサは、ログに詳細を追加するために使用されます。たとえば、リクエスト（URL、IPなど）の詳細を追加します。

WebProcessorロギングの場合、ロギングは登録済みプロセッサリストを通過すると、詳細が表示されます。

// 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は優れたログライブラリの1つであり、ほとんどの主流のフレームワークと統合されています。

faq：

（記事が長すぎて記事の主な内容を高い繰り返しがあるため、FAQパーツはここで省略されています。必要に応じて、FAQの質問を個別に尋ねることができます。 >

以上がモノロジーでのロギング：devtoolsからSlackまでの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。