CakePHP3で他のテーブルのマスタテーブルからセレクトボックス（プルダウンリスト）を作る

2017/03/04 2019/07/22

CakePHP3で他のテーブルのマスタテーブルからセレクトボックスを作る

　
マスタのテーブルを作成し、そのマスタテーブルの情報を基にしてセレクトボックス（プルダウンリスト）を作成する方法を解説します。
　
具体的には、下記の「Master Roles（権限マスタ）」の項目をテーブルから取得するイメージです。
　

　
　

想定しているテーブル

　
想定しているテーブルは、以下の「ユーザテーブル」と「権限マスタテーブル」です。
　
ユーザ情報に、権限マスタから権限情報を編集できるようにしたのち、ユーザ認証機能を実装し、ユーザの持つ権限によって利用できる機能、できない機能を振り分けることを想定しています。
そのために、ユーザ情報の登録の際に「権限」をプルダウン（セレクトボックス）で選択できるようにする、というのが趣旨になります。
　
【ユーザテーブル】

CREATE TABLE `users` (
  `id` int(11) NOT NULL AUTO_INCREMENT PRIMARY KEY,
  `username` varchar(255) NOT NULL,
  `password` varchar(255) NOT NULL,
  `master_roles_id` char(2) NOT NULL,
  `email` varchar(255) NOT NULL,
  `created` datetime NOT NULL,
  `modified` datetime NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

CREATE TABLE `users` (

`id` int(11) NOT NULL AUTO_INCREMENT PRIMARY KEY,

`username` varchar(255) NOT NULL,

`password` varchar(255) NOT NULL,

`master_roles_id` char(2) NOT NULL,

`email` varchar(255) NOT NULL,

`created` datetime NOT NULL,

`modified` datetime NOT NULL

) ENGINE=InnoDB DEFAULT CHARSET=utf8;

　
【権限マスタ】

CREATE TABLE `master_roles` (
  `id` int(11) NOT NULL AUTO_INCREMENT PRIMARY KEY,
  `name` varchar(255) NOT NULL,
  `delete_flag` char(1) DEFAULT NULL,
  `created` datetime NOT NULL,
  `modified` datetime NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

CREATE TABLE `master_roles` (

`id` int(11) NOT NULL AUTO_INCREMENT PRIMARY KEY,

`name` varchar(255) NOT NULL,

`delete_flag` char(1) DEFAULT NULL,

`created` datetime NOT NULL,

`modified` datetime NOT NULL

) ENGINE=InnoDB DEFAULT CHARSET=utf8;

　
想定しているテーブルは上記のような形で、「ユーザテーブル」の 4項目目に「権限マスタ」の IDを編集することを想定しています。
　
　

PHPフレームワーク CakePHP 3入門

セレクトボックスを作成するサンプルプログラム

　
基本的な処理は「cake bake all users」コマンドで生成しています。
そのうえで、加える処理についての解説です。
　
　

/src/Controller/UsersController.php の変更

　
下記のとおり、コントローラーの最初の方に「use Cake\ORM\TableRegistry;」を追記します。
これを追記することで、コントローラーに関連しない他のテーブルの情報を取得することができるようになります。
　

<?php
namespace App\Controller;

use App\Controller\AppController;
use Cake\ORM\TableRegistry;    // この行を追記します。

<?php

namespace App\Controller;

use App\Controller\AppController;

use Cake\ORM\TableRegistry; // この行を追記します。

　
　
続いて、「UsersController」の中に「initialize()」関数を追加します。
7行目の「master_roles」が読み込むテーブル名になり、複数ある場合は複数行記述します。
　

class UsersController extends AppController
{

    // 以下の「initialize()」を追加します。
    // 3.6.0 以降の場合
    public function initialize(){
        parent::initialize();
        $this->MasterRoles = TableRegistry::getTableLocator()->get("master_roles");
    }

    // 3.6.0 より前の場合
    public function initialize(){
        parent::initialize();
        $this->MasterRoles = TableRegistry::get("master_roles");
    }

class UsersController extends AppController

{

// 以下の「initialize()」を追加します。

// 3.6.0 以降の場合

public function initialize(){

parent::initialize();

$this->MasterRoles = TableRegistry::getTableLocator()->get("master_roles");

}

// 3.6.0 より前の場合

public function initialize(){

parent::initialize();

$this->MasterRoles = TableRegistry::get("master_roles");

}

　
2019.07.22　追記
CakePHP3.6から、TableRegistryクラスの使用方法が変更になりました。
そのため、上記のサンプルコードでは両方を併記しています。
　
　
続いて、「initialize()」のすぐ後ろに「beforeFilter()」を追加します。
　

    // 以下の「beforeFilter()」を追加します。
    public function beforeFilter(){
        $masterRolesAll = $masterRolesVaild = array();
        foreach ($this->MasterRoles->find()->all() as $tmp){
            $masterRolesAll += array ($tmp->id => $tmp->name);
            if ($tmp->delete_flag != "1"){
                $masterRolesVaild += array ($tmp->id => $tmp->name);
            }
        }
        $this->set(compact("masterRolesAll","masterRolesVaild"));
    }

// 以下の「beforeFilter()」を追加します。

public function beforeFilter(){

$masterRolesAll = $masterRolesVaild = array();

foreach ($this->MasterRoles->find()->all() as $tmp){

$masterRolesAll += array ($tmp->id => $tmp->name);

if ($tmp->delete_flag != "1"){

$masterRolesVaild += array ($tmp->id => $tmp->name);

}

$this->set(compact("masterRolesAll","masterRolesVaild"));

}

　
上記は、「delete_flag」の有無によって変数を 2つに分けています。
プルダウンの生成には、「delete_flag」がないもののみを使いますので、「$masterRolesVaild」の方を使います。
　
ですが、すでにマスタを削除していても、そのマスタの値を持つレコードが残っている可能性がある場合などは、「$masterRolesAll」を使う場合があるのではないか、と思い作成しています。
　
マスタを削除する際に、そのマスタのコードを利用しているレコードをチェックするなど、マスタ管理がしっかりできていてる場合は「$masterRolesVaild」の方だけあれば足りるでしょう。
　
　
ちなみに、ここでのサンプルは、権限マスタから全件取得したうえで、プログラムの処理として、「delete_flag」の値で振り分け処理をしています。
ですが、そもそも権限マスタテーブルから値を取得する際に「delete_flag」によって振り分けたレコードを取得する場合は、下記の様に where句を追加することも可能です。
　

$this->MasterRoles->find()->all()
　　　　　　　　　　　　　　↓変更
$this->MasterRoles->find()->where(["master_roles.delete_flag is" => null]

$this->MasterRoles->find()->all()

　　　　　　　　　　　　　　↓変更

$this->MasterRoles->find()->where(["master_roles.delete_flag is" => null]

　
　
また、「$masterRolesAll」「$masterRolesVaild」の変数を「beforeFilter()」で作成しています。
これは、Usersコントローラーの中のすべてのアクションで使えるようにするためです。（今回は、index、add、editで使うためです。）
　
特定のアクションだけで使えればいい場合は、3～10行目を特定のアクションの中に移しても問題ありません。
　
　

/src/Template/Users/index.ctp の変更

　
index.ctpは、以下のように変更します。
ここでは、一覧表示する際に、権限コードを表示するのではなく、権限名称を表示するようにしています。
　

// 変更前
<td><?= h($user->master_roles_id) ?></td>

// 変更後
<td>
<?php
    if ($user->master_roles_id){
        if (isset($masterRolesVaild[$user->master_roles_id])){
            echo $masterRolesVaild[$user->master_roles_id];
        }
    }
?>
</td>

// 変更前

<td><?= h($user->master_roles_id) ?></td>

// 変更後

<td>

<?php

if ($user->master_roles_id){

if (isset($masterRolesVaild[$user->master_roles_id])){

echo $masterRolesVaild[$user->master_roles_id];

}

</td>

/src/Template/Users/add.ctp の変更

/src/Template/Users/edit.ctp の変更

　
add.ctp、edit.ctpは以下のように変更します。
新規登録、更新の画面では、プルダウンで権限を選択できるようにしています。
セレクトボックス（プルダウン）に編集する値は、「options」に連想配列で、キーと値を渡すだけで作成してくれます。
　

// 変更前
echo $this->Form->input('master_roles_id');

// 変更後
echo $this->Form->input('master_roles_id',
                        ["type"=>"select","empty"=>"選択してください",
                         "options"=>$masterRolesVaild]);

// 変更前

echo $this->Form->input('master_roles_id');

// 変更後

echo $this->Form->input('master_roles_id',

["type"=>"select","empty"=>"選択してください",

"options"=>$masterRolesVaild]);

　
CakePHP3の Form Helperの使い方については、「CakePHP3のForm Helperの使い方のまとめ」に記事を書いていますので参照してください。
　
上記の Form Helperの使い方を読んでもらえば分かりますが、プルダウンリスト（セレクトボックス）をラジオボタン変えたい場合は、「"type"=>"select"」を「"type"=>"radio"」にすれば OKです。
　
また、「"empty"=>"選択してください"」は、最初に nullの値を入れる場合の設定です。
今回の紹介している「権限」は必須項目となるべき項目ですので、「"empty"=>"選択してください"」は消す方が無難かもしれません。
　
また、先ほどの「"type"=>"select"」を記述しなくてもデフォルトでプルダウンリストになりますので、下記の様に短く記述することも可能です。
　

echo $this->Form->input('master_roles_id',
                        ["options"=>$masterRolesVaild]);

1 2	echo $this->Form->input('master_roles_id', ["options"=>$masterRolesVaild]);

取得したテーブルの値のオブジェクトを配列にする方法

今回は、UsersController.phpで配列を生成するという仕組みで構築しましたが、テーブルから取得した値をオブジェクトのまま View側に渡す場合もあるかと思います。

そんな時、特定のレコードを自由に扱えるようにするには配列にする必要があるのだと思いますが、その方法について調べた内容を下記の記事にしていますので、あわせて参考にしてください。
　CakePHP3のビューで受取ったテーブルのオブジェクトを連想配列に変換する方法
　
　

- CakePHP 3.x 4.x 5.x CakePHP3

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

Comment

かみおかより:

2017年4月4日 5:37 PM

まさにこの処理を書きたくてググってたら辿り着きました。私は今回のプロジェクトからCakePHP3で開発を始めたんですが、まだ日本語ノウハウの積みあげはこれからっぽい感じなので、すごく助かりました。ありがとうございます！

返信
- エス技研より:
  
  2017年4月4日 10:10 PM
  
  かみおかさん、コメントありがとうございます！
  書いた記事がお役に立ったということで、すごく嬉しいですね。
  役に立ったという書き込みをいただくだけで、1週間は頑張って仕事ができます！
  引き続き役に立つ記事を書いていきますので、今後もよろしくお願いします！
  
  返信
rinko より:

2017年5月10日 1:41 PM

私もこのコードが書きたくてググりました！
すごくすごく助かりました！ありがとうございます！

返信
- エス技研より:
  
  2017年5月10日 10:00 PM
  
  rinkoさん、コメントありがとうございます！
  役に立ったと言ってもらえるとすごく嬉しいですね。記事を書いた甲斐があった、と思えますからね。
  　
  これがベストプラクティスか分かりませんが、引き続き頑張って記事を書いていきますので、今後ともよろしくお願いします！
  
  返信

Message コメントをキャンセル

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

: URL短縮サービス「TTTオンライン（https://ttt.onl）」公開

URL短縮サービス「TTTオンライン（https://ttt.onl）」を公開。メールやSNSでは使いにくい長いURLを短いURLに変換するサービス。QRコードも。Google URL Shortenerが2019年3月にサービス終了。

: CakePHP3でシェルを作成しコマンドラインから実行・CakePHP2との違い

CakePHP3のシェルスクリプトを作成し、コマンドラインから実行する方法を解説。複数単語をつなげる場合の対応方法がCakePHP2より制限が厳しくなったのでCakePHP3の命名規則の確認が必要だ。

: CakePHP3のOGPはHTMLヘルパーの$this->Html->meta()を使って設定

CakePHP3でOGPを設定する方法を解説。metaタグを編集するHTMLヘルパーを利用してOGPのタグを編集する。また、エレメントとして分割することでメンテナンス性も向上させる。

: CakePHP4のユーザ管理・ログイン認証プラグインCakeDC/Usersのインストール解説

CakePHP4のユーザ管理プラグイン Usersは、ユーザ登録、メール認証、ログイン認証、ユーザ管理、権限管理、reCAPTCHAなど会員制のサイトを簡単に実現可能。その導入方法、カスタマイズ方法を解説。

: CakePHP 2.3　ログイン、操作履歴、アクセスログ出力

CakePHPでログインや操作履歴などのアクセスログ出力処理を作成します。

: CakePHP3でCookieを保存、呼び出し、削除の操作・CakePHP3.7対応

CakePHP3.7でCookieを保存、取り出し、削除する方法を解説。CakePHP3でのCookieの取り扱いはバージョンごとに変更されるため、環境に合わせた方法を探す必要がある。

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

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

: CakePHP4、CakePHP5系の認証処理でログインの有無の確認、ユーザ情報の取得の方法

CakePHP4系、5系のログイン認証の可否のチェック、および、ログインユーザの情報を取得する方法のまとめ。複数の方法があるが手続きが微妙に異なるためまとめてみた。

: CakePHP3にデザインテンプレートBootstrapを導入する方法・friendsofcake/bootstrap-ui使用

CakePHP3にプラグイン「friendsofcake/bootstrap-ui」、デザインテンプレート「Bootstrap」を設置する手順を解説。Bootstrapの簡単な使い方やデフォルトのデザインとの混在方法なども解説。

: CakePHP3でkeywords、DescriptionをHTMLヘルパーを使って設定する

CakePHP3のkeywordsとdescriptionを設定する方法の解説。CakePHP3にはmetaタグを編集するHTMLヘルパーが用意されているためそれを利用すればOK！ポイントはブロック化を有効にすること。