CakePHP4、5でSELECT telephone as tel FROM usersの様にasでカラムに別名を付ける方法

2024/12/22 2025/10/25

CakePHP4、5のクエリビルダーを使用してカラムに別名を付与する方法

SQLでカラムに別名を付与して値を取得する方法

　
SQL文で、取得するカラム名と違う別名を付けて値を取得する場合は、下記のように「as」を使用してカラムの別名を指定します。
　

SELECT telephone as tel FROM users;

1	SELECT telephone as tel FROM users;

　
上記の例は、usersテーブル内のカラム名は「telephone」ですが、短い「tel」という別名に変更して取得します。
　
　
CakePHP4、CakePHP5で、この「as」を使用してカラムの別名を指定する処理の実装方法を解説します。
　
　

CakePHP4、5のクエリビルダーを使用してカラムに別名を付与する方法

　
下記は、基本的な処理であるテーブル内のカラム名である「telephone」として値を取得する処理です。
　

$select = [
  "telephone"
];
$users = $this->Users->find()->select($select);

$select = [

"telephone"

];

$users = $this->Users->find()->select($select);

　
　
これに対して、「telephone」のカラムの値を「tel」として取得する場合は、「$select」に指定している配列のキーとして「tel」を指定すれば OKです。
　

$select = [
  "tel" => "telephone"
];
$users = $this->Users->find()->select($select);

$select = [

"tel" => "telephone"

];

$users = $this->Users->find()->select($select);

　
　
仕組みが分かっていれば非常に簡単です。
　
　

CakePHP4、5のクエリビルダーを使用してカラムに別名を付与する際の注意点

　
処理自体は特に問題なく簡単なのですが、いろいろ試してみた結果、「as」で指定する項目名には「-（ハイフン）」を使用することができない、ということが分かりました。
　

$select = [
  "tele-phone" => "telephone"
];

$select = [

"tele-phone" => "telephone"

];

　
具体的には上記の「tele-phone」のように「-（ハイフン）」を入れると、下記のようなエラーが発生します。
　
SQLSTATE[42000]: Syntax error or access violation: 1064 You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use near '-amount AS telephone...' at line 1
　
その理由は、「-」は SQLでも使用する四則演算子（マイナス、減算演算子）であるため、演算をしようとしていると解釈されてしまうため、「Syntax error or access violation」となるのです。
　
そのため、同じ四則演算子である「+（プラス）」「*（アスタリスク）」「/（スラッシュ）」「=（イコール）」も同様のエラーが発生します。
さらに、プログラムで演算子として使用される「%」「!」「&」「()」などの記号はすべて同様にエラーとなります。
　
また、「tele-phone」を囲う「"（ダブルクオーテーション）」を「'（シングルクォーテーション）」に変えてもエラーが発生する状況に変化はありませんでした。
　
エラーとならなかったのが「_（アンダースコア）」です。
記号でエラーにならないのはこの「_（アンダースコア）」だけだと思います。
　
ご注意ください。
　
　

- CakePHP 3.x 4.x 5.x CakePHP5

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

Message コメントをキャンセル

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

: CakePHP4、CakePHP5の「warning: DebugKit is disabling．．．」の対処方法

CakePHPのデバッグ用のツールであるDebugKitは適切な設定をしないとエラーログにワーニングメッセージが出力される。それを解消する方法を解説。

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

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

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

CakePHP4でテーブルの数値項目に対してlike句を使用した部分一致検索を実行するとエラーが発生する。クリエービルダーの不具合だと思われ対処方法が分からない。

: CakePHP3でDocumentRootやtmp、webroot、logsなどのフォルダへのパスの定数

CakePHP3で特定フォルダのパスの定数を解説。root、DocumentRoot、app、config、webroot、tests、tmp、cache、vendor、コア、コアの srcが設定済み。realpath()関数を使うと柔軟なパス指定が可能。

: CakePHP3でQRコードを作成、表示するライブラリ「cakePHP-QR-Code-Helper」

CakePHPでQRコードを生成するライブラリ「cakePHP-QR-Code-Helper」の紹介。GDライブラリのインストールも必要ないHelperとして提供されているため、ファイルを設置すればすぐに使用可能。

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

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

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

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

: CakePHP3で画像・ファイルのアップロード処理を自作・解説付き・その２

ファイルのアップロード機能の自作サンプルコードとその解説のその２。アップロード機能に関連するファイルの更新や削除の処理や画像、フォルダのパスの指定方法などを含めて解説。

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

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