CakePHP4で現在処理しているコントローラー名、アクション名を取得する方法

2023/12/25 2025/03/23

CakePHP4で現在処理しているコントローラー名、アクション名を取得する方法

　
CakePHP4で、現在処理しているコントローラー名、アクション名を取得したい場合があるかと思います。
　
例えば、「CakePHP4で公開側と管理側のデザインテンプレートを分ける方法・setLayout()」で記事を書きましたが、ユーザ管理システムを構築する中で、特定のコントローラーの特定のアクションのページは、ユーザ認証をしていないユーザでもページを表示する、という設定をしたいときに、処理しているコントローラー名を取得する必要がでてきます。
　
そんな時の処理しているコントローラー名、アクション名を取得する方法を解説します。
　
ちなみに、CakePHP3用の記事は「CakePHP3で現在処理しているコントローラー名、アクション名を取得する方法」に書いていますが、CakePHP4になり使えない記述方法もあるようですので、改めて、CakePHP4用の記事としてまとめました。
　
　

CakePHP4で現在のコントローラーを取得する方法

　
下記の記述方法で、現在のコントローラーの値を取得することができます。
　

$this->request->getParam('controller');    // 3.4.0 で追加
$this->name;

//  以下は CakePHP4では使えなくなりました
//  $this->request->controller;
//  $this->request->params['controller'];
//  $this->request->param('controller');

$this->request->getParam('controller'); // 3.4.0 で追加

$this->name;

// 以下は CakePHP4では使えなくなりました

// $this->request->controller;

// $this->request->params['controller'];

// $this->request->param('controller');

CakePHP4で現在のアクションを取得する方法

　
下記の記述方法で、現在のアクションの値を取得することができます。
　

$this->request->getParam('action');    // 3.4.0 で追加

//  以下は CakePHP4では使えなくなりました
//  $this->request->action;
//  $this->request->params['action'];
//  $this->request->param('action');

$this->request->getParam('action'); // 3.4.0 で追加

// 以下は CakePHP4では使えなくなりました

// $this->request->action;

// $this->request->params['action'];

// $this->request->param('action');

CakePHP4 では getParam()メソッドを使う

　
コントローラー名、アクション名を取得する方法は、CakePHP3ではなんでこんなにいっぱいあるの？というくらいいろいろありましたが、CakePHP4では「getParam()メソッド」を使うように改められています。
　
コントローラー名は「$this->name;」でも取得可能ですが、同じような記述でアクション名を取得する方法がないため、この記述方法を使う場面は少ないかと思います。
　
　
また、「getParam()」メソッドは、コントローラー名やアクション名の取得だけではなく、下記の様にしてプラグイン名やプレフィックスの値を取得することもできますので、覚えておくと役に立ちそうな気がします。
　

// 使用しているプラグイン名を取得
$this->request->getParam("plugin");

// prefix名を取得
$this->request->getParam("prefix");

// パラメーター（引数）を取得
$this->request->getParam("pass");

// GETのパラメーター（引数）を取得
$this->request->getParam("?");

// 使用しているプラグイン名を取得

$this->request->getParam("plugin");

// prefix名を取得

$this->request->getParam("prefix");

// パラメーター（引数）を取得

$this->request->getParam("pass");

// GETのパラメーター（引数）を取得

$this->request->getParam("?");

　
3番目のパラメーターの取得に関しては、
http://example.com/controller/action/aaa/bbb/ccc
のような URLの場合、
Array ( [0] => aaa [1] => bbb [2] => ccc )
として取得できます。
　
　
4番目の GETパラメーターの取得に関しては、
http://example.com/controller/action/aaa/bbb/ccc?xxx=000&yyy=111&zzz=222
のような URLの場合、
Array ( [xxx] => 000 [yyy] => 111 [zzz] => 222 )
として取得できます。
　
　

getAttribute(‘params’) でコントローラー名やアクション名などをまとめて取得

　
前項で「getParam()」を使用するとコントローラー名やアクション名などを取得できると説明しましたが、それらをまとめて取得する方法も用意されています。
　
それが「getAttribute(‘params’)」です。
　
下記の記述形式で使用します。

$this->request->getAttribute('params');

1	$this->request->getAttribute('params');

　
　
取得結果は以下のようになります。

// 下記の URLがあったとして
http://example.com/controller/action/aaa/bbb/ccc?xxx=000&yyy=111&zzz=222

// 下記を実行すると
print_r($this->request->getAttribute('params'));

// 下記のように出力されます
Array
(
    [controller] => controller
    [action] => action
    [pass] => Array
        (
            [0] => aaa
            [1] => bbb
            [2] => ccc
        )

    [plugin] => 
    [_matchedRoute] => /{controller}/{action}/*
    [?] => Array
        (
            [xxx] => 000
            [yyy] => 111
            [zzz] => 222
        )

    [_ext] => 
)

// 下記の URLがあったとして

http://example.com/controller/action/aaa/bbb/ccc?xxx=000&yyy=111&zzz=222

// 下記を実行すると

print_r($this->request->getAttribute('params'));

// 下記のように出力されます

Array

(

[controller] => controller

[action] => action

[pass] => Array

(

[0] => aaa

[1] => bbb

[2] => ccc

)

[plugin] =>

[_matchedRoute] => /{controller}/{action}/*

[?] => Array

(

[xxx] => 000

[yyy] => 111

[zzz] => 222

)

[_ext] =>

)

　
「getAttribute(‘params’)」は、コントローラー名やアクション名をまとめて取得できますので、あらかじめまとめて取得しておき、使用するときに「$getAttributeArray["controller"]の形式でその都度取り出す、といった使い方をしたいときに便利でしょう。
　
　

「`getParam("controller")`」「`getParam("action")`」はテンプレートでも使用可能

　
この記事で紹介する「getParam()」メソッドを使って、コントローラー名やアクション名を取得する方法ですが、コントローラ内でも使えますし、ビュー（テンプレート）内でも同じ記述方法で取得することができます。
　
　

参考サイトは CakePHP4の Cookbook

　
最後になりましたが、ここで解説をした内容の関連する記事として、下記も参考にしてください。
「getParam('action')で取得するアクション名は別関数に移動しても不変」
　
また、下記のオフィシャルの Cookbookも参考になります。
　
リクエストとレスポンスオブジェクト
https://book.cakephp.org/4/ja/controllers/request-response.html
　
　

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

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

Message コメントをキャンセル

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

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

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

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

CakePHPのログ出力方法の解説。app.phpにログ設定をし、スコープやレベルを指定してログ出力を振り分ける方法、CakePHP4で配列出力にはvar_exportが必要なことなどを解説。

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

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

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

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

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

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

: CakePHP3でユーザ定義の定数、変数を設定し、読み込む方法解説

CakePHP3で定数や共通で使う変数をまとめて設定し、プログラム内で読み込む方法を、bootstrap.phpに直接記述する方法と定数ファイルを分ける方法の3つの方法で解説。

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

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

: CakePHP3にOGPをfetch、asignを利用してテンプレートごとに指定する方法を解説

CakePHP3でOGPを設定する方法を解説。fetch、assignを使用しレイアウトファイルに編集した変数にテンプレートファイルから値を指定する。これを利用してOGPを編集する。

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

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