CakePHP3ログファイルへの出力・$this->log()、独自ログへの出力方法の解説

2017/04/02 2019/04/06

$this->log()を使ってログファイルを出力する

コントロールやモデル内の変数はログファイルに出力しよう

　
CakePHP3で開発を行う際、変数の中身を確認したい、と思う場面は多々あるでしょう。
　
ビューのテンプレート上で扱っている変数であれば、そのまま「echo()」関数や「print_r()」関数を使うことで簡単に確認することができます。
　
ですが、コントローラーや、モデルの中にある変数などは「echo()」関数などで気軽に確認することができません。
　
そんなときに活用するのがログファイルへの出力です。
　
　

$this->log()を使ってログ出力する方法

エラーログとして出力する

　
CakePHP3では、ログファイルへの出力は、下記の様に記述をします。
記述するファイルはコントロールファイルや、モデルの Entityや Tableのファイルに記述をします。
　
下記の様に記述すると、エラーログに「エラーログを出力します。」のメッセージが出力されます。
　

$this->log("エラーログを出力します。");
$this->log("エラーログを出力します。", "error");

1 2	$this->log("エラーログを出力します。"); $this->log("エラーログを出力します。", "error");

　
出力されるログファイルは、デフォルトの設定では下記のファイルになります。
　/logs/error.log
　
　

デバッグログとして出力する

　
デバッグログに出力する場合は、下記の様に第 2引数に「”debug”」「LOG_DEBUG」のいずれかを指定します。
　

$this->log("エラーログを出力します。", "debug");
$this->log("エラーログを出力します。", LOG_DEBUG);

1 2	$this->log("エラーログを出力します。", "debug"); $this->log("エラーログを出力します。", LOG_DEBUG);

　
$this->log() のログ出力が便利な理由は、変数であっても配列（連想配列も含む）であっても、オブジェクトであっても、プログラマー側が特に気にすることなく何でも出力してくれることです。
　
先の例では、固定のテキストを出力するように記述していますが、下記の様に、変数を指定することもできます。
requestデータですので、POSTで値を送信したときは、配列として値を受け取りますが、それも「print_r()」関数で表示したときのような形で配列を展開してログに出力してくれます。
　

$this->log($this->request->data, LOG_DEBUG);

1	$this->log($this->request->data, LOG_DEBUG);

　
出力されるログファイルは、デフォルトの設定では下記のファイルになります。
　/logs/debug.log
　
　

データベースへのアクセスクエリーをログとして出力する方法

　
CakePHP 3.6以降では、データベースへアクセスしたクエリーをログとして出力する方法が用意されています。
　
/config/app.php の 335行目あたりに下記の設定があります。
デフォルトでは、この処理は有効になっていません。
　

        // To enable this dedicated query log, you need set your datasource's log flag to true
        'queries' => [
            'className' => 'Cake\Log\Engine\FileLog',
            'path' => LOGS,
            'file' => 'queries',
            'url' => env('LOG_QUERIES_URL', null),
            'scopes' => ['queriesLog'],
        ],

// To enable this dedicated query log, you need set your datasource's log flag to true

'queries' => [

'className' => 'Cake\Log\Engine\FileLog',

'path' => LOGS,

'file' => 'queries',

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

'scopes' => ['queriesLog'],

　
これを有効にするには、/config/app.php の 245行目あたりから始まる「Datasources」というデータベースの接続情報などを設定する箇所の「'log' => false,」を変更します。
　

            // ログを出力しない場合（デフォルト設定）
            'log' => false,

            // ログを出力する場合
            'log' => true,

// ログを出力しない場合（デフォルト設定）

'log' => false,

// ログを出力する場合

'log' => true,

　
ログファルは、「/logs/queries.log」として出力されます。
　
ただ、データベースにアクセスするすべてのログが出力されますので、大量のログが出力されます。
そのため、これを出力するのは開発のときだけにして、本番運用に際しては必要に応じてログを出力する独自のログ出力を検討した方がいいでしょう。
　
　

独習PHP 第3版

独自設定のログファイルを出力する方法

　
前項は、既存のログファイルにデバッグ用の値を出力することを想定した内容になっています。
　
この項では、本番運用に際して、独自設定のログファイルを設定し、そこに必要な情報を出力する方法を解説します。
（CakePHP 3.6で動作確認をしています。CakePHP 3.6より前のバージョンの場合は、下の方にある「CakePHP 3.4以前のバージョンの場合？」を参照してください。）
　
　

/config/app.php の編集

　
/config/app.php の 315行目あたりから始まるログの設定箇所に、下記の 27～33行目の処理を追記します。
　

    'Log' => [
        'debug' => [
            'className' => 'Cake\Log\Engine\FileLog',
            'path' => LOGS,
            'file' => 'debug',
            'url' => env('LOG_DEBUG_URL', null),
            'scopes' => false,
            'levels' => ['notice', 'info', 'debug'],
        ],
        'error' => [
            'className' => 'Cake\Log\Engine\FileLog',
            'path' => LOGS,
            'file' => 'error',
            'url' => env('LOG_ERROR_URL', null),
            'scopes' => false,
            'levels' => ['warning', 'error', 'critical', 'alert', 'emergency'],
        ],
        // To enable this dedicated query log, you need set your datasource's log flag to true
        'queries' => [
            'className' => 'Cake\Log\Engine\FileLog',
            'path' => LOGS,
            'file' => 'queries',
            'url' => env('LOG_QUERIES_URL', null),
            'scopes' => ['queriesLog'],
        ],

        'operation' => [
            'className' => 'Cake\Log\Engine\FileLog',
            'path' => LOGS,
            'file' => 'operation_log',
            'scopes' => ["operation_log"],
            'levels' => [],
        ],
    ],

'Log' => [

'debug' => [

'className' => 'Cake\Log\Engine\FileLog',

'path' => LOGS,

'file' => 'debug',

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

'scopes' => false,

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

'error' => [

'className' => 'Cake\Log\Engine\FileLog',

'path' => LOGS,

'file' => 'error',

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

'scopes' => false,

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

// To enable this dedicated query log, you need set your datasource's log flag to true

'queries' => [

'className' => 'Cake\Log\Engine\FileLog',

'path' => LOGS,

'file' => 'queries',

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

'scopes' => ['queriesLog'],

'operation' => [

'className' => 'Cake\Log\Engine\FileLog',

'path' => LOGS,

'file' => 'operation_log',

'scopes' => ["operation_log"],

'levels' => [],

　
'className' => 'Cake\Log\Engine\FileLog',
ログ出力処理を行うクラスを指定します。
上記は完全な namespaceまで記述した方法ですが、「'className' => 'File',」のように短い名称でも同じ設定内容になります。
　
'path' => LOGS,
ログファイルを出力する場所を指定します。
デフォルトの「LOGS」では「/logs」フォルダに出力されます。
専用のフォルダにログ出力したい場合は、「'path' => LOGS . "operation/",」のように指定します。
このときの注意ポイントは「operation/」の最後の「/」を必ず設定することです。これがないとフォルダが正しく指定されていないこととなり、ログが出力されません。
ちなみに、「operation」フォルダがない場合は、自動的に生成されますので、あらかじめ作っていなくても問題ありません。
　
'file' => 'operation_log',
出力するログファル名を指定します。
「operation_log」を指定すると「operation_log.log」というファイルにログが出力されます。
拡張子は必ず「.log」となります。拡張子は指定する必要はありません。ファイル名に「.log」を付けても付けていなくても結果は変わりません。
ちなみに、「operation_log.aaa」のように記述すると、「operation_log.aaa.log」というログファイルが生成されます。
　
ちなみに、固定値ではなく「'file' => date("Y-m-d"),」のようにその日の日付のログファイルを作成するように指定することもできます。
　
'scopes' => ["operation_log"],
ここで設定したログファイルにログを出力する際に指定する値です。
重複せずに分かりやすい文字列を指定します。
　
'levels' => [],
今回は、「scopes」で「operation_log」を指定して出力するため、「levels」は指定しません。
　
　
また、CakePHP 3.6以降では、「debug」「error」の設定の 7行目、15行目に下記の設定が追加されています。
この設定がないと、独自ログファイルに出力しているはずのログが、デフォルトで設定してある「debug」「error」にも出力されてしまうためです。
独自ログは独自ログだけに出力されるように、この設定があります。（CakePHP 3.6より前のバージョンでこの設定がない場合はこの記述を追加します。）

            'scopes' => false,

1	'scopes' => false,

ログ出力のレベルに関して

　
ログ出力のレベルは、下記に設定されているとおりです。
　

Emergency：システムは使用出来ません
Alert：今すぐ行動する必要がある
Critical：致命的な状態
Error：エラー状態
Warning：警告状態
Notice：正常であるが、重大な状態
Info：インフォメーションメッセージ
Debug：デバッグレベルメッセージ

　
詳しくは以下に書かれていますが、「'levels' => [],」に指定することで、該当の処理が発生したときに指定したログファイルにその内容を出力します。
　
詳しくは下記の Cookbookを参照してください。
https://book.cakephp.org/3.0/ja/core-libraries/logging.html#logging-levels
　
　

/src/Controller/TopicsController.php の編集

　
続いて、実際にログを出力する箇所に処理を追加します。
今回は、Topicsというコントローラーの add()アクションにログ出力を追加する想定です。
　
追加するファイルは、下記になります。
/src/Controller/TopicsController.php
　
　
まず、ファイルの先頭あたりに use句を追加します。
　

use Cake\Log\Log;

1	use Cake\Log\Log;

　
　
続いて、ログを出力する処理である 9行目を追加します。
　

    public function add()
    {
        $topic = $this->Topics->newEntity();
        if ($this->request->is('post')) {
            $topic = $this->Topics->patchEntity($topic, $this->request->getData());
            if ($this->Topics->save($topic)) {

                // ログ出力追加
                Log::info($this->Topics->save($topic), "operation_log");

                $this->Flash->success(__('The topic has been saved.'));

                return $this->redirect(['action' => 'index']);
            }
            $this->Flash->error(__('The topic could not be saved. Please, try again.'));
        }
        $this->set(compact('topic'));
    }

public function add()

{

$topic = $this->Topics->newEntity();

if ($this->request->is('post')) {

$topic = $this->Topics->patchEntity($topic, $this->request->getData());

if ($this->Topics->save($topic)) {

// ログ出力追加

Log::info($this->Topics->save($topic), "operation_log");

$this->Flash->success(__('The topic has been saved.'));

return $this->redirect(['action' => 'index']);

}

$this->Flash->error(__('The topic could not be saved. Please, try again.'));

}

$this->set(compact('topic'));

}

　
「Log::info();」でログを出力します。
1つ目のパラメーターに出力する値を編集します。固定値でも変数でも配列でもオブジェクトでも設定できます。
2つ目のパラメーターには、ログの出力先としてログファイルの設定で決めた「scopes」の値を指定します。今回のサンプルでは「operation_log」を設定していましたので、これを指定します。
　
これで、Topicsの登録画面からレコードを登録するとログが出力されます。
　
　

「CakePHP 3.4以前のバージョンの場合？」

　
以下は以前書いていた内容です。
CakePHP 3.6以降では前項の設定で動作しましたが、それより前のバージョンでは動作するかどうか分かりませんので、CakePHP 3.6より前のバージョンで動作しない場合は、下記を参照してください。
　
　

ログ出力に関する設定

　
ログ出力に関する設定は、以下のファイルに記述してあります。
　/config/app.php
　
記述してある内容の標準形式は以下のようになっています。
　

    'Log' => [
        'debug' => [
            'className' => 'Cake\Log\Engine\FileLog',
            'path' => LOGS,
            'file' => 'debug',
            'levels' => ['notice', 'info', 'debug'],
            'url' => env('LOG_DEBUG_URL', null),
        ],
        'error' => [
            'className' => 'Cake\Log\Engine\FileLog',
            'path' => LOGS,
            'file' => 'error',
            'levels' => ['warning', 'error', 'critical', 'alert', 'emergency'],
            'url' => env('LOG_ERROR_URL', null),
        ],
    ],

'Log' => [

'debug' => [

'className' => 'Cake\Log\Engine\FileLog',

'path' => LOGS,

'file' => 'debug',

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

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

'error' => [

'className' => 'Cake\Log\Engine\FileLog',

'path' => LOGS,

'file' => 'error',

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

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

　
その中から、例えば、「info」のエラーレベルだけを違うログファイルに出力しようと考える場合には、下記の様に、「debug」の「lavels」の中から「info」を取り出し、「info_log」というログファイル出力の設定をするといいでしょう。
　

    'Log' => [
        'debug' => [
            'className' => 'Cake\Log\Engine\FileLog',
            'path' => LOGS,
            'file' => 'debug',
            'levels' => ['notice', 'debug'],
            'url' => env('LOG_DEBUG_URL', null),
        ],
         ：
         中略
         ：

        'info_log' => [
            'className' => 'Cake\Log\Engine\FileLog',
            'path' => LOGS,
            'file' => 'info_log',
            'levels' => ['info'],
            'url' => env('LOG_DB_ERROR_URL', null),
        ],
    ],

'Log' => [

'debug' => [

'className' => 'Cake\Log\Engine\FileLog',

'path' => LOGS,

'file' => 'debug',

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

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

：

中略

：

'info_log' => [

'className' => 'Cake\Log\Engine\FileLog',

'path' => LOGS,

'file' => 'info_log',

'levels' => ['info'],

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

　
「info」レベルの出力が発生した場合は、infoログに出力されるようになります。
　
また、「info」レベルのログを出力する場合は、下記の様に $this->log()の第 2引数に「info」を指定することで対応が可能になります。
　

$this->log($this->request->data, "info");
$this->log($this->request->data, LOG_INFO);

1 2	$this->log($this->request->data, "info"); $this->log($this->request->data, LOG_INFO);

　
この場合、出力されるログファイルは、下記のファイルになります。
　/logs/info_log.log
　
　

ログ出力に関するまとめ

　
プログラムを開発するにあたって、変数の中にどういう値が入っているか、それはデバッグをする上で非常に重要なポイントです。
　
なので、簡単に変数の中身を見る方法を確保することは、プログラム開発スピードを向上させてくれるでしょう。
　
CakePHP2では「CakePHP 2.3 Model、Controllerの見たい変数の中身をログ出力」に記事に書いたとおりの方法なのですが、CakePHP3になっても大きな変化はなく「$this->log()」を使うことでログファイルに変数の情報を出力できますので、積極的に活用していきましょう。
　
　
ちなみに、マニュアルは下記のページにあります。
ログ出力の詳細については英語のページしか見つからず、細かなところまではまだ確認しきれていませんが、そのうち日本語のページができてくることを願っています！
https://book.cakephp.org/3.0/en/core-libraries/logging.html#writing-to-logs
　
https://book.cakephp.org/3.0/ja/development/debugging.html
　
　

- CakePHP 3.x 4.x CakePHP3

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

Message コメントをキャンセル

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

: CakePHP3でDocumentRootやtmp、webroot、logsなどのフォルダへのパスの定数

CakePHP3で特定フォルダのパスの定数を解説。root、DocumentRoot、app、config、webroot、tests、tmp、cache、vendor、コア、コアの srcが設定済み。realpath()関数を使うと柔軟なパス指定が可能。

: CakePHP4のフラッシュメッセージの表示場所、デザインを変更する方法を解説

CakePHP4のエラーメッセージ、完了メッセージなどを表示するフラッシュ処理の解説。Controller、レイアウトファイル、テンプレートファイルでそれぞれ処理を指定する。

: CakePHP3のルーティング（routes.php）の変更が反映されない時はキャッシュのクリアを

CakePHP3でルーティングの設定変更をしたけど反映されない！そんなときは慌てず騒がずキャッシュをクリアしよう！ルーティングの設定もキャッシュされることがあるらしい。

: CakePHP3のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説・3.6以降対応

CakePHP3のユーザ管理プラグイン Usersは、ユーザ登録、メール認証、ログイン認証、ユーザ管理、権限管理、reCAPTCHAなど会員制のサイトを簡単に実現可能。その導入方法、カスタマイズ方法を解説。

: CakePHP 2.3　Search Pluginで検索処理　その２表示件数を動的に変える方法

CakePHPの検索プラグイン Search Pluginの検索処理の中で動的に表示件数を変える方法です。

: CakePHP 2.3でファイルをアップロード・その2　ファイル名を乱数で設定

CakePHPのアップロードするファイル名を乱数で変更しセキュリティを高める方法を解説。

: CakePHP 2.3　Search Pluginで検索処理　その６ORDER、sortソートの機能

CakePHPの検索プラグイン Search Pluginの検索処理の中で order、ソートについての解説です。

: Google Analytics APIを CakePHP3で動かしてレポートデータを取得する方法の解説

CakePHP3で Google Analytics APIからレポートデータを取得する処理の解説。PHPのサンプルソースをCakePHP3で動くように改造。加えて、ディメンションやメトリックスを条件に設定する方法なども。

: CakePHP3でassociatedを使って関連データをまとめて保存する方法（hasOne、hasMany、belongsTo）

CakePHP3で関連データをまとめて保存する方法。hasOne、hasMany、belongsTo等の関連データはassociatedを追加することでまとめて保存することができます。

: CakePHP3のHtmlHelperのLink設定のまとめ。mailto、URL、Root／Homeのリンクなども

CakePHP3でHtmlHelperを使ってリンクの設定をする方法のまとめ。基本形からURLを指定、class、id、targetを指定、mailtoのリンク、画像をアンカーに、JavaScriptのダイアログなどの解説。