こんにちは！Haxeの世界へようこそ。
今回は、Haxeのクロスプラットフォーム開発、特にPHPターゲットにおける「静的コンストラクタ（`__init__`）」の実行タイミングと初期化順序について、深く掘り下げていきましょう。
他の言語からHaxeにやってきた開発者が、意外と見落としがちで、かつハマりやすいのがこの「初期化順序」の罠です。ここをしっかりとマスターすれば、PHP特有のライフサイクルに振り回されることなく、堅牢なアプリケーションを構築できるようになりますよ。
それでは、さっそく扉を開けていきましょう！
—
1. Haxeの `__init__` とは何か？（基本のおさらい）
Haxeには、クラスがロードされた瞬間（正確には静的メンバにアクセスされるか、クラスが初期化される時）に一度だけ自動実行される特殊な初期化ブロック、それが `static __init__()` です。
他の言語（例えばJavaやC#の静的コンストラクタ、あるいはTypeScriptのモジュール評価時のコード）に近い概念ですが、HaxeがこれをPHPという動的スクリプト言語のコードにどう変換するのかを知ることが、トラブルシューティングの第一歩になります。
まずは、基本的な書き方を見てみましょう。
class DatabaseConfig {
public static var connectionString:String;
// クラスが最初に参照された時に1度だけ走る初期化処理
static __init__ {
// 例として環境変数から設定を読み込むとする
trace(“DatabaseConfig の静的初期化が走りました！”);
connectionString = “mysql:host=localhost;dbname=haxe_db”;
}
}
このコードをHaxeのコンパイラに通してPHPコードに出力すると、Haxe側がうまくPHPのファイル読み込みやクラス定義の仕組みに合わせて、適切なタイミングでこの `__init__` の中身が実行されるようグルーピングしてくれます。
—
2. PHPのライフサイクルとHaxeの初期化順序の罠
さて、ここからが本題です。
PHPは、リクエストごとにスクリプトが上から下へと解釈・実行される「リクエストライフサイクル」を持ちます。Node.jsのようにプロセスが常駐してメモリ上にクラスが保持され続けるわけではありませんよね。
そのため、Haxeで書いた複数のクラスが連携するとき、「どのクラスの `static __init__` が、どの順番で呼ばれるのか」の予測が狂うと、思わぬバグを生むことになります。
イメージ図：PHPターゲットでの実行フロー
[HTTP リクエスト受信]
↓
index.php (Haxeのエントリポイント) が実行される
↓
main() 関数へジャンプ
↓
ここで初めて依存するクラス A が参照される
↓
★ クラス A の static __init__ が実行される
↓
さらにクラス B が参照される
↓
★ クラス B の static __init__ が実行される
↓
[ビジネスロジックの実行]
ここで重要なポイントは、「Haxeの `__init__` は、コード上に書いた順序ではなく、そのクラスが『最初にコードから参照された瞬間』に呼び出される」ということです。
—
3. 陥りやすい文法エラーと「循環参照」の罠
初学者が最もやりがちなのが、静的初期化の最中に別のクラスの静的プロパティを参照し、それが互いに依存し合っているケース（循環参照）です。
例えば、次のようなコードを書いてしまったとしましょう。
❌ 危険なコード例（循環参照の恐れ）
class ClassA {
public static var valueA = ClassB.valueB + “_A”;
static __init__ {
trace(“ClassA initialized”);
}
}
class ClassB {
public static var valueB = ClassA.valueA + “_B”; // ← うわっ、ここでClassAを見ている！
static __init__ {
trace(“ClassB initialized”);
}
}
このコード、Haxeのコンパイル自体は通ることがあります。しかし、PHPに変換された後に実行すると、クラスのロード順序や静的変数の評価タイミングによって、`null` が意図せず混入したり、PHP側で予期せぬFatal Errorを引き起こしたりします。
✔️ 正しいアプローチ：依存関係を単一方向にする
静的初期化（`__init__` やインラインでの静的変数代入）の中では、他の複雑なクラスの静的状態に依存しないのが、堅牢なアーキテクチャを作るコツです。
class AppConstants {
// 依存を持たない純粋な定数定義に留める
public static var API_VERSION(default, null):String = “v1”;
}
class ApiClient {
public static var endpoint:String;
static __init__ {
// AppConstants は独立しているため、安全に参照できる
endpoint = “https://api.example.com/” + AppConstants.API_VERSION;
trace(“ApiClient initialized safely.”);
}
}
このように、静的初期化の連鎖を断ち切り、依存関係を常に一方向（トップダウン）に保つことが、PHPターゲットで安定動作させるための極意です。
—
4. 現場で役立つ！Haxe×PHPのデバッグテクニック
もし「あれ、どのタイミングでこの `__init__` が動いているんだ？」と迷ったら、Haxeの `trace()` をフル活用しましょう。Haxeの `trace()` は、PHPターゲットでは自動的に `echo` や `error_log` にきれいにマッピングされます。
class Bootstrapper {
static __init__ {
#if php
// PHPターゲット特有のデバッグ出力を仕込むことも可能
php.Global.error_log(“Bootstrapper loaded at: ” + Date.now().toString());
#end
trace(“アプリケーションのブートストラップ完了”);
}
}
Haxeのマクロや条件付きコンパイル（`#if php`）を組み合わせることで、「PHPのどのライフサイクルでこのコードが評価されたか」を完全に見通すことができるようになります。
—
まとめ
いかがでしたでしょうか？今回は、HaxeのPHPターゲットにおける静的コンストラクタ（`static __init__`）の実行タイミングと初期化順序について解説しました。
- ポイント1: `__init__` は、コードが上から順に読まれる時ではなく、クラスが最初に参照された瞬間に実行される。
- ポイント2: PHPのリクエストライフサイクルを意識し、静的初期化の間での循環参照は絶対に避ける。
- ポイント3: 依存関係は常に一方向に整理し、安全な設計を心がける。
ここをしっかりとクリアできれば、Haxeの強力なクロスプラットフォーム性を活かしつつ、PHPのサーバーサイドでもビクともしない堅牢なシステムが作れるようになりますよ。
Haxeの奥深い世界、一緒に一歩ずつマスターしていきましょう。それでは、次回の記事もお楽しみに！