[CakePHP4]デバッグキット（Debug Kit）をインストールしても表示されない原因と対処法

2021年05月02日2024年03月09日

CakePHP4のDebug Kitはかなり優秀でお気に入りなんですが、公式サイトに書かれている通りにインストールしても表示されませんでした。

現在VagrantでCakePHP4を使ったプロジェクトを開発しているのですが環境によっては公式サイト通りにやっても表示されないことがわかりました。

そこで、Vagrant + CakePHP4でDebug Kitを表示する方法を紹介します。

Debug Kitをインストール

CakePHP4はデフォルトでDebug Kitがインストールされています。もし削除しまって再インストールしたい場合は、下記コマンドを実行します。

php composer.phar require --dev cakephp/debug_kit "~4.0"

プラグインを有効化します。

bin/cake plugin load DebugKit

デバッグモードを有効化する

config/app_local.php

<?php
return [
    ～ 省略 ～
    //'debug' => filter_var(env('DEBUG', true), FILTER_VALIDATE_BOOLEAN),
    'debug' => true,

.envで管理している場合は、.env側を修正する必要があります。

基本的にこれだけでDebug Kitを有効化することができるのですが、表示されなかった場合は次をやる必要があります。

Debug Kit表示されなかった場合

Vagrantなどの仮想サーバーで開発している場合は、「Application.php」ファイルに下記のように修正してあげる必要があります。

src/Application.php

    public function bootstrap(): void
    {
        
        ～省略～
        ↓↓↓↓↓ここから
        /*
         * Only try to load DebugKit in development mode
         * Debug Kit should not be installed on a production system
         */
        if (Configure::read('debug')) {
            Configure::write('DebugKit.forceEnable', true);
            
            $this->addPlugin('DebugKit');
        }
       ↑↑↑↑↑ここまで
        ～省略～
     }

プラグインの有効化コマンドを何度も実行している場合は、