CakePHP4の数値項目は「like %10%」の部分一致検索（find select）はできない

2024/08/01 2024/08/10

CakePHP4で数値項目のlike句の部分一致検索はできない

　
CakePHPの数値項目に対しては、下記のように like句を使用した select文は実行できないようです。
SELECT * FROM users WHERE income like '%100%';
　
　

CakePHP4で数値項目のlike句の部分一致検索はできないことの実例

like句の部分一致検索用のサンプルテーブル

　
下記のようなテーブルがあったとします。
　

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='ユーザーテーブル';

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」のように文字型の場合は下記の記述方法で何も問題は発生しません。
「%」を囲む文字は「’（シングルクォート）」で囲っても、「”（ダブルクォート）」で囲っても問題はありません。
　

$conditions = [
  "name like" => "%" . $this->request->getParam("name") . "%"
];
$this->Users->find()->where($conditions);

$conditions = [

"name like" => "%" . $this->request->getParam("name") . "%"

];

$this->Users->find()->where($conditions);

「income（int型）」に対する like句の部分一致検索はエラーが発生する

　
対して、数値項目である「income」に対して「%」ワイルドカードを使用した部分一致検索をしようとするとエラーになります。
　

$conditions = [
  "income like" => "%" . $this->request->getParam("income") . "%"
];
$this->Users->find()->where($conditions);

$conditions = [

"income like" => "%" . $this->request->getParam("income") . "%"

];

$this->Users->find()->where($conditions);

　
上記を実行すると
「Cannot convert value of type string to integer」
というエラーが出ます。
　
「『income』は数値項目だけど、検索対象の文字列『%100%』は数値に変換できませんよ」というエラーです。
　
そんなエラーですので、「%」を囲む文字を「’（シングルクォート）」「”（ダブルクォート）」のどちらにしても同じエラーが出ます。
　
　

「`（バッククォート）」を使用するとエラーは出ないが部分一致検索はできていない`

　 ちなみに、下記のように「（バッククォート）」を使用すると、エラーは出なくなりますが、「%」が機能しなくなり、完全一致でないと対象レコードを取得できなくなります。
　

$conditions = [
  "income like" => `%` . $this->request->getParam("income") . `%`
];
$this->Users->find()->where($conditions);

$conditions = [

"income like" => `%` . $this->request->getParam("income") . `%`

];

$this->Users->find()->where($conditions);

　
この「`（バッククォート）」で囲むと「%」が機能しなくなるのは、「income（int型）」だけでなく、「name（varchar型）」でも同様でした。
　
　
ちなみに、「like」演算子を使っていてもワイルドカードを使用しない下記のような記述方法であればエラーは発生しません。
当然ですね。入力された値を数値として処理できますので。
　

$conditions = [
  "income like" => $this->request->getParam("income")
];
$this->Users->find()->where($conditions);

$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型）」の項目に対しては、「_（アンダースコア、アンダーバー）」を利用したパターンマッチングもエラーが発生します。
　

$conditions = [
  "income like" => "100_" . $this->request->getParam("income")
];
$this->Users->find()->where($conditions);

$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を実行する方法ではエラーは発生せず、想定したレコードが取得でることからも判断できます。
　

$connection = ConnectionManager::get('default');
$users = $connection
  ->execute("SELECT * FROM users WHERE income like '%100%'")
  ->fetchAll('assoc');

$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
　
　

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

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

Message コメントをキャンセル

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

: CakePHP4のクリエビルダーを使用してOR条件をAND条件でつなぐSQL文を作る方法

CakePHP4のクリエビルダーを使って複数のOR条件をANDでつなぐSQL文を作成する方法を解説。OR条件を記述したwhere句を2つつなげて記述する。

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

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

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

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

: CakePHP3のタイムゾーンを協定世界時UTCから日本標準時間JSTにずれを変更する方法

CakePHP3の標準設定のタイムゾーンは「UTC（協定世界時）」に設定されている。これを日本標準時に変更する方法（app.php、bootstrap.phpの変更方法）の解説。

: CakePHP3で環境変数を設定して本番環境と開発環境を分けて処理をする場合

CakePHP3で開発環境と本番環境とで違う設定ファイルを読み込ませて環境ごとに定数を切り替える方法を解説。Apacheのhttpd.confに環境変数を設定し、それを読み込み判別する。

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

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