こんにちは！Haxeの世界へようこそ。
今回は、Haxeのクロスプラットフォーム開発における強力な武器の一つ、「PHPの既存ライブラリをHaxeの世界に召喚する（Extern）」というテーマについてじっくり解説していきますね。
他の言語からHaxeにやってきた開発者や、これからHaxeを深く学ぼうとしている方にとって、「HaxeからPHPのエコシステムをどうやって安全に利用するか」は、実務で必ず直面する非常に重要なトピックです。
ここをクリアすれば、Composerでインストールした膨大なPHPライブラリを、Haxeの強固な静型システムの保護下で完全に手なずけることができるようになりますよ。さあ、一緒にマスターしていきましょう！
—
1. なぜ「Extern（外部定義）」が必要なのか？
Haxeは、JavaScript、C++、Python、そしてPHPなど、さまざまな言語にソースコードをトランスパイル（変換）できる言語です。
しかし、Haxeのコンパイラは、あなたが書いたHaxeコードしか知りません。「ComposerでインストールしたあのPHPライブラリの中に、どんなクラスやメソッドがあるか」なんて、そのままでは知る由もありませんよね。
そこで登場するのが Extern（エクスターン） です。
[Haxeのコード]
↓ (Externで型を定義する：実体はない、設計図だけ)
[Haxeコンパイラ]
↓ (型安全性をチェックしながらPHPコードに変換)
[PHPのトランスパイル結果]
↓ (実行時に本物のPHPライブラリと合流！)
[Composerライブラリ (例: Monolog, Carbon等)]
Externとは、「Haxeコンパイラに対して、実体のない『見かけ上の設計図』を教え込む機能」です。これによって、コンパイル時にはHaxeの厳しい型チェックの恩恵を受けつつ、生成されたPHPコードはそのまま既存のPHPライブラリを呼び出せるという、いいとこ取りができるようになります。
—
2. 実践：Carbon（日付ライブラリ）をHaxeでラップする
今回は、PHPの超有名日時操作ライブラリである `nesbot/carbon` を例にして、具体的なExternの書き方を見ていきましょう。
まずは、ComposerでCarbonがインストールされている環境を想定します。
ステップ1：ディレクトリ構造とexternファイルの配置
Haxeプロジェクト内での一般的なexternの置き場所は、`php.extern` のようなパッケージ構造に合わせます。
my_haxe_project/
┣ src/
┃ ┗ externs/
┃ ┗ Carbon.hx <-- これがextern定義ファイル
┗ Main.hx <-- 呼び出し元のメイン処理
ステップ2：Externクラスの書き方
`src/externs/Carbon.hx` を次のように記述します。ここが今回の最重要ポイントですよ！
package externs;
import haxe.extern.Rest;
/
- PHPの Carbon ライブラリのための Extern 定義
- @see https://carbon.nesbot.com/
/
@:native(“Carbon\\Carbon”) // <-- 1. 実際のPHPの完全修飾クラス名を指定する
extern class Carbon {
/
- 現在時刻でインスタンスを生成するコンストラクタ
/
@:native(“now”) // <-- 2. PHP側のメソッド名（Haxe側と変えたい場合や明確にする場合）
public static function now():Carbon;
/
- 日付を指定してインスタンスを生成する
/
public static function create(year:Int, month:Int, day:Int):Carbon;
/
- 日数を加算する
/
public function addDays(days:Int):Carbon;
/
- 文字列形式にフォーマットする
/
public function format(format:String):String;
}
💡 コードの重要ポイント解説
1. `extern class` キーワード
通常の `class` ではなく `extern class` と宣言します。これにより、Haxeはこのクラスのメソッド本体（中身の処理）を生成せず、単に「こういう型やメソッドが存在する」という情報としてのみ扱います。
2. `@:native` メタデータ
これが魔法の呪文です。Haxe側のクラス名やメソッド名と、実際のPHP側の名前空間やメソッド名が異なる場合や、正確に紐付けたい場合に指定します。上の例では、Haxeの `Carbon` クラスが、PHPの `Carbon\Carbon` クラスを指すように指示しています。
3. インスタンスの返り値 (`:Carbon`)
メソッドチェーン（`Carbon.now().addDays(1).format(…)`）を実現するために、自分自身の型を返すメソッドの戻り値にはしっかりと `Carbon` を指定しましょう。
—
3. Haxe側から安全に呼び出してみる
それでは、作成したExtern定義を `Main.hx` から使ってみましょう。
import externs.Carbon;
class Main {
public static function main():Void {
// Haxeの型推論と補完が効く状態でPHPのライブラリを叩ける！
var today = Carbon.now();
// 3日後を計算
var threeDaysLater = today.addDays(3);
// フォーマットして出力
var formatted = threeDaysLater.format(“Y-m-d H:i:s”);
php.Global.echo(“3日後は: ” + formatted + “\n”);
}
}
これをHaxeのPHPターゲットでコンパイルすると、生成されるPHPコードは以下のようになります。非常に自然なPHPコードにトランスパイルされますよね！
// 生成されるPHPのイメージ
$today = \Carbon\Carbon::now();
$threeDaysLater = $today->addDays(3);
$formatted = $threeDaysLater->format(“Y-m-d H:i:s”);
echo “3日後は: ” . $formatted . “\n”;
—
4. 陥りやすい文法エラーと注意点
初学者の方がExternを書く際につまづきやすいポイントをいくつかピックアップしておきます。ここを知っておくだけで、無駄なエラーに悩まされずに済みますよ！
① メソッド本体 `{}` を書いてしまうエラー
❌ やってはいけない間違い：
// エラー！ externクラスのメソッドに本体（中身）は書けません
public static function now():Carbon {
return null;
}
⭕ 正しい書き方：
// セミコロンで終わらせる
public static function now():Carbon;
Externは「設計図」なので、具体的な処理（中身）を書くことはできません。
② 引数の省略可能（オプション）引数の扱い
PHPのライブラリでは、引数が省略可能なことがよくあります。Haxeでこれを表現するには、`null` を許容する型（`Null
// 第2引数以降が省略可能な場合の例
public static function create(?year:Int, ?month:Int, ?day:Int):Carbon;
③ 予約語や特殊なメソッド名
PHPのメソッド名がHaxeの予約語（`default`, `clone`, `new` など）と被る場合も、`@:native` メタデータが救ってくれます。
// Haxe側は別の名前にしつつ、PHP側では ‘clone’ を呼ぶ
@:native(“clone”)
public function phpClone():Carbon;
—
まとめ
いかがでしたでしょうか？
HaxeのExtern機能を使えば、世界中の豊かなPHPライブラリの資産をそのまま、Haxeの美しい静的型づけの恩恵を受けながら安全に再利用することができます。
「既存のPHP資産を生かしつつ、コードの保守性や堅牢性を爆発的に高めたい」
そんなフルスタックエンジニアの願いを、Haxeのトランスパイル仕様とメタデータ（`@:native`）は見事に叶えてくれます。
ここをマスターできれば、HaxeとPHPの連携における恐怖心はもう消え去っているはずです。ぜひ、あなたのプロジェクトでもお気に入りのComposerパッケージをExternでラップして遊んでみてくださいね。それでは、次回の記事もお楽しみに！