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

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

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

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

SELECT telephone as tel FROM users;

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

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

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

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

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

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

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

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

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

$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」を囲う「"（ダブルクオーテーション）」を「'（シングルクォーテーション）」に変えてもエラーが発生する状況に変化はありませんでした。
　
エラーとならなかったのが「_（アンダースコア）」です。
記号でエラーにならないのはこの「_（アンダースコア）」だけだと思います。
　
ご注意ください。
　
　

CakePHP5の関連記事