やあ。Haxeの世界へようこそ。
Haxeを触り始めた君が、PHPという巨大なエコシステムとどう向き合うべきか悩んでいるんだね。素晴らしい着眼点だ。
多くの人がHaxeの「クロスプラットフォーム性」に惹かれてやってくるけれど、PHPターゲットにおいて「Composerとの共存」を制する者は、PHPバックエンド開発の真の支配者になれる。今日は、Haxeのパッケージ構造をPSR-4に適合させ、Composerと美しく共存させるための「極意」を伝授しよう。
—
なぜHaxeとComposerの「名前空間」が衝突するのか？
Haxeのコンパイラは、デフォルトではPHPのクラスファイルを単一のディレクトリにフラット、あるいは独自の階層構造で出力する。しかし、Composer（PSR-4）は「名前空間（Namespace）＝ディレクトリ構造」を厳格に求める。
もし、ここを適当に済ませると、PHP側からHaxeのクラスを呼び出そうとした瞬間に `Class not found` の悪夢が君を襲うことになる。
図解：名前空間の迷宮
[Haxeの視点] [Composer/PSR-4の視点]
src/com/app/Main.hx -> \App\Main (名前空間が必要！)
Haxeで `package com.app;` と書いたとき、PHP側では `com\app\Main` として認識される必要がある。これをComposerのオートローダーに教え込むのが、今回のミッションだ。
—
手順1：Haxe側で名前空間を意識した設計をする
まず、Haxeのコードで名前空間を意識しよう。実は、HaxeのパッケージはそのままPHPの名前空間にマッピングされる。
// src/my/project/Service.hx
package my.project;
class Service {
public function new() {}
public function greet():String {
return “Hello from Haxe!”;
}
}
これでビルドすると、Haxeは `my/project/Service.php` を生成してくれる。ここまでは標準的だ。
—
手順2：composer.json で「入り口」を作る
ここが重要だ。Haxeが生成したファイルを、Composerが「ここにあるよ」と認識できるように設定する。
`composer.json` に以下を追記してくれ。
{
“autoload”: {
“psr-4”: {
“MyProject\\”: “bin/php/src/my/project/”
}
}
}
- 注意点: Haxeの出力先ディレクトリ（例：`bin/php/src`）と、名前空間のルートが一致するように調整するのがコツだ。
—
手順3：ビルド設定（hxml）で最適化する
Haxeのコンパイルオプション `hxml` で、出力先を制御するのがプロの技だ。
build.hxml
-cp src
-php bin/php
PHPの出力において、不要なクラスの再生成を抑えたり、
適切な名前空間のプレフィックスを強制したりする設定
-D php-prefix=MyProject
–main Main
ここで `–dce full` (Dead Code Elimination) を使うと、使われていないライブラリのコードをPHPから完全に排除できる。Haxeを使う最大のメリットは、PHPのような動的言語であっても「静的解析による最適化」が手に入ることだ。 これを活かさない手はないよね。
—
陥りやすい「罠」：ここだけは注意！
初学者が必ず踏む地雷が2つある。
1. 大文字・小文字の不一致:
PHPのファイルシステムは環境によって大文字・小文字を区別する。`MyClass` なのに `myclass` で読み込もうとすると、Linux環境では即座にエラーだ。Haxeのパッケージ名とディレクトリ名は、常に小文字で統一するのがPHP開発における大人のマナーだ。
2. `vendor` フォルダとの混在:
Haxeが生成したPHPコードの中に、外部のPHPライブラリを直接 `include` しようとしないでほしい。依存関係はすべてComposerに管理させ、Haxe側からは「Composerが読み込んだクラスを呼び出す」という明確な境界線を引くこと。
—
まとめ：君はもう「共存」のルールを知っている
HaxeとPHPを組み合わせることは、「Haxeの強力な型安全性」を「PHPの広大なライブラリ資産」で包み込むことに他ならない。
1. Haxeのパッケージ構造をPSR-4に合わせる。
2. `composer.json` でHaxeの出力先をオートロード対象にする。
3. `hxml` でビルドを自動化し、DCEで余計なコードを削ぎ落とす。
ここをクリアすれば、君が書いたHaxeコードは、他のPHPエンジニアにとっても「まるで最初からそこにあったかのような自然なPHPクラス」として振る舞うはずだ。
さて、コードを書いてみようか。分からないことがあったら、いつでも聞きに来てくれ。君のビルドが成功することを祈っているよ。