こんにちは！Haxeの世界へようこそ。
今回は、Haxeの真骨頂である「マクロ（Macro）」と、堅牢なクロスプラットフォーム開発を支える「PHPターゲット連携」の深淵を覗いてみましょう。
他の言語からHaxeにやってきた開発者の多くが、PHPターゲットを使う際に直面する最初の「退屈な壁」があります。それは、PHP特有の冗長なボイラープレート（決まりきったコード）、特にGetterとSetterの記述です。
「プロパティをカプセル化したいだけなのに、なぜ毎回 `getProperty()` と `setProperty()` を手で書かないといけないんだ……」
そんなPHPの古いお作法に悩む必要はもうありません。Haxeのコンパイル時マクロを使えば、たった一言のアノテーション（メタデータ）を付与するだけで、必要なPHPコードを裏側で全自動生成できるようになります。
ここをクリアすれば、あなたのHaxe開発スキルは間違いなく一段上のステージに到達しますよ。さあ、一緒にマスターしていきましょう！
—
1. なぜPHPターゲットでボイラープレートが発生するのか？
Haxeは非常に洗練された言語仕様を持っており、プロパティに対して以下のような美しい構文（ネイティブプロパティ）を提供しています。
class User {
// Haxeの標準機能によるプロパティ（これだけでGetter/Setterが機能する）
public var name(default, set):String;
function setName(v:String):String {
return this.name = v.toUpperCase();
}
}
しかし、これをPHPターゲットにトランスパイルした際、古いPHPバージョンや特定のフレームワーク（あるいはマジックメソッドを使いたくないパフォーマンス重視の設計）において、明示的なメソッド群が必要になるケースや、構造をよりPHPのクラス規準に寄せたい場合があります。
さらに、データクラスやDTO（Data Transfer Object）を作る際、何十個ものフィールドに対して似たようなGetter/Setterを並べるのは、エンジニアの創造性を奪う苦行でしかありませんよね。
ここでHaxeのマクロが登場します。「人間はシンプルな構造だけを記述し、面倒なボイラープレートはコンパイラに書かせる」。これがHaxeを掌握するプロフェッショナルのアプローチです。
—
2. 解決策：マクロでGetter/Setterを自動生成する
今回は、クラスに `@:autoGetSet` というカスタムメタデータ（アノテーション）を付与するだけで、そのクラス内のすべての `public var` に対し、対応する `getXXX()` と `setXXX()` メソッドをコンパイル時に自動注入するビルドマクロを作成します。
全体像のイメージ
[ あなたが書くHaxeコード ]
@:autoGetSet
class Product {
public var price:Int;
}
↓ (Haxeコンパイラのビルドマクロが自動変換)
[ 生成される抽象構文木（AST） & PHPコード ]
class Product {
public var price:Int;
public function getPrice():Int { return this.price; }
public function setPrice(v:Int):Int { return this.price = v; }
}
それでは、実際に動くコードを見ていきましょう。
—
3. 実装コード：ビルドマクロの作成
Haxeのマクロは、「コードを書くコード」です。コンパイルの途中でAST（抽象構文木）を書き換えます。
プロジェクト内に `AutoGetSetMacro.hx` というファイルを配置してください。
import haxe.macro.Context;
import haxe.macro.Expr;
if macro
using haxe.macro.Tools;
end
class AutoGetSetMacro {
/
- ビルドマクロのエントリーポイント
/
public static macro function build():Array
// 現在コンパイル対象となっているクラスのフィールド（変数や関数）を取得
var fields = Context.getBuildFields();
// 既存のフィールドを走査して、変数（var）を見つける
var newFields:Array
for (field in fields) {
// フィールドをそのまま新しいリストに追加
newFields.push(field);
// 対象が変数（FVar）であり、かつ static でないものに絞り込む
switch (field.kind) {
#if macro
case FVar(t, expr):
var fieldName = field.name;
// 先頭文字を大文字にしてメソッド名を作る (e.g. price -> Price)
var capitalized = fieldName.substr(0, 1).toUpperCase() + fieldName.substr(1);
var getName = “get” + capitalized;
var setName = “set” + capitalized;
// 既に同名のGetter/Setterが手動で定義されているかチェック（重複回避）
var hasGet = fields.exists(f -> f.name == getName);
var hasSet = fields.exists(f -> f.name == setName);
// Getterがなければ自動生成
if (!hasGet) {
newFields.push({
name: getName,
access: [APublic],
kind: FFun({
args: [],
ret: t,
expr: macro return $i{fieldName}
}),
pos: field.pos
});
}
// Setterがなければ自動生成
if (!hasSet) {
newFields.push({
name: setName,
access: [APublic],
kind: FFun({
args: [{ name: “value”, type: t }],
ret: t,
expr: macro return $i{fieldName} = value
}),
pos: field.pos
});
}
#end
default:
// 変数以外（関数やコンストラクタなど）は何もしない
}
}
return newFields;
}
}
コードのここがポイント！
- `Context.getBuildFields()`: クラスが持っているメンバ変数やメソッドのリストを取得します。ここに新しいフィールドを「追加」することで、コードをその場で拡張できます。
- `macro return $i{fieldName}`: Haxeの「クォーテーションマクロ（reify）」と呼ばれる強力な構文です。`$i{}` を使うことで、文字列変数（この場合はフィールド名）を安全にコード内の識別子として埋め込むことができます。
—
4. 実際に使ってみよう（使用例）
先ほど作成したマクロを、実際のクラスで使ってみましょう。`Main.hx` を作成します。
// クラスにビルドマクロを指定
@:build(AutoGetSetMacro.build())
class UserAccount {
public var username:String;
public var balance:Int;
public function new(username:String, balance:Int) {
this.username = username;
this.balance = balance;
}
}
class Main {
static function public main() {
var user = new UserAccount(“HaxeCoder”, 1000);
// マクロによって自動生成されたメソッドを呼び出す！
trace(user.getUsername()); // 出力: HaxeCoder
user.setBalance(1500);
trace(user.getBalance()); // 出力: 1500
}
}
これをPHPターゲットとしてコンパイルし、出力されたPHPコードを確認してみてください。人間は `username` と `balance` というシンプルな変数定義しか書いていないにもかかわらず、PHP側にはしっかりと `getUsername()` や `setBalance()` が生成されていることが確認できます。これがHaxeマクロの魔法です！
—
5. 初学者が陥りやすい文法エラーと注意点
Haxeのマクロ開発やPHP連携において、初心者がハマりがちなポイントを先回りして解説しておきますね。
① `#if macro` のスコープ迷子
マクロを実行するコード（コンパイル時に動くコード）と、実際のアプリケーションとして実行されるコードは、生存する世界線が違います。
マクロ内で使う外部ライブラリやHaxeのコンパイラAPI（`haxe.macro.`）は、必ず `#if macro` の条件付きコンパイルブロック内で扱うか、マクロ専用のクラスとして切り出してください。これを混ぜてしまうと、「シンボルが見つかりません」という不可解なコンパイルエラーに悩まされます。
② 無限再帰 Setter の罠
今回作成した自動Setterのコードを見てみましょう。
expr: macro return $i{fieldName} = value
もしここで、うっかり `this.setBalance(value)` のような自分自身のSetterを呼び出すコードを生成してしまったらどうなるでしょうか？ そう、無限ループ（Stack Overflow）が発生します。
マクロでコードを自動生成する際は、「直接フィールドのメモリ領域にアクセスしているか」「意図しないメソッド呼び出しのループが起きないか」をASTの構造レベルで慎重にイメージすることが大切です。
—
まとめ
今回は、Haxeのマクロを用いてPHPのボイラープレート（Getter/Setter）を自動生成する仕組みを解説しました。
- Haxeのマクロを使えば、コンパイル時にコードを自由自在に改変・拡張できる。
- `Context.getBuildFields()` を使って既存のクラス定義にメソッドを後付けできる。
- クォーテーションマクロ（`macro …` と `$i{}`）を組み合わせることで、安全かつ直感的にコード片を生成できる。
ここをクリアできれば、あなたはもうただのHaxeユーザーではありません。Haxeのコンパイラを意のままに操る「アーキテクト」の一歩を踏み出しています。
ボイラープレートのような単調な作業はマクロにすべて押し付けて、私たちはより本質的なビジネスロジックの設計に集中しましょう。
それでは、次回の極限の知見でお会いしましょう！