Haxeのコンパイル時マクロでPHPのボイラープレートを撲滅する：Getter/Setter自動生成の実践
コードレビューをしていて、次のようなPHPのクラス定義に溜息をついたことはないだろうか。
// どこにでもある、退屈で冗長なPHPのDTOクラス
class User {
private string $name;
private int $age;
public function __construct(string $name, int $age) {
$this->name = $name;
$this->age = $age;
}
public function getName(): string {
return $this->name;
}
public function setName(string $name): void {
$this->name = $name;
}
public function getAge(): int {
return $this->age;
}
public function setAge(int $age): void {
$this->age = $age;
}
}
プロパティが10個あれば、ゲッターとセッターだけで数十行の「意味のないボイラープレート（定型コード）」が生成される。IDEのコード生成機能に頼ったところで、ファイル行数が増大し、リファクタリングの認知負荷を高めるという事実は変わらない。
Haxeを実務に導入する最大のメリットの一つは、この「言語仕様の限界による記述の冗長性」を、強力なコンパイル時マクロ（Macro）によって完全に根絶できる点にある。
今回は、Haxeのマクロシステムを駆使し、アノテーション一つでPHPの冗長なGetter/Setterをビルド時に自動生成する、プロダクションクオリティの設計パターンを伝授する。
—
なぜHaxeのマクロなのか？（PHPマジックメソッドの罠）
PHPには、動的にプロパティアクセスをフックする `__get()` や `__set()` が存在する。これらを使えばボイラープレートは消える。しかし、テクニカルリードの視点から言えば、プロダクション環境でマジックメソッドを多用するのは悪手だ。
1. 静的解析の崩壊: PHPStanやPsalmなどの静的解析ツールがプロパティを追跡できなくなり、型安全性が低下する。
2. パフォーマンスの劣化: メソッド動的コールのオーバーヘッドが蓄積する。
Haxeのマクロは、「コンパイル時にコードの抽象構文木（AST）を書き換える」。つまり、生成されるPHPコードは、最初から完全な明示的メソッドを持つ、静的かつ高速なネイティブPHPコードになる。ランタイムコストはゼロだ。
—
実装：`@:autoAccessor` マクロの構築
目指すゴールはこうだ。Haxe側で `@:autoAccessor` というメタデータ（アノテーション）を付与するだけで、プライベートなフィールドからパブリックなGetter/Setterを自動生成し、PHPへ出力する。
1. マクロ実装モジュール (`AutoAccessor.hx`)
まずはASTを操作するマクロプロセッサを記述する。Haxeのマクロは、Haxe自身で記述できる（Meta-programming）。
package macros;
if macro
import haxe.macro.Context;
import haxe.macro.Expr;
using haxe.macro.Tools;
end
class AutoAccessor {
macro public static function build(): Array
// 現在ビルド中のクラスのフィールド（プロパティ・メソッド）を取得
var fields = Context.getBuildFields();
var newFields: Array
for (field in fields) {
newFields.push(field);
// 変数（Var）であり、特定のメタデータを持たないもの学対象
switch (field.kind) {
if (field.access.indexOf(APrivate) != -1 || field.access.indexOf(APublic) == -1) {
// ここではシンプルにすべてのインスタンス変数に対してゲッター/セッターを生成
// 実務では @:readable / @:writable などのメタデータで制御するとより堅牢
}
case FVar(t, _):
var fieldName = field.name;
// 先頭大文字のキャメルケースに変換 (e.g., name -> Name)
var capitalized = fieldName.substr(0, 1).toUpperCase() + fieldName.substr(1);
var pos = field.pos;
// 1. Getterの生成: public function getName() { return $this->name; }
var getterName = ‘get$capitalized’;
if (!hasField(fields, getterName)) {
newFields.push({
name: getterName,
access: [APublic],
kind: FFun({
args: [],
ret: t,
expr: macro return $i{fieldName}
}),
pos: pos
});
}
// 2. Setterの生成: public function setName(val) { $this->name = val; }
var setterName = ‘set$capitalized’;
if (!hasField(fields, setterName)) {
newFields.push({
name: setterName,
access: [APublic],
kind: FFun({
args: [{ name: “value”, type: t }],
ret: macro : Void,
expr: macro $i{fieldName} = value
}),
pos: pos
});
}
default:
// メソッドなどはそのままスルー
}
}
return newFields;
}
#if macro
private static function hasField(fields: Array
for (f in fields) {
if (f.name == name) return true;
}
return false;
}
#end
}
2. ドメインモデルでの活用 (`User.hx`)
先ほどの退屈なPHPクラスを、Haxeで圧倒的にエレガントに書き換える。
import macros.AutoAccessor;
@:build(macros.AutoAccessor.build())
class User {
// フィールドを定義するだけ
public var name(default, null): String;
public var age(default, null): Int;
public function new(name: String, age: Int) {
this.name = name;
this.age = age;
}
}
(※Haxe標準のプロパティアクセス制御 `(default, null)` とマクロを組み合わせることで、Haxeのコンパイル時チェックとPHP出力の両方を完璧に制御できる)
—
3. 生成されるPHPコードの検証
このHaxeコードを `haxe -cp src -php dist/php` でPHPターゲットへトランスパイルすると、出力されるPHPコード（抜粋）は以下のようになる。
// dist/php/User.php (Haxeマクロによって自動生成されたネイティブPHPコード)
class User {
public string $name;
public int $age;
public function __construct(string $name, int $age) {
$this->name = $name;
$this->age = $age;
}
public function getName(): string {
return $this->name;
}
public function setName(string $value): void {
$this->name = $value;
}
public function getAge(): int {
return $this->age;
}
public function setAge(int $value): void {
$this->age = $value;
}
}
完璧だ。 手動で書けばヒューマンエラーの温床になり、メンテナンスのたびに修正漏れが発生するボイラープレートが、コンパイルパイプラインの中で100%の正確性をもって自動生成されている。
—
現場のエンジニアへ：保守性とパフォーマンスの極意
このアプローチをチームに導入する際、シニアエンジニアとして以下の2点を念頭に置いて設計してほしい。
1. マクロのデバッグには `-D macro-times` を活用せよ
マクロはコンパイル時のビルドプロセスで実行されるため、無限ループや重いAST操作を書くとコンパイル速度が落ちる。Haxeのコンパイルオプションでビルド時間を計測し、最適化されたAST構築（`macro`構文の積極的な利用）を心がけよう。
2. IDE（VSCodeなど）への補完追従
Haxeのコンパイラは強力なため、マクロによって動的生成されたフィールドやメソッドも、IDE上で完全に静的補完が効く。PHP側に吐き出された後ではなく、Haxeの開発レイヤーで型安全性が完全に担保される点が、素のPHP開発に対する圧倒的なアドバンテージとなる。
ボイラープレートの記述に貴重な開発リソースを割く時代は終わった。Haxeのマクロをシステムの中枢に組み込み、真に価値のあるドメインロジックの構築に集中しよう。