1. 導入
PHP開発において、複数のファイルで構成されるプロジェクトを配布したり、ライブラリとして提供したりする際、ファイル管理の煩雑さに頭を悩ませたことはありませんか。今回解説する「Phar（PHP Archive）」は、JavaのJARファイルのように、複数のPHPファイルを一つのアーカイブファイルにまとめ、実行可能にする仕組みです。本記事では、Pharの基本概念から実務での活用方法までを解説します。
2. 基礎知識
Pharとは「PHP Archive」の略称で、PHP 5.3.0以降で標準的に提供されている拡張機能です。PHPスクリプト、設定ファイル、画像などをひとまとめにして配布できるため、デプロイメントの簡略化や、配布先での環境依存の軽減に役立ちます。
PHPの内部でPharアーカイブを扱うには、php.iniで「phar.readonly = Off」に設定する必要があります。開発環境では忘れずに設定しておきましょう。
3. 実装/解決策
Pharを作成するには、Pharクラスを使用します。主な手順は以下の3ステップです。
1. Pharオブジェクトの生成：アーカイブ名と保存場所を指定します。
2. ファイルの追加：プロジェクト内のディレクトリやファイルをアーカイブに含めます。
3. スタブ（Stub）の設定：アーカイブ実行時に最初に読み込まれるエントリーポイントを設定します。
4. サンプルプログラム
以下は、特定のディレクトリ配下を「app.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 app.phar
5. 応用・注意点
注意点として、Pharアーカイブは「読み取り専用」として扱うのが原則です。アーカイブ内部のファイルを動的に書き換えるような設計は避けましょう。
実務での活用としては、Composerでインストールするツールを単一のPharファイルとしてビルドすることで、インストール先での依存関係解決を省き、配布後の動作安定性を高めることができます。また、署名機能（Phar::setSignatureAlgorithm）を利用すれば、配布したアーカイブが改ざんされていないかを検証することも可能です。セキュリティと利便性を両立させるために、ぜひ導入を検討してみてください。