1. 導入：なぜPHARが重要なのか
PHP開発において、複数のPHPファイルで構成されるライブラリやアプリケーションを配布する際、ファイルを一つ一つ管理するのは手間がかかり、依存関係の破損や意図しないファイルの欠落を招くリスクがあります。
PHAR（PHP Archive）は、JavaのJARファイルに近い仕組みで、複数のPHPファイルを一つのアーカイブにまとめ、単一のファイルとして実行・配布可能にする技術です。この仕組みを活用することで、配布の簡素化だけでなく、アプリケーションの自己完結性を高めることができます。
2. 基礎知識：PHARとは何か
PHARは「PHP Archive」の略称です。PHP 5.3以降から標準で組み込まれており、追加のライブラリなしで利用可能です。
PHARファイル内には、PHPのソースコードだけでなく、画像や設定ファイルといったリソースも含めることができます。また、アーカイブ全体を一つの実行可能ファイルとして扱うための「スタブ（Stub）」というエントリポイントを設定することで、コマンドラインから直接実行することも可能です。
3. 実装/解決策：PHARファイルの作成手順
PHARを作成するには、PHPのPharクラスを使用します。
主な手順は以下の通りです。
1. `Phar`オブジェクトを生成する。
2. `buildFromDirectory`などでファイルを追加する。
3. `setStub`で実行時のエントリポイントを指定する。
これにより、特定のディレクトリ配下を丸ごとアーカイブ化できます。
4. サンプルプログラム：PHAR作成用スクリプト
以下のコードは、指定したディレクトリを一つのPHARファイルにまとめる実用的なスクリプトです。
/
// 出力するPHARファイル名
$pharFile = ‘myapp.phar’;
// 既に存在する場合は削除
if (file_exists($pharFile)) {
unlink($pharFile);
}
// Pharオブジェクトの作成
$phar = new Phar($pharFile, 0, ‘myapp.phar’);
// ディレクトリ内の全ファイルを再帰的に追加
$phar->buildFromDirectory(dirname(__FILE__) . ‘/src’);
// スタブ（実行時のエントリポイント）の設定
// Pharファイル実行時に最初に呼び出されるファイルを指定
$defaultStub = $phar->createDefaultStub(‘index.php’);
$phar->setStub(“#!/usr/bin/env php\n” . $defaultStub);
echo “PHARファイルを作成しました: ” . $pharFile . PHP_EOL;
?>
実行時は、コマンドラインから `php myapp.phar` と打つだけで、内部の `index.php` が起動します。
5. 応用・注意点：現場での運用Tips
PHARを活用する上で、以下の点に注意してください。
・phar.readonly設定
PHPの設定（php.ini）で `phar.readonly` が `On` になっていると、PHARファイルの作成や編集ができません。開発環境では `Off` に設定してください。
・署名とセキュリティ
PHARはファイル改ざん検知のためにOpenSSLによる署名が可能です。配布物として公開する場合は、必ず署名を付与し、実行側で検証できるように構成しましょう。
・include/requireの挙動
PHAR内のファイルを読み込む際は `phar://` ストリームラッパーを使用します。パスの指定でハマりやすいポイントなので、`__FILE__`定数などを活用して、常に絶対パスを意識する実装を心がけてください。
PHARを使いこなすことで、配布のストレスを減らし、よりクリーンなデプロイメント環境を実現しましょう。