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

2024/12/22 2025/01/31

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
　
このほか「+（プラス）」「*（アスタリスク）」「/（スラッシュ）」なども同様のエラーが発生します。
　
「tele-phone」を囲う「"（ダブルクオーテーション）」を「'（シングルクォーテーション）」に変えてもエラーが発生する状況に変化はありませんでした。
　
ちなみに、「_（アンダースコア）」は問題ありませんでした。
　
ご注意ください。
　
　

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

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

Message コメントをキャンセル

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

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

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

: CakePHP5系でDeprecatedを回避しfindListでキーと値のカラムを指定して取得する方法

CakePHP4のfindListでキーと値のカラムを指定してテーブルにアクセスする方法がCakePHP5では「Deprecated（非推奨）」となった。推奨の記述方法を解説。

: CakePHP 2.3 Model、Controllerの見たい変数の中身をログ出力

CakePHPの Modelや Controllerの変数の中身をログとして出力して見る方法を提供します。

: URL短縮サービス「TTTオンライン（https://ttt.onl）」公開

URL短縮サービス「TTTオンライン（https://ttt.onl）」を公開。メールやSNSでは使いにくい長いURLを短いURLに変換するサービス。QRコードも。Google URL Shortenerが2019年3月にサービス終了。

: CakePHP3のルーティング（routes.php）の変更が反映されない時はキャッシュのクリアを

CakePHP3でルーティングの設定変更をしたけど反映されない！そんなときは慌てず騒がずキャッシュをクリアしよう！ルーティングの設定もキャッシュされることがあるらしい。

: CakePHP3でPHPExcelを使ってエクセルファイルを生成、出力する方法

CakePHP3でPHPExcelを利用してエクセルを編集、出力するサンプルソース＋解説。PHPExcelのインストール方法の解説からファイル保存とダウンロードの方法なども解説。

: CakePHP3のプラグイン「CakeDC/Users」を日本語化・翻訳ファイルもダウンロード可

CakePHP3のユーザ管理、ログイン認証プラグインである「CakeDC/Users」のメッセージを日本語にする手順の解説とともに、日本語の翻訳ファイルを提供。ファイルを設置すれば日本語になる！

: CakePHP 2.3　Search Pluginで検索処理　その４前方一致検索、後方一致検索、不等号による検索、between句による範囲検索

CakePHPの検索プラグイン Search Pluginの検索処理の中で前方一致検索、後方一致検索、不等号による検索、between句による範囲検索の解説です。

: Windows環境の XAMPPを利用して CakePHPの開発する際の注意点

WindowsベースにXAMPPで環境を構築しCakePHP4を利用したWebシステムを構築する際は、大文字と小文字の違いを意識する必要がある。LinuxベースのWebサーバに移動させたときに不具合で動作しないこともある。