導入: なぜPHARが重要なのか
PHPで開発されたツールやライブラリを配布する際、複数のファイルをバラバラに配置することは、依存関係の管理や設置の手間を考えると非常に非効率です。また、エンドユーザーにソースコードを直接触らせたくない場合や、実行環境の汚染を防ぎたいという課題もあります。これらを解決するのが、PHP標準のアーカイブ形式であるPHAR（PHP Archive）です。JavaのJARファイルに近い概念で、アプリケーションを単一の実行可能ファイルにパッケージングできます。
基礎知識: PHARとは何か
PHARは、PHP 5.3.0からコアに組み込まれた拡張機能です。複数のPHPファイル、静的アセット（画像やCSSなど）を一つのアーカイブに圧縮・保存し、それをあたかも一つのスクリプトであるかのように実行できます。また、内部にデジタル署名を付与できるため、配布時の改ざん検知にも役立ちます。
実装/解決策: PHARファイルの作成手順
PHARを作成するには、まずphp.iniでphar.readonly設定がOffになっている必要があります。開発環境で以下のスクリプトを実行することで、ディレクトリ全体を一つの.pharファイルにまとめることが可能です。
サンプルプログラム: PHARビルドスクリプト
以下は、特定のディレクトリ内をアーカイブ化する実用的なビルドコードです。
startBuffering();
// ソースファイルを再帰的に追加
$dir = new RecursiveDirectoryIterator($srcDir);
$files = new RecursiveIteratorIterator($dir);
foreach ($files as $file) {
if ($file->isFile()) {
$phar->addFile($file->getRealPath(), substr($file->getRealPath(), strlen($srcDir) + 1));
}
}
// エントリーポイント（実行時に最初に呼ばれるファイル）の設定
$defaultStub = $phar->createDefaultStub(‘index.php’);
$phar->setStub(“#!/usr/bin/env php\n” . $defaultStub);
$phar->stopBuffering();
echo “PHARファイルを作成しました: ” . $pharFile . PHP_EOL;
応用・注意点: 実務での落とし穴
1. 内部パスの参照に注意
PHAR内部のファイルを参照する場合、通常通り`include`や`require`が使えますが、`__DIR__`などの定数はPHAR内部のパスを指します。外部の設定ファイルなどを読み込む際は、実行時のカレントディレクトリとPHAR内のパスを混同しないよう注意が必要です。
2. パフォーマンスへの影響
PHARは実行時に展開されるため、非常に大きなファイルを扱うとオーバーヘッドが生じることがあります。キャッシュ設定（`Phar::setSignatureAlgorithm`）を適切に行うことで、読み込み速度を最適化できます。
3. セキュリティ設定
配布先でPHARを実行する際、`php.ini`の設定によってはセキュリティ上の理由から実行がブロックされる場合があります。配布ドキュメントには「`phar.readonly = Off`」が必要である旨を必ず明記しましょう。
PHPエンジニアとして、Composerでライブラリを管理するだけでなく、独自のCLIツールをPHAR化して配布できるようになると、開発環境のポータビリティが劇的に向上します。ぜひ試してみてください。