CakePHP4の数値項目は「like %10%」の部分一致検索(find select)はできない
2024/08/10
CakePHP4で数値項目のlike句の部分一致検索はできない
CakePHPの数値項目に対しては、下記のように like句を使用した select文は実行できないようです。
SELECT * FROM users WHERE income like '%100%';
CakePHP4で数値項目のlike句の部分一致検索はできないことの実例
like句の部分一致検索用のサンプルテーブル
下記のようなテーブルがあったとします。
1 2 3 4 5 6 7 8 9 |
CREATE TABLE `users` ( `id` smallint(6) NOT NULL UNIQUE COMMENT 'ユーザID', `name` varchar(50) NOT NULL COMMENT '氏名', `income` int(11) DEFAULT NULL COMMENT '収入', `created` datetime NOT NULL DEFAULT now() COMMENT '登録日時', `modified` datetime NOT NULL DEFAULT now() COMMENT '更新日時', PRIMARY KEY (`id`), UNIQUE KEY `id_UNIQUE` (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='ユーザーテーブル'; |
このテーブルに対して、CakePHPのクリエビルダーを使用して、「name(varchar型)」と「income(int型)」に対して「like 句」を使用してレコード検索をしてみました。
「name(varchar型)」に対する like句の部分一致検索は問題ない
「name」のように文字型の場合は下記の記述方法で何も問題は発生しません。
「%」を囲む文字は「’(シングルクォート)」で囲っても、「”(ダブルクォート)」で囲っても問題はありません。
1 2 3 4 |
$conditions = [ "name like" => "%" . $this->request->getParam("name") . "%" ]; $this->Users->find()->where($conditions); |
「income(int型)」に対する like句の部分一致検索はエラーが発生する
対して、数値項目である「income」に対して「%」ワイルドカードを使用した部分一致検索をしようとするとエラーになります。
1 2 3 4 |
$conditions = [ "income like" => "%" . $this->request->getParam("income") . "%" ]; $this->Users->find()->where($conditions); |
上記を実行すると
「Cannot convert value of type string to integer」
というエラーが出ます。
「『income』は数値項目だけど、検索対象の文字列『%100%』は数値に変換できませんよ」というエラーです。
そんなエラーですので、「%」を囲む文字を「’(シングルクォート)」「”(ダブルクォート)」のどちらにしても同じエラーが出ます。
「(バッククォート)」を使用するとエラーは出ないが部分一致検索はできていない
ちなみに、
下記のように「(バッククォート)」を使用すると、エラーは出なくなりますが、「%」が機能しなくなり、完全一致でないと対象レコードを取得できなくなります。
1 2 3 4 |
$conditions = [ "income like" => `%` . $this->request->getParam("income") . `%` ]; $this->Users->find()->where($conditions); |
この「`(バッククォート)」で囲むと「%」が機能しなくなるのは、「income(int型)」だけでなく、「name(varchar型)」でも同様でした。
ちなみに、「like」演算子を使っていてもワイルドカードを使用しない下記のような記述方法であればエラーは発生しません。
当然ですね。入力された値を数値として処理できますので。
1 2 3 4 |
$conditions = [ "income like" => $this->request->getParam("income") ]; $this->Users->find()->where($conditions); |
ただ、ワイルドカードを使えないのであれば like検索をする必要性がないわけですが...
「income(int型)」に対する「_」を使用するパターンマッチングもエラーが発生する
like句での検索には、「_(アンダースコア、アンダーバー)」を使用したパターンマッチングもあります。
select * from users where income like "100_100";
「income(int型)」の項目に対しては、「_(アンダースコア、アンダーバー)」を利用したパターンマッチングもエラーが発生します。
1 2 3 4 |
$conditions = [ "income like" => "100_" . $this->request->getParam("income") ]; $this->Users->find()->where($conditions); |
「%」を使用した部分一致検索と同様に
「Cannot convert value of type string to integer」
というエラーです。
「_(アンダースコア)」は数値に変換できませんので、まぁ、同じエラーが出るだろうな、ということは予想できることですね。
※「name(varchar型)」の方は「_(アンダースコア)」を使用したパターンマッチングも問題なく実行できます。
「income(int型)」に対する部分一致検索の問題は SQLクリエービルダーの問題
今回紹介した CakePHP4において、数値型カラムに対して like句を使用した部分一致検索で発生するエラーの問題は、CakePHPの SQLのクリエービルダーの不具合によるもののようです。
下記のようにクリエビルダーを使わずに直接 SQLを実行する方法ではエラーは発生せず、想定したレコードが取得でることからも判断できます。
1 2 3 4 |
$connection = ConnectionManager::get('default'); $users = $connection ->execute("SELECT * FROM users WHERE income like '%100%'") ->fetchAll('assoc'); |
数値項目を like句を使用した部分一致検索をする場面は多くないと思いますが、どうしても「数値項目を部分一致検索したい!」という場合は上記のようにクリエビルダーを使用せずに直接 SQLを記述する方法が検討に入るのではないか、と思います。
その他の方法としては、int型をやめて varchar型にする、などでしょうか...
もし、こうすれば出来るよ、と言う方法があればご教授ください!
今回の参考サイトは下記になります。
CakePHP4 クリエービルダー
https://book.cakephp.org/4/ja/orm/query-builder.html
「シングルクォート」「ダブルクォート」「バッククォート」の違いについては、下記の記事などが参考になるかと思います。
記事自体は Linuxのコマンドに関する記事ですが、PHPでも基本的な扱いは同じです。
https://www.server-memo.net/shellscript/quart.html
CakePHP4の関連記事
CakePHP4のFrozenDateで1ヵ月前、先月、今月1日、来月末の日付などを算出する方法CakePHP4のcake cache clear_allでPermission deniedはパーミッションの変更が必要
CakePHP4のクリエビルダーを使用してOR条件をAND条件でつなぐSQL文を作る方法
CakePHP4のController内でViewテンプレート、レイアウトの変更設定を記述する方法
CakePHP4から外部のデータベースにアクセスする方法解説
CakePHP4の数値項目は「like %10%」の部分一致検索(find select)はできない
CakePHP4でロギングスコープやログレベルを使用してログを出し分ける方法を解説
CakePHP2、CakePHP3、CakePHP4、CakePHP5のバージョンを調べる 2つの方法
Windows上のXAMPP環境のCakePHPのコマンド実行時に環境変数を指定する方法
CakePHP4で複数の引数(パラメータ)を付与してコマンドを実行する方法
その他の「CakePHP4」に関する記事一覧
GoogleAdwords
GoogleAdwords
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです!
関連記事
-
CakePHP2、CakePHP3、CakePHP4、CakePHP5のバージョンを調べる 2つの方法
CakePHPのバージョンの調べ方2点を紹介。CakePHP3~CakePHP5は共通だが CakePHP2はフォルダ構成が異なるためコマンドのパスもオプションも異なる。
-
CakePHP3のCakeDC/Users、Authでログインなしでもアクセスを許可する設定
CakePHP3の Authコンポーネントや CakeDC/Usersプラグインなどを利用したユーザ管理・認証システムにおいて、ログインしていなくても見ることができるページの設定方法を解説。
-
CakePHP3にWYSIWYGエディタのCKEditor4を設置、カスタマイズ方法を解説
WYSIWYGエディタであるCKEditor4をCDNを利用して簡単にCakePHP3に導入する方法とカスタマイズする方法を解説。CakePHP3にはページごとの振り分けを行うブロック化を利用する。
-
CakePHP4のController内でViewテンプレート、レイアウトの変更設定を記述する方法
CakePHP4でテンプレートやレイアウトファイルをデフォルトから変更する場合は「render()」を使用するが、記述場所はできるだけコントローラー内の最後の方に書く方がいい。
-
cakephp3 カスタムバリデーションを簡易的に実装する方法
CakePHP3の独自のバリデーションをテーブルクラス内に簡単に記述する方法を解説。他のテーブルクラスでは使えないが、記述する量は少なく実装できるため、他で使わない処理を書くのには便利。
-
CakePHP3でシェルを作成しコマンドラインから実行・CakePHP2との違い
CakePHP3のシェルスクリプトを作成し、コマンドラインから実行する方法を解説。複数単語をつなげる場合の対応方法がCakePHP2より制限が厳しくなったのでCakePHP3の命名規則の確認が必要だ。
-
CakePHP3でPHPExcelを使ってエクセルファイルを生成、出力する方法
CakePHP3でPHPExcelを利用してエクセルを編集、出力するサンプルソース+解説。PHPExcelのインストール方法の解説からファイル保存とダウンロードの方法なども解説。
-
CakePHP3のタイムゾーンを協定世界時UTCから日本標準時間JSTにずれを変更する方法
CakePHP3の標準設定のタイムゾーンは「UTC(協定世界時)」に設定されている。これを日本標準時に変更する方法(app.php、bootstrap.phpの変更方法)の解説。
-
Windows上のXAMPP環境のCakePHPのコマンド実行時に環境変数を指定する方法
CakePHP4のコマンド(シェル)に対して、環境変数を指定して実行する方法を解説。LinuxとWindows上のXAMPPとでは記述方法が異なるため、Windowsのsetコマンドについても詳細解説。
-
CakePHP3で生の SQLの実行はConnectionManagerを使う
CakePHP3で生の SQL文を実行する方法を解説。クリエビルダーを使う場合は TableRegistryを利用するが、SQLを実行する場合は ConnectionManagerを使う。プリペアードステートメントの使用方法も解説。