こんにちは！Haxeの世界へようこそ。
今回は、HaxeからPHPへのトランスパイル（変換）の裏側を覗きながら、「静的メソッド」と「インスタンスメソッド」の呼び出しコストについて深く掘り下げていきますね。
他のオブジェクト指向言語からHaxeに入った方だと、「とりあえず何でもクラスを作ってインスタンス化すればいいや」となりがちですが、クロスプラットフォーム言語であるHaxeを極める上では、ターゲット環境（今回はPHP）のランタイム特性を理解することが極めて重要です。
ここをクリアすれば、Haxeのコンパイルモデルの強みをぐっと引き出せるようになりますよ。一緒に本質に迫っていきましょう！
—
1. HaxeのメソッドがPHPに変換される仕組み
まずは、私たちが書いたHaxeのコードが、PHPの世界でどのように生まれ変わるのかを確認しましょう。
Haxeは非常に強力な静的型付け言語でありながら、JavaScript、C++、C#、Java、そしてPHPなど、多種多様な言語へソースコードを出力（トランスパイル）できます。このとき、Haxeのクラス構造は、そのままターゲット言語のクラス構造にマッピングされます。
イメージ図で表すと、こんな感じです。
[ Haxeのソースコード ]
├── 静态メソッド (static) ──> PHPの static メソッド
└── インスタンスメソッド ──> PHPの通常メソッド ($thisが必要)
PHPという言語の特性上、インスタンスメソッドを呼び出すためには「オブジェクトの生成（メモリ確保）」と「メソッドディスパッチ（どのメソッドを実行するかを特定する仕組み）」のオーバーヘッドが発生します。一方、静的メソッド（`static`）は、インスタンスを生成せずにクラス名から直接関数を呼び出せるため、PHPのランタイムにとっても非常に直感的で軽量な処理になります。
—
2. 実コードで見るコストの違い
百聞は一見にしかず。実際にHaxeでコードを書いて、それがどのようにPHPに変換されるのかを見てみましょう。
以下のHaxeコードを考えてみてください。
class Calculator {
// インスタンスメソッド
public function addInstance(a: Int, b: Int): Int {
return a + b;
}
// 静的メソッド
public static function addStatic(a: Int, b: Int): Int {
return a + b;
}
}
これをHaxeのコンパイラを通してPHPに変換すると、だいたい次のようなPHPコードが出力されます（※分かりやすく整形しています）。
class Calculator {
// PHPのインスタンスメソッド
public function addInstance($a, $b) {
return $a + $b;
}
// PHPの静的メソッド
public static function addStatic($a, $b) {
return $a + $b;
}
}
// — 呼び出し側の違い —
// 1. インスタンスメソッドの呼び出し
$calc = new Calculator(); // <-- ここでメモリ割り当てが発生
$result1 = $calc->addInstance(1, 2);
// 2. 静的メソッドの呼び出し
$result2 = Calculator::addStatic(1, 2); // <-- ダイレクトに実行！
この出力結果を見ると一目瞭然ですよね。
インスタンスメソッドを呼ぶためには、必ず `new Calculator()` でオブジェクトを生成しなければなりません。PHPはスクリプト言語であり、リクエストごとにメモリの割り当てとガベージコレクションのライフサイクルが存在するため、不要なインスタンス化はそのままパフォーマンスのロスにつながります。
---
3. 初学者が陥りやすい罠とアンチパターン
「じゃあ、パフォーマンスを稼ぐために全部のメソッドを `static` にすれば最強なのでは？」と思ったそこのあなた。それはちょっと待ってくださいね。
Haxeやオブジェクト指向設計において、すべてを静的メソッド（グローバル関数に近い状態）にしてしまうと、以下のような問題に直面します。
- 状態（State）を持てなくなる：インスタンス変数が使えないため、オブジェクトごとのデータを保持できなくなります。
- ポリorphism（多態性）の喪失：インターフェースを通した抽象化や、継承による振る舞いの切り替えが困難になります。
陥りやすい文法エラーの例
例えば、静的メソッドの内部から、インスタンス変数やインスタンスメソッドをうっかり呼ぼうとすると、Haxeのコンパイラがしっかり怒ってくれます。
class BadExample {
public var name: String = “Haxe”;
public static function sayHello(): Void {
// コンパイルエラー！
// 静的コンテキストからはインスタンス変数にアクセスできません
trace(name);
}
}
Haxeは非常に優秀な静的解析を持っているので、こうしたミスをコンパイル時に確実に検知してくれます。PHPの実行時エラー（`Using $this when not in object context` など）に怯える必要がないのは、Haxeの本当に素晴らしいところですね。
—
4. パフォーマンスを最大化するための設計指針
では、PHPターゲットにおいて最高のパフォーマンスを発揮させるためには、どのように設計すればよいのでしょうか。チーフアーキテクトからの実践的なアドバイスをいくつか授けましょう。
1. 「状態を持たない処理（ユーティリティ関数など）」は迷わず `static` にする
計算処理や文字列フォーマットなど、入力値に対して出力が一つに決まる純粋な関数は、すべて静的メソッドとして定義しましょう。無駄なインスタンス生成コストを完全にゼロにできます。
2. Haxeの「抽象型（Abstract）」を活用する
Haxeには、実行時に実体を伴わない究極の最適化機能である `abstract`（抽象型）があります。これを使うと、コンパイル後にはプリ型や単なる関数にインライン展開され、PHP上ではオブジェクトのオーバーヘッドが完全に消え去ります。
abstract SafeInt(Int) {
public inline function new(i: Int) {
this = i;
}
@:to public inline function toInt(): Int return this;
}
3. DI（依存性注入）やモックが必要な場合のみインスタンスメソッドを使う
テストのしやすさや、状態の切り替えが必要なコアロジックには、しっかりとインスタンス（クラス）を使いましょう。コストを払うべき場所と、払うべきではない場所を意識的にコントロールするのが、プロフェッショナルなHaxeエンジニアへの第一歩です。
—
まとめ
今回は、HaxeからPHPへのトランスパイルにおける「静的メソッド」と「インスタンスメソッド」の呼び出しコストの違いについて解説しました。
- 静的メソッド (`static`)：インスタンス生成が不要で、PHP上でもダイレクトに呼び出せるため高速。ユーティリティに向いている。
- インスタンスメソッド：オブジェクトの生成コストがかかるが、状態の保持やポリモーフィズム（オブジェクト指向の恩恵）に不可欠。
ここをクリアすれば、HaxeのコードがPHP上でどのように動いているのかが頭の中で完全にトレースできるようになりますよ。ぜひ、あなたのプロジェクトでも「ここはStaticにできるかな？」という視点を取り入れてみてくださいね。
それでは、快適なHaxeライフを！