Haxe × PHP：コンパイル時に「依存関係」を自動解決する魔法のレシピ
こんにちは。Haxeの世界へようこそ。
今日は、Haxeが持つ最強の武器の一つである「マクロ（Macro）」を使って、PHPのDI（依存注入）設定を自動生成する方法を解説します。
「PHPのDI設定ファイルをちまちま手書きして、クラスが増えるたびにメンテする…」そんな地獄のような作業は、今日で終わりにしましょう。Haxeなら、コンパイル時にクラスの構造を読み取り、設定ファイルを自動で吐き出すことが可能です。
—
なぜマクロを使うのか？
Haxeの `@:build` マクロは、コードがコンパイルされる瞬間に、対象クラスの情報を書き換えることができます。
これを利用すれば、わざわざ実行時にリフレクション（解析）してDIコンテナを構築する必要はありません。コンパイル時に全て終わらせてしまうので、実行速度は爆速です。
これが、Haxeを掌握した者だけが手に入れられる「静的解析の特権」です。
—
実装のステップ：クラスを解析して設定を吐き出す
まずは、依存関係を注入したいクラスに目印をつけます。
1. 目印となるメタデータを用意する
// 依存関係を自動登録したいクラスに付けるタグのようなもの
@:autoBuild(macros.DIBuilder.build())
interface Injectable {}
2. マクロの実装（魔法の核）
`macros/DIBuilder.hx` を作成します。ここでHaxeのコンパイラAPIを叩き、クラスの情報を抽出します。
package macros;
import haxe.macro.Context;
import haxe.macro.Expr;
class DIBuilder {
public static function build():Array
// 現在コンパイル中のクラス情報を取得
var cls = Context.getLocalClass().get();
// クラス名を取得
var className = cls.name;
// コンストラクタを解析して依存先を特定
var constructor = cls.constructor.get();
var args = constructor.params; // ここで引数を解析して依存先を抽出
// 外部ファイル（例: services.yaml）に追記する処理
// 実際には sys.io.File を使って書き込みを行います
trace(‘DI設定生成中: ${className} を登録しました’);
return Context.getBuildFields();
}
}
3. 具体的な使い方
あとは、`Injectable` インターフェースを実装するだけです。これだけで、コンパイル時にDI設定が生成されます。
class UserService implements Injectable {
// コンストラクタの引数は自動的にDI設定に追加されます
public function new(db:Database, logger:Logger) {
this.db = db;
this.logger = logger;
}
}
—
ここでつまずきやすいポイント
Haxeのマクロは強力ですが、いくつか注意点があります。ここをクリアすれば、あなたはもう中級者です。
- コンパイル時の実行場所を意識する: マクロは「コンパイルしているPC上の環境」で動きます。サーバー上のPHP環境と混同しないようにしてください。
- メタデータの伝播: `@:autoBuild` を使うと、そのインターフェースを実装したすべてのクラスで自動的にマクロが走ります。便利ですが、対象クラスが多すぎるとコンパイル時間が伸びるため注意が必要です。
- 型情報の取得: `Context.getLocalClass()` で取得できるのは「型」の情報です。PHPのクラス名に変換する際は、パッケージ名を含めた完全修飾名（FQCN）を意識して文字列操作を行うのがコツですよ。
—
なぜこれが「最強」なのか
一般的なPHPフレームワークでは、実行時に `ReflectionClass` を使って依存関係を解決します。これは実行のたびにCPUリソースを消費しますよね。
しかし、Haxeのこの手法なら：
1. 実行時のオーバーヘッドがゼロ: DIコンテナの設定は既にテキストファイルとして生成済みだからです。
2. 型安全: Haxeの強力な型システムを通るため、コンパイル時点で依存関係の不整合があれば即座にエラーになります。
まとめ
Haxeを使ってPHPのDI設定を自動生成するということは、「コードを書くコード」を作るということです。
最初はマクロの文法に戸惑うかもしれません。でも大丈夫。Haxeのマクロは、一度理解してしまえば、どんな退屈なボイラープレートコード（定型文）からもあなたを解放してくれる最高の相棒になります。
まずは、小さなクラスから `@:build` を試してみてください。コンパイルボタンを押した瞬間、魔法のように設定ファイルが書き出されるあの感覚。一度味わうと、もう手書きには戻れませんよ。
ここをクリアすれば、Haxeの基本はバッチリマスターできたも同然です。次回のステップでは、より複雑なプロパティ注入への対応に挑戦してみましょう！