CakePHP4、CakePHP5の「warning: DebugKit is disabling．．．」の対処方法

2024/11/17 2025/01/31

CakePHPのDebugKitに関するワーニングを解消する方法解説

　
CakePHPで開発を行っていると、ローカル環境で「ログファイル（/logs/error.log）」に下記のようなワーニングが出力されていることがあります。
　
2024-01-01 00:00:00 warning: DebugKit is disabling itself as your host test.example.com is not in the known safe list of top-level-domains (localhost, invalid, test, example, local, internal). If you would like to force DebugKit on use the DebugKit.forceEnable Configure option.
　
メッセージの内容は、「DebugKitを使用していいリストにないので無効になってる」というものです。
　
これの解消方法を解説します。
　
　
この記事のポイントとしては、Gitなどのソース管理ツールを利用していても本番環境に影響がない（Git管理下にない）「/config/app_local.php」ファイルに設定する内容となっています。
　
そのため、CakePHP4系、CakePHP5系の記事としていますが、「/config/bootstrap.php」に設定する方法は CakePHP3でも有効ですので、お試しください。
　
　

/config/bootstrap.php に許可するトップレベルドメインを設定する

　
おそらく、「DebugKit」のワーニングに対するオーソドックスな対処方法は、「/config/bootstrap.php」に許可するトップレベルドメインを設定する方法です。
　
対象ファイル：/config/bootstrap.php
　
CakePHP5の場合は 116行目辺りに「if (Configure::read('debug')) {」の記述がありますので、その if文の中に下記を追記します。
　

  Configure::write('DebugKit.safeTld', ['com']); // .comドメインを登録する例

1	Configure::write('DebugKit.safeTld', ['com']); // .comドメインを登録する例

　
上記の例は「example.com」のように「.com」ドメインを登録するものですので、使用しているドメインに合わせて設定を変更してください。
　
　

/config/bootstrap.php に強制的に許可する設定をする・非推奨

　
前項のトップレベルドメインを設定する方法が推奨されていますが、強制的に許可する設定も用意されています。
公式サイトには、前項の方が安全なのでそちらがオススメ、と書いてありますが。
　
対象ファイル：/config/bootstrap.php
　
前項と同じく、CakePHP5の場合は 116行目辺りに「if (Configure::read('debug')) {」の記述がありますので、その if文の中に下記を追記します。
　

  Configure::write('DebugKit.forceEnable', true);

1	Configure::write('DebugKit.forceEnable', true);

/config/app_local.php に強制的に許可する設定をする

　
前項の設定は「bootstrap.php」に記述しました。
　
Gitなどのソース管理ツールを使用する場合、「bootstrap.php」ファイルはその管理下にあるファイルとなります。
そのため、本番環境にリリースする場合は「bootstrap.php」に設定した記述を変更する必要もあるかと思います。
　
そのため、Gitなどの管理下にない「app_local.php」に記述することで、影響範囲を開発で使用するローカル環境に留めることができる、という対応方法の紹介です。
　
対象ファイル：/config/app_local.php
　

  'DebugKit' => [
    'forceEnable' => true,
  ],

'DebugKit' => [

'forceEnable' => true,

　
上記の処理を「app_local.php」の最後の方などに追加します。
　
　

DebugKitの記事に関するおまけ

　
「bootstrap.php」に記述した下記の設定を「app_local.php」に記述する方法もあるようですが、いろいろと試してみましたが、私の環境では CakePHP4系、CakePHP5系のいずれも想定の動作はしませんでした。残念．．．
　

  Configure::write('DebugKit.safeTld', ['com']); // .comドメインを登録する例

1	Configure::write('DebugKit.safeTld', ['com']); // .comドメインを登録する例

　
　
また、この記事を書くにあたって参考にしたサイトは下記になります。
　
CakePHP4　オフィシャルサイト　Debug Kit　設定
https://book.cakephp.org/debugkit/4/ja/index.html#id2
　
CakePHP5　オフィシャルサイト　Debug Kit　設定
https://book.cakephp.org/debugkit/5/ja/index.html#id2
　
　

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

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

Message コメントをキャンセル

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

: CakePHP 2.3　デバッグキット（DebugKit）超初心者向けフォロー講座

CakePHP初心者に向けてデバッグキット（DebugKit）のインストール方法、はまりポイントを解説。

: CakePHP4のCakeDC/Usersの Usersへの接続、バリデーションのカスタマイズ方法解説

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

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

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

: CakePHP 2.3　テーブルの項目を演算した結果を条件として抽出する方法

アソシエーション（連携）している先のテーブルの項目で演算をする場合の考え方と注意点をサンプルソースを用いて説明しています。分かってしまえば簡単です。

: CakePHP3でファイルのアップロード処理を自作・解説付き・その１

CakePHP3でファイルをアップロードする処理を、php.netにある「エラーを起こさない」と説明がある処理を参考に作成。サンプルソースとその解説付きで、コピペでも動くし、カスタマイズも簡単！

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

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

: CakePHP4、5でSELECT telephone as tel FROM usersの様にasでカラムに別名を付ける方法

CakePHP4、CakePHP5でクリエビルダーを利用してテーブルからレコードを取得する際、asを使用してカラムの別名で値を取得したい場合の対応方法を解説。また、別名にはハイフンやアスタリスクなど使用できない文字がある点も解説。