導入
PHPでの開発において、アプリケーションの配布やライブラリの管理は非常に重要なテーマです。特に、複数のファイルで構成されるプロジェクトを単一の実行可能ファイルとして配布したい場合や、環境依存を最小限に抑えたい場合に「PHP Archive（通称：Phar）」という形式が非常に強力な武器となります。本記事では、Pharの仕組みと、実務で役立つ作成方法について解説します。
基礎知識
PHP Archive（Phar）とは、JavaのJARファイルに似た概念で、PHPのコードやライブラリ、設定ファイルなどを一つのファイルにアーカイブ（圧縮）する仕組みです。これを用いることで、プロジェクト全体を一つのファイルとして配布でき、利用者はそのファイルをPHPで実行するだけでアプリケーションを動かすことができます。
特に、Composerでインストールするようなライブラリ群を同梱した状態で配布する場合、環境構築のハードルを劇的に下げることができます。
実装/解決策
Pharを作成するには、PHPに標準搭載されている「Pharクラス」を使用します。手順は以下の通りです。
1. php.iniの設定確認: ‘phar.readonly’ が ‘Off’ に設定されていることを確認します。
2. アーカイブの生成: 対象のディレクトリをスキャンし、Pharオブジェクトにファイルを追加します。
3. スタブ（Stub）の設定: Pharファイルが実行された際に、最初に読み込まれるPHPコード（エントリポイント）を定義します。
サンプルプログラム
以下のコードは、指定したディレクトリ内のPHPファイルを一つの「app.phar」にまとめるスクリプト例です。
buildFromDirectory($srcRoot);
// 実行時のスタブを設定（エントリポイントを指定）
$defaultStub = $phar->createDefaultStub(‘index.php’);
$phar->setStub(“#!/usr/bin/env php\n” . $defaultStub);
echo “Pharファイルの作成が完了しました: ” . $pharFile . PHP_EOL;
// 実行確認用：php app.phar で実行可能になります
?>
応用・注意点
現場でPharを活用する際には、以下の点に注意してください。
1. セキュリティ設定
Pharファイルは実行可能であるため、署名を行うことが推奨されます。’setSignatureAlgorithm’ メソッドを使用して、SHA1やSHA256などで署名を行い、改ざんを検知できるようにしましょう。
2. パスの取り扱い
Phar内部のファイルにアクセスする際は、通常のパス指定と異なり、’phar://’ スキームを使用する必要があります。ファイル読み込み時に ‘file_get_contents(‘phar:///path/to/app.phar/config.json’)’ のように記述することで、正しくアーカイブ内のファイルを操作可能です。
3. 依存関係の管理
Composerでインストールしたライブラリ（vendorディレクトリ）をPharに含める場合は、容量が大きくなりすぎないよう注意が必要です。開発用の依存パッケージは除外するようにビルドプロセスを調整しましょう。
Pharを使いこなすことで、ツール配布やCLIアプリケーションの構築がよりスムーズになります。ぜひ、自身の開発ワークフローに取り入れてみてください。