CakePHP4、CakePHP5系の認証処理でログインの有無の確認、ユーザ情報の取得の方法
2025/03/23
CakePHP4系、5系ではプラグイン「Authentication」を使用して認証処理を行う
CakePHP4系、CakePHP5系では Authenticationというプラグインを使用して、認証処理を行います。
Authentication Ver.2 は CakePHP4系で、Ver.3 は CakePHP5系で使用します。
CakePHP Authentication Ver.2
https://book.cakephp.org/authentication/2/ja/index.html
CakePHP Authentication Ver.3
https://book.cakephp.org/authentication/3/ja/index.html
実装方法は、下記の CakePHPオフィシャルサイトに詳しく紹介されていますので、おおよそ問題はないんじゃないかと思います。
Cookbook CMS チュートリアル – 認証
https://book.cakephp.org/4/ja/tutorials-and-examples/cms/authentication.html
https://book.cakephp.org/5/ja/tutorials-and-examples/cms/authentication.html
Cookbook シンプルな認証と認可のアプリケーション
https://book.cakephp.org/4/ja/tutorials-and-examples/blog-auth-example/auth.html
https://book.cakephp.org/5/ja/tutorials-and-examples/blog-auth-example/auth.html
ただ、1点だけ、CakePHP5系では、公式サイトの記述が間違っている点がありますので、下記の記事を確認していただいて、対応をしてください。
「CakePHP5系で認証機能のAuthenticationプラグインをインストール・エラー発生注意」
CakePHPの Authenticationでログインの有無と、ユーザ情報の取得方法
さて、前段が長くなりましたが、ログイン認証を実装したら、おおよそその次に行うであろう下記の方法について解説します。
・ログインしているかしていないかの判別
・ログインしているユーザの情報の取得
ちなみに、いずれも複数の方法があります。
好きな方法を使用すればいいかと思います。
$this->Authentication->getResult()
を使用する方法
ログイン認証の有無の確認方法
まず最初は、「$this->Authentication->getResult()
」を使用する方法です。
1 2 3 4 5 6 |
$result = $this->Authentication->getResult(); if ($result && $result->isValid()) { echo "ログインしている"; } else { echo "ログインしていない"; } |
上記の 1行目のように「$this->Authentication
」でログインユーザの値の取得を試行し、値が取得できたらログインできている、という判定を行うというものです。
https://book.cakephp.org/5/ja/tutorials-and-examples/cms/authentication.html#id3
この処理は、先に紹介した「CMS チュートリアル – 認証」の「ログイン追加」の項目にある「public function login()」で追加する、ログイン認証処理に記載がある方法です。
ログイン認証で使用する処理として Cookbookに紹介してあるくらいですので、非常に信頼できる方法かと思います。
ログインユーザの情報の取得方法
この方法で取得した「$result」には、ログイン認証の結果、および、ログインユーザの情報が入っています。
1 2 3 4 5 |
// ログイン認証を通過している場合は「SUCCESS」が取得できる $this->Authentication->getResult()->getStatus(); // $result を使用する場合は下記となる $result->getStatus(); |
上記の方法でログインの状態のステータスを取得することができます。
取得できるステータスの種類については下記を参照してください。
Cookbook Authentication3.x 認証 Component - ログイン状態を確認する
https://book.cakephp.org/authentication/3/ja/authentication-component.html#id2
この記事ではいろいろなログインユーザの情報を取得する処理を紹介していますが、このログインの状態を取得できる処理は多くないため、その点からこの「getResult()」を使用する処理が一番無難なような気がします。
また、上記の取得できるステータスを元に、下記のようにログイン判定をすることもできます。
1 2 3 4 5 |
if ($this->Authentication->getResult()->getStatus() == "SUCCESS") { echo "ログインしている"; } else { echo "ログインしていない"; } |
ログインしているユーザ情報を取得する場合は下記のように記述します。
1 2 3 4 5 6 7 8 |
// ->getData() でログインユーザ全体の情報が取得できる $loginUser = $this->Authentication->getResult()->getData(); // さらにカラム名を指定する事でそのカラムの値を取得できる // 下記は「Users.name」というカラムがある想定 $name = $this->Authentication->getResult()->getData()->name; $name = $this->Authentication->getResult()->getData()["name"]; $name = $loginUser->name; |
$this->request->getAttribute('identity')
を使用する方法
ログイン認証の有無の確認方法
次は、「$this->request->getAttribute('identity')
」を使用する方法です。
1 2 3 4 5 6 |
$result = $this->request->getAttribute('identity'); if($result){ echo "ログインしている"; } else { echo "ログインしていない"; } |
上記の 1行目のように「getAttribute('identity')
」でログインユーザの値の取得を試行し、値が取得できたらログインできている、という判定を行うというものです。
先の「$this->Authentication
」を使用する方法は、ログインしていない状態でも認証の可否などの情報を持っていますので、「$result」は「空」ではないですが、この「getAttribute('identity')
」の処理は、認証できなかった場合は nullが戻ってくるため、上記のような判定になります。
https://book.cakephp.org/authentication/3/ja/identity-object.html
この処理は、上記の「Identity Objects」の解説に書いてある方法です。
私はこの方法を最初に知りましたので「getAttribute(‘identity’)」をメインに使っていましたが、取得できる情報は、先の「$this->Authentication
」で取得できる情報とほぼ変わらない上に、ステータスは取得できないため、今後は「$this->Authentication
」をメインに置き換えようと考えています。
ログインユーザの情報の取得方法
この方法で取得した「$result」には、ログインユーザの情報が入っています。
1 2 3 4 5 6 7 8 |
// カラム名を指定する事でそのカラムの値を取得できる(下記 3つの方法がある) $name = $this->request->getAttribute('identity')->name; $name = $this->request->getAttribute('identity')->get("name"); $name = $this->request->getAttribute('identity')["name"]; // 一度変数に入れる場合は下記のような記述になる $result = $this->request->getAttribute('identity'); $name = $result->name; |
$this->request->getAttribute('authentication')
を使用する方法
ログイン認証の有無の確認方法
続いては、「$this->request->getAttribute('identity')
」を使用する方法です。
1 2 3 4 5 |
if ($this->request->getAttribute('authentication')->getResult()->getStatus() == "SUCCESS") { echo "ログインしている"; } else { echo "ログインしていない"; } |
上記の 1行目のように「$this->request->getAttribute('authentication')->getResult()->getStatus()
」で、ステータスが取得できますので、「SUCCESS」の場合は、ログインできている、と判別することができます。
ちなみに、一番最初の
「$this->Authentication->getResult()
」
と
「$this->request->getAttribute('authentication')->getResult()
」
は、まったく同じ情報を取得できます。
これは、「$this->Authentication
」が「$this->request->getAttribute('authentication')
」のエイリアスのような存在だからです。
厳密には、異なるようですが。
ログインユーザの情報の取得方法
上記のことから、ログインしているユーザ情報を取得する方法も「$this->Authentication
」と同じで、下記のように取得することができます。
1 2 3 4 5 6 7 |
// ->getData() でログインユーザ全体の情報が取得できる $loginUser = $this->request->getAttribute('authentication')->getResult()->getData(); // さらにカラム名を指定する事でそのカラムの値を取得できる // 下記は「Users.name」というカラムがある想定 $name = $this->request->getAttribute('authentication')->getResult()->getData()->name; $name = $this->request->getAttribute('authentication')->getResult()->getData()["name"]; |
$this->getRequest()->getSession()->read('Auth')
を使用する方法
ログイン認証の有無の確認方法
続いては、「$this->getRequest()->getSession()->read('Auth')
」を使用して、セッション情報からログイン情報を取得する方法です。
1 2 3 4 5 |
if ($this->getRequest()->getSession()->read('Auth')) { echo "ログインしている"; } else { echo "ログインしていない"; } |
上記の 1行目の「$this->getRequest()->getSession()->read('Auth')
」でログインユーザ情報の取得を試行し、値が取得できたらログインできている、という判定を行うというものです。
ログインできていない場合は nullが返ってきます。
ログインユーザの情報の取得方法
取得できる情報は、一番最初の「$this->Authentication->getResult()
」で取得できるユーザ情報と同じです。
ログイン認証できたユーザ情報をセッションに持たせているだけですので。
そのため、ユーザ情報を取得する方法は、セッション情報の取り扱い方と同じです。
1 2 3 4 5 6 |
// カラム名を指定する事でそのカラムの値を取得できる // 下記は「Users.name」というカラムがある想定 $name = $this->getRequest()->getSession()->read('Auth')->name; $name = $this->getRequest()->getSession()->read('Auth')->get("name"); $name = $this->getRequest()->getSession()->read('Auth.name'); $name = $this->getRequest()->getSession()->read('Auth')["name"]; |
View Helperを使用する方法
ログイン認証の有無の確認方法
最後は、View Helperを使用する方法です。
これは、View Helperの言葉の通り、Controllerではなく Viewでのみ使用可能です。
まず初めに、「/src/View/AppView」の「initialize」に下記の 6行目のコードを追加します。
1 2 3 4 5 6 7 8 |
public function initialize(): void { parent::initialize(); // ログインユーザ情報を取得するための Helper $this->loadHelper('Authentication.Identity'); } |
その上で、認証情報を利用をしたい Viewファイルに下記を記載します。
1 2 3 4 5 |
if ($this->Identity->isLoggedIn()) { echo "ログインしている"; } else { echo "ログインしていない"; } |
上記の 1行目の「$this->Identity->isLoggedIn()
」で、ログイン認証の可否を取得できますので、それで判別します。
具体的には、ログインできているときは「true」、できていないときは「false」が返ってきます。
ログインユーザの情報の取得方法
ログインしているユーザ情報は下記のように取得することができます。
1 2 3 |
// カラム名を指定する事でそのカラムの値を取得できる // 下記は「Users.name」というカラムがある想定 $name = $this->Identity->get("name"); |
機能として提供されてはいますが、使うことはほとんどないのではないか、という感じがします。
認証情報はコントローラーでも使うと思いますので、コントローラーで取得したものをビューに渡して使用する方が自然な流れなような気がしますので。
ログアウトは$this->Authentication->logout()
を実行する
最後に、ログアウトをするときの処理を書いておきます。
コントローラーの中に下記を書いておけば、そこでログアウトします。
1 |
$this->Authentication->logout(); |
CakePHP5の関連記事
CakePHP4、5のユーザ認証でID、PASS以外の削除フラグなども条件加える方法CakePHP4、CakePHP5系の認証処理でログインの有無の確認、ユーザ情報の取得の方法
CakePHP4、5で$_SERVERと同じようにURIを取得する「getUri()」の紹介
getParam('action')
で取得するアクション名は別関数に移動しても不変CakePHP4系、CakePHP5系のexists()でカラムを指定して値の有無をチェックする方法解説
CakePHP4、5のnewEmptyEntityで作成したオブジェクトは空なのか、確認してみた
CakePHP4、5でSELECT telephone as tel FROM usersの様にasでカラムに別名を付ける方法
CakePHP4、5の認証処理で認証が通らない際の確認方法と確認箇所の紹介
CakePHP5系で認証機能のAuthenticationプラグインをインストール・エラー発生注意
CakePHP5でヘルパーから他のヘルパーを読み込む方法・CakePHP4からの変更点
その他の「CakePHP5」に関する記事一覧
GoogleAdwords
GoogleAdwords
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです!
関連記事
-
-
国際化と地域化の翻訳機能「__()」を使って定数に変数を埋め込む方法
CakePHP4で定数に変数を埋め込み、翻訳機能「__()」で変数に値を入れる方法を紹介。定型の文章の一部だけを置換したい場合に利用すると便利。
-
-
CakePHP3のfriendsofcake/searchでツリーカテゴリーの子階層も含めて検索する方法
CakePHP3のツリービヘイビアを使ったツリーカテゴリーの子階層も含めての検索を検索プラグイン「friendsofcake/search」を使って実現する方法を解説しました。
-
-
CakePHP 2.3 Search Pluginで検索処理 その1設置方法
CakePHPの検索プラグイン Search Pluginの設置方法と基本的な検索処理の解説です。
-
-
CakePHP4から外部のデータベースにアクセスする方法解説
CakePHP4のシステムから他のシステムのデータベースにアクセスをし、SQL文を実行する方法を解説。try-catchでエラーを取得する方法も解説。
-
-
CakePHP3にデイトピッカー jQuery UI DatePickerを実装する手順の解説
CakePHP3にjQuery UIのDatePickerを実装する手順を説明。併せて、デイトピッカーを設置に関連するCakePHP3の解説と、テーマを変更したり、表記を変更するカスタマイズする方法なども紹介。
-
-
CakePHP4、5で$_SERVERと同じようにURIを取得する「getUri()」の紹介
PHPでサーバ情報、環境情報を取得する際は「
$_SERVER
」を利用するが、似たような情報をCakePHPの関数で取得する際は「getUri()
」を使用する。取得出来る値は一致するものもあるが、違うものもあり便利な使い方もある。
-
-
CakePHP3の更新画面でUpload Plugin 3.0を使う方法、viewで使う方法解説・その3
CakePHP3でファイル、画像をアップロードするプラグイン、upload plugin 3を導入する手順を解説した記事。3部作のその3で記事を更新する際のファイルの取り回しなどについてを解説。
-
-
CakePHP3の検索プラグイン「friendsofcake/search」の様々な検索の仕方の実装方法
CakePHP3で検索をするプラグイン「friendsofcake/search」の検索条件のカスタマイズ方法の解説。検索項目を増やしたり、以上、以下での検索や、チェックボックスによる検索の方法などを解説。
-
-
CakePHP3で生の SQLの実行はConnectionManagerを使う
CakePHP3で生の SQL文を実行する方法を解説。クリエビルダーを使う場合は TableRegistryを利用するが、SQLを実行する場合は ConnectionManagerを使う。プリペアードステートメントの使用方法も解説。
-
-
CakePHP 2.3 ID以外のカラムでアソシエーション(連携)をさせる場合
ID以外のカラムでアソシエーション(連携)させるための考え方とサンプルソースを用いての説明を行っています。