CakePHP4でロギングスコープやログレベルを使用してログを出し分ける方法を解説

2024/06/25 2024/06/27

CakePHP4で独自のログファイルを作成してログ出力方法を解説

　
CakePHP4でロギングスコープやログレベルを使用してログを出し分ける方法や、新しいログ出力のファイルを設定する方法を解説します。
　
　

CakePHP4のデフォルトログファイル「debug.log」「error.log」にログ出力する方法

　
CakePHP4では、デフォルトで「debug.log」「error.log」「queries.log」のログが用意されています。
　
コントローラーに下記のように記述すると、それぞれ「debug.log」「error.log」にログ出力をすることができます。
　

// debug.log にログを出力する
$this->log("ログテスト０１","debug");

// error.log にログを出力する
$this->log("ログテスト０２","error");

// debug.log にログを出力する

$this->log("ログテスト０１","debug");

// error.log にログを出力する

$this->log("ログテスト０２","error");

　
第一引数がメッセージで、第二引数が「ログレベル」による出力先の指定です。
　
この方法は、「debug」レベルのメッセージは「debug.log」ファイルに、「error」レベルのメッセージは「error.log」に、と言うデフォルトで設定されている「ログレベル」によるログの出力先を指定する方法を利用したものです。
　
　
今回は、このデフォルトの設定以外に、独自のログファイルを作成し、条件によってログを出力し分ける方法を解説します。
　
例えば、
「Info（インフォメーションメッセージ）」は「info.log」に出力する
「UsersController.php」でのログは「users.log」に出力する
と言った感じの設定をしたいと思ったときの対応方法です。
　
　
ちなみに私は、ロギングスコープを使用して、処理毎にログを分けていく方法が好きですね。
　
　

ログ出力の設定は「/config/app.php」に記述する

　
ログ出力処理の設定は「/config/app.php」に記述されています。
インストールした直後の状態では、350行目くらいから「debug」のログの設定が記述されています。（バージョン等によって少し異なるかと思いますが。）
　
それに続けて「error」「queries」のログの設定がありますので、独自のログ設定は「queries」の設定に続けて記述するといいでしょう。
　
例えば、「sampleError.log」と言うログ出力をする場合の設定は下記となります。
　

    'sampleError' => [
      'className' => FileLog::class,
      'path' => LOGS,
      'file' => 'sampleError',
      'url' => env('LOG_SAMPLE_ERROR_URL', null),
      'scopes' => ['sampleErrorScope'],
      'levels' => ['notice', 'info', 'debug', 'warning', 'error', 'critical', 'alert', 'emergency'],
      'mask' => 0666,
      'rotate' => 5,
      'size' => '10MB',
    ],

'sampleError' => [

'className' => FileLog::class,

'path' => LOGS,

'file' => 'sampleError',

'url' => env('LOG_SAMPLE_ERROR_URL', null),

'scopes' => ['sampleErrorScope'],

'levels' => ['notice', 'info', 'debug', 'warning', 'error', 'critical', 'alert', 'emergency'],

'mask' => 0666,

'rotate' => 5,

'size' => '10MB',

　
1行目の「'sampleError' => [」はログの名称です。
1文字目を小文字で書くローワーキャメルケースで書くようです。
　
【className】
ログエンジンを指定。標準は CakePHPのログ出力処理を利用する「FileLog::class」となる。
その他、ログの標準出力機能を利用する場合は「SyslogLog::class」を指定し、ログ出力のプラグインを利用する場合はこの項目で指定をする。
今回は CakePHPの標準である「FileLog::class」の解説となる。
　
【path】
ログファイルを出力するフォルダを指定。デフォルトの出力先は「LOGS（/logs）」。
　
【file】
出力するログのファイル名。
　
【url】
　
　
【scopes】
「ロギングスコープ」と言う機能を利用してログ出力をする場合に指定する。ローワーキャメルケースで書くようだ。
「scopes」の設定をすると、スコープを指定しないログは出力対象にならない。スコープを使用しない場合は「false」を指定する。
　
また、「scopes」を指定していても、次項の「levels」の対象になっていない場合はログは出力されない。
また、「['sampleErrorScope01','sampleErrorScope02']」のように複数指定することもできる。
　
【levels】
出力対象とするレベルを指定する。
指定できるレベルは以下のもの。
　Emergency：システムは使用出来ません
　Alert：今すぐ行動する必要がある
　Critical：致命的な状態
　Error：エラー状態
　Warning：警告状態
　Notice：正常であるが、重大な状態
　Info：インフォメーションメッセージ
　Debug：デバッグレベルメッセージ
「'levels' => [],」のように「levels」を空にした場合はすべてのレベルを出力する。
　
【mask】
出力するログファイルのパーミッションの指定。「0666」「0755」のように指定する。
指定しない場合はその環境のデフォルトのパーミッションが使われる。
　
【rotate】
ログファイルをローテーションする場合はそのファイル数を数値で指定する。ローテーションしない場合は「false」を指定する。
指定しない場合はデフォルトの「10」となる。
　
【size】
ローテーションする場合の 1ファイルのファイル上限サイズを「2MB」「100KB」のように指定する。
指定しない場合はデフォルトの「10MB」となる。
　
　
path、file、mask、rotate、sizeなどは、classNameの設定で「FileLog::class」を指定した場合に有効になります。
　
また、【path】のところで説明した「LOGS」フォルダですが、CakePHPではシステム上で定義されている定数がいくつかあります。
それについては下記に記事を書いていますので、併せて参考にしてください。
CakePHP3でDocumentRootやtmp、webroot、logsなどのフォルダへのパスの定数
　
　

ログを出力するコントローラー、モデルでの処理

ログレベル（levels）を指定してログ出力をする場合の処理

　
ログレベル（levels）を指定してログ出力をする場合の処理は、一番最初に記載したように、下記の記述をします。
　
コントローラーに記述する場合は下記になります。
　

// debug.log にログを出力する
$this->log("ログテスト０１","debug");

// error.log にログを出力する
$this->log("ログテスト０２","error");

// debug.log にログを出力する

$this->log("ログテスト０１","debug");

// error.log にログを出力する

$this->log("ログテスト０２","error");

　
　
モデルに記述する場合は下記になります。
　

// まず最初に use句を追記する
use Cake\Log\Log;

1 2	// まず最初に use句を追記する use Cake\Log\Log;

　
use句の「use Cake\Log\Log;」の記述を忘れると、「Class "App\Model\Table\Log" not found」と言うエラーが出力されます。
　
続いて、各処理の中に下記を記述します。
　

// 「debug」レベルのログを「debug.log」に出力する場合
Log::debug("デバッグです");

// 「error」レベルのログを「error.log」に出力する場合
Log::error("エラーです");

// 「debug」レベルのログを「debug.log」に出力する場合

Log::debug("デバッグです");

// 「error」レベルのログを「error.log」に出力する場合

Log::error("エラーです");

ログレベル（levels）を指定して複数のログに出力をする場合の処理

    'debug' => [
      'className' => FileLog::class,
      'path' => LOGS,
      'file' => 'debug',
      'url' => env('LOG_DEBUG_URL', null),
      'scopes' => false,
      'levels' => ['notice', 'info', 'debug'],
    ],
    'debug2' => [
      'className' => FileLog::class,
      'path' => LOGS,
      'file' => 'debug2',
      'url' => env('LOG_DEBUG_URL', null),
      'scopes' => false,
      'levels' => ['notice', 'info', 'debug'],
    ],

'debug' => [

'className' => FileLog::class,

'path' => LOGS,

'file' => 'debug',

'url' => env('LOG_DEBUG_URL', null),

'scopes' => false,

'levels' => ['notice', 'info', 'debug'],

'debug2' => [

'className' => FileLog::class,

'path' => LOGS,

'file' => 'debug2',

'url' => env('LOG_DEBUG_URL', null),

'scopes' => false,

'levels' => ['notice', 'info', 'debug'],

　
上記のように「/config/app.php」に「levels」の設定に「debug」が複数のログ設定にある場合、下記の「debug」のログレベルを指定してログ出力した場合は、「debug.log」「debug2.log」の両方にログ出力されます。
　

// debug.log debug2.logの両方にログを出力する
$this->log("ログテスト０１","debug");

1 2	// debug.log debug2.logの両方にログを出力する $this->log("ログテスト０１","debug");

ロギングスコープ（scopes）を指定してログ出力をする場合の処理

　
ロギングスコープ（scopes）を指定してログ出力をする場合の処理は、下記を記述します。
　
　

コントローラーでロギングスコープを指定する方法

　
コントローラーに記述する場合はでは下記を記述します。
　

// 「sampleErrorScope」のスコープを指定する場合
$this->log("エラーです", "error", ["scope" => ["sampleErrorScope"]]);

1 2	// 「sampleErrorScope」のスコープを指定する場合 $this->log("エラーです", "error", ["scope" => ["sampleErrorScope"]]);

　
第一引数が、エラーメッセージ。
第二引数が、ログレベル。
第三引数が、その他の設定で、上記は「ログスコープ」を指定しています。
第三引数で指定するスコープは「scopes」で指定した名称です。
上記の例では「sampleError」と記述しているログの名称の方ではありませんのでご注意ください。（とは言え「scopes」の値を「sampleError」と同じ文字列にする場合が多いんですが。）
　
ちなみに、「scope」で指定した値が、「app.php」内の「scopes」で設定しているものに存在しない場合でもエラー等の発生はありません。
もちろんログも出力されませんので、出力されているハズのログが出力されていない場合は「scope」の値が間違っているのかもしれません。
　
　

モデルでロギングスコープを指定する方法

　
モデルでは下記を記述します。
　

// まず最初に use句を追記する
use Cake\Log\Log;

1 2	// まず最初に use句を追記する use Cake\Log\Log;

　
// 「sampleErrorScope」のスコープを指定する場合
// 「error」レベルのログを「error.log」に出力する場合
Log::error("エラーです", ["scope" => ["sampleErrorScope"]]);

// 「sampleErrorScope」のスコープを指定する場合

// 「error」レベルのログを「error.log」に出力する場合

Log::error("エラーです", ["scope" => ["sampleErrorScope"]]);

　
最初の「Log::error」の「error」の部分がエラーレベル。
第一引数が、エラーメッセージ。
第二引数が、その他の設定で、上記は「ログスコープ」を指定しています。
　
　

CakePHP4で配列、オブジェクトを出力する場合は「var_export()」を使用する

　
CakePHP4からは、配列やオブジェクトをログ出力する際に「var_export()」を使用する必要があります。
CakePHP3も CakePHP4も基本的なログの設定方法、出力の指定方法などは変わらないのですが、なぜかこの配列やオブジェクトを直接出力してくれなくなっています。
　

$sampleArray = [
  "aaa" => "aaa01",
  "bbb" => "bbb01",
];

// CakePHP3までの配列をログ出力する際の記述方法（CakePHP4ではエラーになる）
$this->log($sampleArray,"debug");

// CakePHP4から配列をログ出力する際の記述方法
$this->log(var_export($sampleArray,true),"debug");

$sampleArray = [

"aaa" => "aaa01",

"bbb" => "bbb01",

];

// CakePHP3までの配列をログ出力する際の記述方法（CakePHP4ではエラーになる）

$this->log($sampleArray,"debug");

// CakePHP4から配列をログ出力する際の記述方法

$this->log(var_export($sampleArray,true),"debug");

　
CakePHP3までは配列やオブジェクトの変数もそのまま記述すれば、いい感じでログに出力をしてくれていましたが、CakePHP4からは「var_export()」を利用して出力する必要があります。
　
「var_export()」を付けないと下記のエラーが発生します。
　
「Cake\Controller\Controller::log(): Argument #1 ($message) must be of type string, array given, called in C:\xampp\htdocs\src\Controller\SamplesController.php on line 333」
　
また、「var_export()」の第二引数の「true」もお忘れなきよう。
　
　
さらに「var_export()」についてもう少し詳しく知りたい、「print_r」「var_dump」と何が違うの？と思った方は下記に解説記事を書いていますので併せて参考にしてください。
PHPのデバッグで使う print_r、var_dump、var_exportの動作の違い
　
　

- CakePHP 3.x 4.x 5.x CakePHP4

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP3の更新画面でUpload Plugin 3.0を使う方法、viewで使う方法解説・その３

CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその3で記事を更新する際のファイルの取り回しなどについてを解説。

: CakePHPで favicon.icoやapple-touch-icon-144-precomposed.pngが could not be foundのエラーが出るときの対処方法

CakePHPで「CakeDC/Users」などルーティングを行うプラグインを利用するときに、favicon.icoやapple-touch-icon-144-precomposed.pngがNotFoundエラーになることがある。その対処方法の解説。

: CakePHP3のInsert On Duplicate Key Update（upsert）構文を解説・バルク処理も

CakePHP3で Insert … On Duplicate Key Update構文（upsert）を実行する方法を解説。バルク処理の方法も用意されているため大量処理の場合も対応可能。

: CakePHP3でデータを保存する save()で発生するエラーを確認する方法を解説

CakePHP3でデータ保存処理のログを取得する方法。save()では true、falseの戻り値しか取得できないが、saveOrFail()と try…catch文を使いエラーログ、エンティティを取得し、不具合の解析を行う。

: CakePHP3のCakeDC/Usersのバリデーションのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。Usersのカスタマイズとして入力項目のバリデーションの変更を、プラグインのファイルは触らずオーバーライドにより実装する方法を解説する。

: 国際化と地域化の翻訳機能「__()」を使って定数に変数を埋め込む方法

CakePHP4で定数に変数を埋め込み、翻訳機能「__()」で変数に値を入れる方法を紹介。定型の文章の一部だけを置換したい場合に利用すると便利。

: CakePHP3でQRコードを作成、表示するライブラリ「cakePHP-QR-Code-Helper」

CakePHPでQRコードを生成するライブラリ「cakePHP-QR-Code-Helper」の紹介。GDライブラリのインストールも必要ないHelperとして提供されているため、ファイルを設置すればすぐに使用可能。

: CakePHP4のメッセージ日本語化の設定（国際化と地域化の機能の使い方の解説）

CakePHP4の英語のメッセージを日本語化（多言語化）する手順を解説。オリジナルのメッセージを作成する方法やプログラムで文言を追加する場合の対応なども解説。

: CakePHP3のOGPはHTMLヘルパーの$this->Html->meta()を使って設定

CakePHP3でOGPを設定する方法を解説。metaタグを編集するHTMLヘルパーを利用してOGPのタグを編集する。また、エレメントとして分割することでメンテナンス性も向上させる。

: CakePHP3の検索プラグイン「friendsofcake/search」の設置方法・CakePHP3.6対応

CakePHP3で検索を担うプラグイン「friendsofcake/search」の紹介。基本的な設置方法の紹介のほか、処理の記述方法のバリエーション、エラーの解説など。CakeDC/searchより導入は簡単！