1. 導入：なぜ今、PHARなのか
PHP開発において、複数のファイルで構成されるライブラリやアプリケーションを配布・展開する際、ファイル管理の煩雑さに頭を悩ませたことはありませんか？「PHAR（PHP Archive）」を使えば、複数のPHPファイルや関連リソースを1つのアーカイブファイルにパッケージングし、実行可能な形式として配布できます。これは、JavaのJARファイルに近い概念で、デプロイの簡素化や、ライブラリのバージョン管理の明瞭化に非常に役立ちます。
2. 基礎知識：PHARとは何か
PHARは「PHP Archive」の略称で、PHP 5.3.0以降から標準で組み込まれているアーカイブ形式です。最大の特徴は、アーカイブ内のファイルを展開することなく、PHPインタープリタが直接読み込んで実行できる点です。また、PHARファイルは「スタブ（Stub）」と呼ばれる先頭コードを持つことができ、これがエントリーポイントとして機能するため、PHPコマンドで直接実行するツール作成にも適しています。
3. 実装・解決策：PHARを作成する手順
PHARを作成するには、PHPのphp.ini設定で「phar.readonly」が「Off」になっている必要があります。実装の基本は、Pharクラスを使用して、対象ディレクトリ内のファイルを再帰的に追加し、最後にスタブを設定することです。
4. サンプルプログラム：PHAR作成スクリプト
以下のコードは、指定したディレクトリを一つのPHARファイルにまとめる実用的なスクリプトです。
buildFromDirectory(dirname(__FILE__) . ‘/src’);
// スタブ（エントリーポイント）の設定
// このファイルが実行された時に最初に読み込まれるPHPファイルを指定
$defaultStub = $phar->createDefaultStub(‘index.php’);
$phar->setStub(“#!/usr/bin/env php\n” . $defaultStub);
echo “PHARファイルの作成が完了しました: ” . $pharFile . PHP_EOL;
?>
5. 応用・注意点：現場での運用のコツ
実務でPHARを利用する際、以下のポイントに注意してください。
・セキュリティ設定: PHARファイルを配布する場合、phar.readonlyがOnの環境でも実行できるよう、署名（OpenSSL等による秘密鍵での署名）を行って改ざんを防止することが推奨されます。
・パスの解決: PHAR内部のファイルを参照する場合、__DIR__などはPHARファイル内のパスを正しく指しますが、外部の設定ファイルなどを読み込む際は、実行元のカレントディレクトリとの混同に注意が必要です。
・互換性: PHARはPHPのバージョンに依存します。実行環境のPHPバージョンと、PHAR作成時のPHPバージョンが大きく乖離していないか確認してください。特にComposer等の依存パッケージ管理ツールと併用する場合、自動生成されるローダーの挙動を事前に検証することが重要です。
PHP Archiveを使いこなすことで、ツール配布やモジュール化がよりスマートになります。ぜひプロジェクトのCI/CDパイプラインに組み込んでみてください。