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 CakePHP4

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

Message コメントをキャンセル

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

: CakePHP 2.3で確認画面付きのお問い合わせフォームの作り方

CakePHPで確認画面付きのお問い合わせフォーム、メールフォームの作り方をサンプルを提示しながら解説。

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

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

: CakePHP3のインストールでURL rewriting……のエラーが！その解決方法解説

CakePHP3をインストールしたら URL rewriting is not properly configured.のエラーが。原因は.htaccessが有効になっていないこと。httpd.confに設定を追加すればOK。

: CakePHPで同一テーブル内の値を比較する条件でレコードを取得する方法

CakePHPの同一テーブルにある項目の値を比較し条件に合致するレコードを取得する方法を解説。［”項目名”=>”値”]ではなく[”項目名 = 項目名”］と書くところがポイント。

: CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合の詳細ページの注意点

ID以外のカラムでアソシエーション（連携）させて詳細ページを表示させる際の考え方と注意点をサンプルソースを用いて解説しています。

: CakePHP4のCakeDC/Usersのログイン時のリダイレクトとユーザ権限管理の設定解説

CakeDC謹製UsersプラグインのCakePHP4版の紹介。ログイン認証後にリダイレクトする先の設定方法についての解説と実運用するために必要なコツを解説。便利な仕組みも仕様の理解があって初めてうまく使いこなせる。

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

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

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

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