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 コメントをキャンセル

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

: CakePHP5でヘルパーから他のヘルパーを読み込む方法・CakePHP4からの変更点

CakePHP5のヘルパーで他のヘルパーを読み込む方法を解説。公式の日本語CookbookはCakePHP4のソースのままで間違っているため注意が必要。CakePHP4からの移行の際も同じ点に注意が必要。

: CakePHP4のフラッシュメッセージの表示場所、デザインを変更する方法を解説

CakePHP4のエラーメッセージ、完了メッセージなどを表示するフラッシュ処理の解説。Controller、レイアウトファイル、テンプレートファイルでそれぞれ処理を指定する。

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

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

: 国際化と地域化の翻訳機能「__()」を使って定数に変数を埋め込む方法

CakePHP4で定数に変数を埋め込み、翻訳機能「__()」で変数に値を入れる方法を紹介。定型の文章の一部だけを置換したい場合に利用すると便利。

: CakePHP4のCakeDC/Usersの Usersへの接続、バリデーションのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。CakePHP4で使う場合のUsersのカスタマイズとして入力項目のバリデーションの変更を、プラグインのファイルは触らずオーバーライドにより実装する方法を解説する。

: CakePHP4、5の認証処理で認証が通らない際の確認方法と確認箇所の紹介

CakePHP4、5系の認証処理でログイン認証が通らない場合の確認方法、確認箇所を解説。ログ出力し、ステータスを確認するが、ステータスの内容も紹介。それはそのままusernameを変更する際のポイントでもある。

: CakePHP3で保存前にバリデーション結果を取得する2つの方法

CakePHP3でデータベースに値を保存する前にバリデーションを行い、その結果によって処理を振り分ける方法について解説。「$topic->errors()」と「$topic->hasErrors()」の2つの方法がある。

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

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

: Google Analytics APIを CakePHP3で動かしてレポートデータを取得する方法の解説

CakePHP3で Google Analytics APIからレポートデータを取得する処理の解説。PHPのサンプルソースをCakePHP3で動くように改造。加えて、ディメンションやメトリックスを条件に設定する方法なども。

: CakePHP 2.3で PDFを作成する方法を調査「mpdf」「TCPDF」「FPDF」

CakePHPで PDFを編集、出力するには「mpdf」「TCPDF」「FPDF」といったプラグインがあり、使い勝手を比較検討しました。TCPDFが一番良さそうでした。

PREV: CakePHP4でロギングスコープやログレベルを使用してログを出し分ける方法を解説
NEXT: CakePHP4から外部のデータベースにアクセスする方法解説

日	月	火	水	木	金	土
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31

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

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

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

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

「name（varchar型）」に対する like句の部分一致検索は問題ない

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

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

「income（int型）」に対する「_」を使用するパターンマッチングもエラーが発生する

「income（int型）」に対する部分一致検索の問題は SQLクリエービルダーの問題

CakePHP4の関連記事

GoogleAdwords

GoogleAdwords

Message コメントをキャンセル

関連記事

CakePHP5でヘルパーから他のヘルパーを読み込む方法・CakePHP4からの変更点

CakePHP4のフラッシュメッセージの表示場所、デザインを変更する方法を解説

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

国際化と地域化の翻訳機能「__()」を使って定数に変数を埋め込む方法

CakePHP4のCakeDC/Usersの Usersへの接続、バリデーションのカスタマイズ方法解説

CakePHP4、5の認証処理で認証が通らない際の確認方法と確認箇所の紹介

CakePHP3で保存前にバリデーション結果を取得する2つの方法

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

Google Analytics APIを CakePHP3で動かしてレポートデータを取得する方法の解説

CakePHP 2.3で PDFを作成する方法を調査「mpdf」「TCPDF」「FPDF」

WordPress投稿にPHPを記述するショートコードの使い方add_shortcode

コピーコンテンツ対策.htaccessで直リンク禁止しリダイレクトで対応

評価点投票プラグイン10個を比較！WordPressで口コミサイトを構築

BackWPupでバックアップ・リストア（復元）の具体的手順

コンパクトキーボード・KEK-EA9AU・FKB1420の魅力

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

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

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

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

「name（varchar型）」に対する like句の部分一致検索は問題ない

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

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

「income（int型）」に対する「_」を使用するパターンマッチングもエラーが発生する

「income（int型）」に対する部分一致検索の問題は SQLクリエービルダーの問題

CakePHP4の関連記事

GoogleAdwords

GoogleAdwords

Message コメントをキャンセル

関連記事

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