導入: なぜ今、PHP Archive (Phar) なのか
PHP開発において、アプリケーションの配布やデプロイは避けて通れない課題です。特に、複数のファイルで構成されるライブラリやツールを配布する際、ファイル管理の煩雑さがネックになることがあります。そこで活用したいのが「PHP Archive」、通称「Phar」です。
Pharは、JavaのJARファイルのように、複数のPHPファイルを一つのアーカイブファイルにまとめ、単体で実行可能にする仕組みです。本記事では、Pharの基本知識と、実務で役立つ作成・利用方法を解説します。
基礎知識: Pharとは何か
Pharは、PHP 5.3.0から標準で導入された機能です。拡張子が「.phar」のファイルを作成し、その中にライブラリや設定ファイル、画像などのリソースを同梱できます。これにより、配布先でComposerによる依存解決を強制することなく、単一のファイルとして配布できるため、CLIツールや配布用スクリプトの作成において非常に強力なツールとなります。
実装/解決策: Pharファイルの作成手順
Pharを作成するには、PHPの`Phar`クラスを使用します。重要なステップは以下の3点です。
1. `phar.readonly`設定をphp.iniでオフにする（作成時のみ）。
2. `Phar`オブジェクトを生成し、ディレクトリをアーカイブに追加する。
3. スタブ（Stub）と呼ばれる、実行時のエントリポイントとなるコードを設定する。
サンプルプログラム: シンプルなPhar作成スクリプト
以下のコードを実行すると、指定したソースディレクトリの内容を`myapp.phar`として固めることができます。
buildFromDirectory(dirname(__FILE__) . ‘/src’);
// 4. スタブの設定（エントリポイント）
// Phar実行時に最初に読み込まれるファイルを指定
$defaultStub = $phar->createDefaultStub(‘index.php’);
$phar->setStub(“#!/usr/bin/env php\n” . $defaultStub);
echo “Pharファイルの作成が完了しました。\n”;
?>
応用・注意点: 現場での運用Tips
セキュリティと権限
Pharファイルは実行可能にするために`chmod +x`が必要な場合があります。また、外部から読み込まれるPharファイルには署名（Signature）を付与することが推奨されます。`$phar->setSignatureAlgorithm(Phar::SHA256);`を実行することで、改ざん検知が可能です。
デバッグ時の注意
開発中のデバッグにおいて、Phar内部のファイルを直接修正することはできません。修正するたびに再ビルドが必要です。そのため、開発時は通常のディレクトリ構成でテストし、リリース時のみビルドするCI/CDパイプラインを構築しておくのが現場の定石です。
互換性
PHPのバージョンによっては、Pharの圧縮形式（Gzip/Bzip2）がサポートされていない環境があるため、配布先環境の確認は必須です。特別な理由がない限り、圧縮なしの形式で作成するのが最もトラブルが少ないでしょう。