1. 導入：なぜ今、PHARなのか？
PHPエンジニアにとって、配布可能な単一ファイルのアプリケーションを作成したり、ライブラリをスマートに管理したりすることは重要なスキルです。JavaにおけるJARファイルのように、PHPには「PHAR（PHP Archive）」という仕組みが存在します。PHARを活用することで、複数のファイルで構成されるプロジェクトを1つのアーカイブファイルにまとめ、実行環境へ配布・デプロイしやすくなるという大きな利点があります。
2. 基礎知識：PHARとは何か？
PHARは、複数のPHPファイルや関連するアセット（画像や設定ファイルなど）を1つのファイルにパッケージングするためのアーカイブ形式です。
最大の特徴は、PHPインタープリタがPHARファイルを直接実行できる点です。これにより、依存関係を解決したライブラリやツールを、単一のファイルとして配布することが可能になります。Composerなどのツールも内部的にはPHAR形式で配布されており、現代のPHP開発において必須の知識と言えます。
3. 実装/解決策：PHARファイルの作成手順
PHARを作成するには、PHPの設定で `phar.readonly` が `Off` になっている必要があります（php.iniを確認してください）。
作成の論理的な流れは以下の通りです。
1. `Phar` クラスのインスタンスを生成する。
2. 必要なファイルを `buildFromDirectory` メソッドなどで追加する。
3. エントリポイント（実行時に最初に読み込まれるファイル）を指定する。
4. スタブ（PHAR実行時に最初に実行されるコード）を生成し、ファイルを書き出す。
4. サンプルプログラム：シンプルなPHAR作成スクリプト
以下のコードを `build.php` として保存し、実行することで `myapp.phar` が生成されます。
buildFromDirectory(dirname(__FILE__) . ‘/src’);
// エントリポイント（実行時に読み込むファイル）を設定
$defaultStub = $phar->createDefaultStub(‘index.php’);
// スタブに「このファイルはPHARです」という情報を付与して設定
$phar->setStub(“#!/usr/bin/env php\n” . $defaultStub);
echo “PHARファイルが正常に作成されました。\n”;
?>
※実行時には、`src/index.php` を別途作成し、`` と記述しておいてください。
5. 応用・注意点：現場で陥りやすい罠
実務でPHARを扱う際は、以下の点に注意してください。
・セキュリティ設定:
`phar.readonly` を `On` に戻し忘れると、意図しないファイル改ざんのリスクがあります。本番環境や配布時は必ず `On` にしましょう。
・パスの解決:
PHAR内部のファイルにアクセスする場合、通常のファイルパスではなく `phar://` スキームを使用する必要があります。ファイル読み込み時に `__DIR__` がPHAR内でのパスを正しく指しているか確認してください。
・互換性の確認:
OSごとのパーミッションや、実行環境のPHPバージョンによるPHARサポート状況に注意が必要です。特に古い環境では、拡張機能が有効になっていないケースも考えられます。
PHARは単なるアーカイブではなく、ツール配布の強力な武器です。ぜひCLIツールの開発などで活用してみてください。