CakePHP4のcake cache clear_allでPermission deniedはパーミッションの変更が必要

2024/09/06 2024/09/08

CakePHP4の cake cache clear_allで Permission deniedのエラーの時は cakeにパーミッションが不足している可能性大

パーミッション不足はキャッシュファイルではなくcakeコマンドの方

　
CakePHP4でキャッシュをクリアする「cake cache clear_all」コマンドを実行したとき、「-bash: bin/cake: Permission denied」のエラーが出るときは、「cake」にパーミッションが与えられていないために発生します。
　
このエラーが出たとき、コマンドを実行して削除するキャッシュファイルの方にパーミッションが正しく設定されていないのかと思っていましたが、そうではなく、「/bin/cake」のコマンドプログラムの方にパーミッションが足りていない状況でした。
　
　

「/bin/cake」に実行権限を付与する

　
というわけで、原因が分かれば対応は簡単です。
　
下記コマンドを実行して、「/bin/cake」に実行権限を付与します。
　

sudo chmod 744 ./bin/cake

1	sudo chmod 744 ./bin/cake

　
「cake」ファイルまでのパスや、「744」で指定しているパーミッションは、環境に応じて変更してください。
「744」のパーミッションは、ユーザのグループ設定の影響もありますので、「754」にする必要がある場合もあるかもしれません。
　
　
ちなみに、「cake cache clear_all」コマンドについては下記に記事を書いていますので、併せて参照してください。
「CakePHP3、CakePHP4のキャッシュをクリアする方法「bin/cake cache clear_all」を使う」
　
　

「/bin/cake」に実行権限が付与されない理由の一つ

　
何で「/bin/cake」に実行権限が付与されないのだろうか、と悩んでいました。
これまでそんな不具合なかったのになぁ、と。
　
この記事を読んでいる方、XAMPP環境で開発を行っていませんか？
そして、Linux系の本番環境にプログラムを移動させてからこの不具合が発生していませんか？
　
私は XAMPP環境で構築したプログラムを、そのまま Linux環境にアップロードしました。
そしたら、そこで発生するようになりました。
　
　
最初に、Linux環境で構築した CakePHPの「/bin/cake」には実行権限が付与されていたのではないか、と思います。
そこに、Windows上に構築した XAMPP環境で構築した CakePHPを Gitを経由して上書きしたのですが、Windows環境の「/bin/cake」には実行権限という概念がなく、一般的なファイルとしてそのまま上書きされたのだろうと思います。
　
そのため、「cakeコマンド」を実行しようとしたところ権限がないですよ、というエラーになったのだと考えています。
　
　

キャッシュファイルのパーミッションを設定する

　
前項で「/bin/cake」コマンドのキャッシュ設定について説明しましたが、それだけでは記事が短いので、キャッシュファイルのパーミッションを設定する方法も解説します。
　
　
CakePHP4のキャッシュファイルの設定は「/config/app.php」ファイルに記述されています。
　
バージョンなどによって多少違うと思いますが、97行目辺りに「'Cache' => [」という記述があるかと思います。
この辺りからキャッシュについての設定が記述されています。
　
これに対して、8行目の「'mask' => 0664,」を追記します。
　

'_cake_core_' => [
  'className' => FileEngine::class,
  'prefix' => 'myapp_cake_core_',
  'path' => CACHE . 'persistent' . DS,
  'serialize' => true,
  'duration' => '+1 years',
  'url' => env('CACHE_CAKECORE_URL', null),
  'mask' => 0664,
],

'_cake_core_' => [

'className' => FileEngine::class,

'prefix' => 'myapp_cake_core_',

'path' => CACHE . 'persistent' . DS,

'serialize' => true,

'duration' => '+1 years',

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

'mask' => 0664,

　
上記は「_cake_core_」のキャッシュについての設定になりますが、同様の対応を「_cake_model_」「_cake_routes_」の設定情報にも追記します。
　
　
場合によっては 7行目の最後に「,（カンマ）」がない場合もあるかもしれませんので、ない場合はカンマも追記してください。
　
また、上記の設定では、キャッシュファイルのパーミッションを「664」にする設定にしていますが、環境によっては「666」の方がいい場合もあると思います。
　
　
今回の解説は、キャッシュについてでしたが、ログの出力方法、および、ログファイルのパーミッションなどの設定方法もキャッシュとよく似ています。
ログについては下記にまとめていますので、併せて参考にしてください。
「CakePHP4でロギングスコープやログレベルを使用してログを出し分ける方法を解説」
　
　

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

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

Message コメントをキャンセル

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

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

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

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

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

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

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

: CakePHP3でパンくずの指定は HTMLヘルパーを使って指定する方法を解説

CakePHP3でパンくずの指定方法の解説。2つのヘルパーがあるが簡単なHTMLヘルパーを使った方法を、実際の状況に合わせて3つのパターン（エレメント化、ブロック化）にして解説。

: CakePHP3でテーブルにカラム（項目）を追加したときに変更するポイントのまとめ

CakePHP3でシステム開発をする際、途中でカラムを追加した場合に何を変更すればいいかを確認。カラムを追加する前後で Bakeした結果を比較し、変更になった点をリストアップした。

: MySQL＋CakePHPのdate型、datetime型項目は「2999-12-31」までしか扱えない

CakePHPの日付、日時の型であるdate型、datetime型の最大値は2999-12-31となっている。MySQLは9999年までなので違いがあるので注意が必要だ。

: CakePHP3でレコードを保存（追加、更新、Insert、Update）する複数の方法を紹介

CakePHP3でレコードを追加、更新（Insert、Update）する記述方法を解説。1件ずつ処理、全件をまとめて処理、条件に該当する複数件のレコードを処理方法をサンプルコードを用いて解説。