1. 導入：PHARが解決する配布と運用の課題
PHP開発において、複数のファイルで構成されるライブラリやアプリケーションを配布する際、ファイル数の多さがネックになることはありませんか。FTPでのアップロードに時間がかかったり、ディレクトリ構造の不整合によって実行エラーが発生したりと、運用上の課題は少なくありません。
PHP Archive（通称PHAR）は、JavaのJARファイルのように、複数のPHPファイルやリソースを一つのアーカイブファイルにまとめられる仕組みです。単一ファイルで配布可能なため、ライブラリの依存関係管理やデプロイ作業を劇的に簡素化できます。本記事では、このPHARの仕組みと、実務で役立つ作成方法を解説します。
2. 基礎知識：PHARとは何か
PHARは、PHP 5.3以降で標準搭載されている拡張機能です。内部的にはZIPやTAR形式をベースにしており、実行可能なアーカイブを作成できます。
主なメリットは以下の通りです。
・配布の容易さ：単一ファイル化により、コピー＆ペーストだけで配布が可能。
・実行速度の向上：キャッシュ機能が組み込まれているため、読み込みパフォーマンスが最適化される。
・署名による検証：OpenSSL等を用いた署名機能により、ファイルの改ざん検知が可能。
3. 実装/解決策：PHAR作成の基本フロー
PHARを作成するには、PHPの設定ファイル（php.ini）で phar.readonly 設定が「Off」になっている必要があります。これはデフォルトでは「On」になっていることが多いので、開発環境で確認してください。
実装の手順は以下の通りです。
1. ディレクトリ構造の準備：配布したいファイルを一つのディレクトリにまとめる。
2. Pharオブジェクトの生成：PHPスクリプト内でPharクラスをインスタンス化する。
3. ビルドの実行：ディレクトリをアーカイブに圧縮し、スタブ（実行時に最初に読み込まれるファイル）を設定する。
4. サンプルプログラム：PHAR作成スクリプト
以下のコードは、指定したディレクトリ内のファイルを「app.phar」という名前でアーカイブ化する例です。
buildFromDirectory(dirname(__FILE__) . ‘/src’);
// スタブ（エントリポイント）の設定
// このファイルがPHAR実行時に最初に読み込まれる
$phar->setStub($phar->createDefaultStub(‘index.php’));
echo “PHARファイルを作成しました: ” . $pharFile . PHP_EOL;
?>
5. 応用・注意点：現場で陥りやすい罠
・PHAR内のファイルへのアクセス
PHAR内部のファイルは「phar://app.phar/config.php」のように、pharストリームラッパー経由でアクセスする必要があります。通常のファイルパス記述とは異なるため、パス関連の定数（__DIR__等）を多用しているコードでは注意が必要です。
・readonly設定の確認
本番環境でPHARを生成させないよう、セキュリティを考慮して本番環境のphp.iniでは必ず「phar.readonly = On」に設定してください。
・Composerとの併用
現代のPHP開発では「Box」というツールを使用するのが一般的です。Composerで管理された依存関係を含めたPHAR作成を自動化してくれるため、中〜大規模なプロジェクトでは、手動でPharクラスを叩くよりもBoxの利用を強く推奨します。
PHARは、ツールの配布やコマンドラインインターフェース（CLI）アプリケーションを作成する際に非常に強力な武器になります。ぜひ、プロジェクトの配布フローに取り入れてみてください。