こんにちは！Haxeの世界へようこそ。
今回は、Haxeの真骨頂である「クロスプラットフォーム」と、強力なメタプログラミング機能である「マクロ（Macro）」を組み合わせて、PHPの巨大なエコシステムを完全に手なずける極限のテクニックをお伝えします。
他の言語からHaxeに入った方の中には、「既存のComposerパッケージを使いたいけれど、extern（外部定義）を一つずつ手で書くなんて気が遠くなる……」と絶望した方もいるのではないでしょうか？
大丈夫です。今回はHaxeマクロの力を使って、PHPのクラス定義からHaxeのexternファイルを自動生成する魔法のツールを一緒に作っていきましょう。ここをクリアすれば、あなたのHaxe×PHP開発の生産性は文字通り桁違いに跳ね上がりますよ。
—
なぜHaxe×PHPでexternの手動定義がつらいのか？
Haxeは静的型付け言語です。PHPのような動的言語のライブラリを呼び出すには、「このクラスにはこういうメソッドがあって、引数はこれで……」という設計図（extern）をHaxe側に教えてあげる必要があります。
// 手動でexternを書く場合のイメージ
@:native(“Monolog\\Logger”)
extern class Logger {
function new(name:String):Void;
function info(message:String):Void;
}
小さなライブラリならこれでも良いのですが、有名なComposerパッケージ（例えばMonologやCarbonなど）になると、クラス数もメソッドも膨大になります。ライブラリがアップデートされるたびに手動で追従するなんて、エンジニアのやる仕事ではありませんよね。
ならばどうするか？ 「PHPのソースコード（またはReflection）をコンパイル時に読み取って、Haxeのexternコードを自動で吐き出させればいい」のです。それを実現するのがHaxeマクロです！
—
今回作るツールの全体像
今回のアプローチは非常にシンプルかつ強力です。
1. コンパイル時（Macro Phase）に、PHPのネイティブな `ReflectionClass` などのリフレクション機能を利用してターゲットクラスの構造を解析します。
2. 解析した構造（クラス名、メソッド名、引数の型など）を元に、Haxeのコード文字列を動的に組み立てます。
3. それをファイルシステム経由で `.hx` ファイルとして出力します。
イメージ図：
[PHPのクラス・Composer]
↓ (Haxeマクロがコンパイル時に実行)
[PHPリフレクションで構造を解析]
↓
[自動的に .hx の extern ファイルを生成]
↓
[Haxeコードから何のエラーもなく型安全に呼び出し！]
それでは、実際にコードを書いていきましょう。
—
実装ステップ：PHPリフレクション×Haxeマクロ
ここでは、指定したPHPクラス名から、そのクラスのextern定義を自動生成するマクロ関数を作成します。
1. マクロの実装 (`PhpExternGen.hx`)
Haxeのマクロは `macro` キーワードを付与して定義します。これはコンパイル時にHaxeのコンパイラ上で実行されるコードです。
package;
if macro
import haxe.macro.Context;
import haxe.macro.Expr;
.sys.FileSystem;
if sys
import sys.io.File;
end
end
class PhpExternGen {
/
- 指定したPHPクラスのexternを自動生成するマクロ
- @param phpClassName 対象のPHPクラス名（例: “Monolog\\Logger”）
- @param outputDir 出力先のディレクトリ
/
macro public static function generate(phpClassName:String, outputDir:String = “src/externs”):Expr {
#if macro
// 1. PHP環境が利用可能であることを確認し、PHPのリフレクションを使ってクラス構造を取得するコードを生成・実行する
// ※実際にはターゲットがPHPの時、あるいはターゲットに関わらずPHPコードを評価して構造を取ります。
// ここでは簡潔にするため、PHPのReflectionAPIを文字列として埋め込み、
// 簡易的にHaxeのexternコードを構築するロジックを組みます。
var parts = phpClassName.split(“\\”);
var className = parts.pop();
var packageName = parts.join(“.”);
// 出力ディレクトリの作成
var dir = outputDir + “/” + parts.join(“/”);
if (!sys.FileSystem.exists(dir)) {
sys.FileSystem.createDirectory(dir);
}
// 2. モック的な解析結果からHaxeのexternコードを文字列として構築
// （本番ではここでPHP側を実行するか、Composerのautoloadを利用してリフレクション情報を取得します）
var haxeCode = StringTools.trim(‘
// このファイルはHaxeマクロによって自動生成されました。
// 手動で編集しないでください。
${packageName.length > 0 ? “package ” + packageName + “;” : “”}
@:native(“${phpClassName}”)
extern class ${className} {
@:native(“__construct”)
function new();
// 必要に応じてメソッドの自動生成ロジックを追加
}
‘);
// 3. ファイルへ書き出し
var filePath = dir + “/” + className + “.hx”;
sys.io.File.saveContent(filePath, haxeCode);
// コンソールに進捗を表示
Context.info(‘Generated PHP Extern: ${filePath}’, Context.currentPos());
#end
// マクロは最終的にHaxeの式（Expr）を返す必要があります（今回は何も実行時コードを挿入しないのでmacro null返す）
return macro null;
}
}
2. マクロを呼び出すメイン処理 (`Main.hx`)
マクロの真骨頂は、「コンパイルが走った瞬間（ビルド時）」にこのコードが評価される点です。
class Main {
public static function main() {
// コンパイル時にマクロが実行され、ファイルが自動生成されます！
PhpExternGen.generate(“Monolog\\Logger”);
// 生成されたexternを早速つかう
// var logger = new Monolog.Logger();
// 完全に型安全！
trace(“Externの自動生成が完了しました！”);
}
}
これをHaxeのビルドファイル（`build.hxml`）で次のように設定します。
-main Main
-cp src
-lib hxphp
-php bin/php
コンパイル時にマクロを実行するトリガーになります
—
開発現場で陥りやすい文法エラーと対策
ここで、HaxeマクロやPHPターゲットを扱う際につまづきやすいポイントを先回りして解説しておきますね。
1. ターゲットの混同（#if macro の罠）
マクロコード内で `sys.` やファイルシステム操作を行う場合、必ず `#if macro` または `#if sys` で囲む必要があります。
HaxeはJavaScriptやC++など様々な言語にトランスパイルするため、「今動いているのはマクロの実行環境（通常はNekoかJVM、Node.jsなど）なのか、それとも出力先のPHPランタイムなのか」を意識することが極めて重要です。
2. @:native メタデータの付け忘れ
PHPのネームスペース付きクラス（例: `DateTime` やベンダー製パッケージ）をHaxeから呼ぶ場合、`@:native` メタデータが抜けていると、Haxe側が勝手にパッケージ名を書き換えてしまい、PHP側で「Class not found」エラーになります。
自動生成ツールを作る最大のメリットは、この `@:native` の記述ミスを完全にゼロにできる点にあります。
—
ここをクリアすれば、Haxeの基本はバッチリマスターできますよ！
いかがでしたでしょうか？
「既存のライブラリ資産を使いたいけれど、型安全なHaxeの恩恵も受けたい」というジレンマを、Haxeマクロは鮮やかに解決してくれます。
- コンパイル時にコードを自動生成する
- ターゲット固有の機能（PHPリフレクション等）をマクロ経由で取り込む
- メタデータ（`@:native`）でシームレスに結びつける
この3つのアプローチをマスターすれば、PHPに限らず、どんな言語のプラットフォーム連携であっても自由自在にハックできるようになります。ぜひ、お手元のComposerパッケージを使って試してみてくださいね。
あなたのHaxeライフが、よりスピーディで快適なものになりますように！