Yii フレームワークのロギングシステム: アプリケーションイベントの記録-YII-php.cn

Yii フレームワークのロギングシステム: アプリケーションイベントの記録

WBOY

リリース： 2023-06-21 15:42:30

オリジナル

1246 人が閲覧しました

Yii フレームワークには、開発者がデバッグやパフォーマンス分析を実行できるようにアプリケーションイベントを記録できる完全なロギングシステムがあります。この記事では、Yii フレームワークのロギングシステムの基本的な使用法といくつかの実践的なテクニックを紹介します。

ログコンポーネントの設定

Yii フレームワークはデフォルトでログ保存方法としてファイルを使用し、設定ファイルでログコンポーネントを設定できます。以下は簡単な設定例です:

'log' => [
    'traceLevel' => YII_DEBUG ? 3 : 0,
    'targets' => [
        [
            'class' => 'yiilogFileTarget',
            'levels' => ['error', 'warning'],
            'logFile' => '@runtime/logs/app.log',
        ],
    ],
],

ログイン後にコピー

このうち、traceLevel は、Yii フレームワークが debug モードで記録するログレベルを指します。より多くの情報が記録されます。 targets は、複数のログターゲットを構成できる配列です。この例では、error および warning レベルのログを書き込むターゲットは 1 つだけです@ runtime/logs/app.log ファイル。

ログ情報の記録

コード内でログ情報を記録するのは非常に簡単です。Yii フレームワークが提供するショートカット関数を使用できます。例:

Yii::info('This is an info message.');
Yii::warning('This is a warning message.');
Yii::error('This is an error message.');

ログイン後にコピー

Shortcut function 、info、warning、error は、それぞれログの 3 つのレベルに対応します。状況に応じて使い分けが可能です。

ログを記録するときは、文字列を直接記録するだけでなく、プレースホルダー {} で表される置換可能なデータを使用することもできます。例:

Yii::info('User {username} registered successfully.', ['username' => 'John']);

ログイン後にコピー

この時点で、{username} は「John」に置き換えられます。この利点は、ログ情報がより詳細になり、問題のトラブルシューティングが容易になることです。

コンテキスト情報の使用

Yii フレームワークのロギングシステムは、より詳細なログ情報を記録するためのコンテキスト情報の使用をサポートしています。コンテキスト情報には、現在のユーザー情報、リクエストパラメータなどの追加データが含まれます。ログを記録するときに、$context パラメーターを設定することでコンテキスト情報を追加できます。たとえば、次のようになります。

Yii::warning('Invalid user input', ['category' => 'appcontrollersMyController', 'action' => 'create', 'params' => $_POST]);

ログイン後にコピー

上記のコードでは、3 つのコンテキスト情報を使用します。クラス、リクエストされたメソッド、リクエストパラメータ。これにより、ログの発生場所と特定のリクエスト情報がより明確に理解できるようになります。

フィルタリングと分類

実際のアプリケーションでは、すべてのログ情報を記録する必要がない場合があります。 Yii フレームワークのログシステムは、条件に基づいてログメッセージをフィルタリングおよび分類できるフィルタリングおよび分類メカニズムを提供します。

設定では、categories 属性を設定してログメッセージを分類できます。例:

'log' => [
    'targets' => [
        [
            'class' => 'yiilogFileTarget',
            'categories' => ['appcontrollersMyController'],
            'logFile' => '@runtime/logs/mycontroller.log',
        ],
    ],
],

ログイン後にコピー

上記の設定では、 からのメッセージのみをログに記録します。 appcontrollersMyController コントローラーのログ情報を取得し、@runtime/logs/mycontroller.log ファイルに書き込みます。

分類に加えて、関数を使用してログメッセージをフィルタリングすることもできます。例:

'log' => [
    'targets' => [
        [
            'class' => 'yiilogFileTarget',
            'levels' => ['error'],
            'logFile' => '@runtime/logs/app.log',
            'logVars' => [],
            'except' => [
                'yiiwebHttpException:404',
            ],
        ],
    ],
],

ログイン後にコピー

上記の構成では、error レベルのログ情報のみを記録します。同時に、すべてのコンテキスト情報が無視されます。 excel 属性を使用して、無視するログメッセージを指定します。この例では、404 エラーメッセージをすべて無視します。

カスタマイズされたログターゲット

Yii フレームワークのロギングシステムを使用すると、ログメッセージを電子メール、データベース、またはサードパーティのログに送信するなど、ログターゲットをカスタマイズできます。サービスなど。ログターゲットをカスタマイズする必要がある場合は、yiilogTarget クラスを継承し、export メソッドを実装する必要があります。例:

class EmailTarget extends yiilogTarget
{
    public $to;

    public function export()
    {
        foreach ($this->messages as $message) {
            mail($this->to, $message[0], $message[1]);
        }
    }
}

ログイン後にコピー

上記のコードでは、カスタム電子メールターゲットを定義し、export メソッドを実装します。 export メソッドでは、mail 関数を使用して、指定されたメールボックスにログメッセージを送信します。

実際のアプリケーションでは、さまざまなログストレージ要件を満たすために、必要に応じてさまざまなログターゲットを作成できます。

概要

Yii フレームワークのロギングシステムは、開発者がアプリケーションイベントを追跡してデバッグやパフォーマンス分析を改善するのに役立つ非常に実用的なコンポーネントです。ログシステムを使用する場合は、基本的な構成と使用法に加えて、コンテキスト情報の使用、分類とフィルタリング、ログターゲットのカスタマイズなどのいくつかの実践的なヒントを理解する必要があります。ログシステムを深く理解し、柔軟に使用することによってのみ、ログの問題をより適切に解決し、アプリケーションの品質とパフォーマンスを向上させることができます。

以上がYii フレームワークのロギングシステム: アプリケーションイベントの記録の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。