導入
PHPアプリケーションの開発現場において、複数のファイルで構成されるライブラリやツールを配布する際、ファイル管理の煩雑さに頭を悩ませることはありませんか。特にコマンドラインツールや単一の配布物として提供したい場合、ファイルが散逸することはバグの温床となります。これを解決するのが「PHAR (PHP Archive)」です。PHARは、JavaのJARファイルのように、複数のPHPファイルを1つのアーカイブにまとめ、そのまま実行可能にする仕組みです。本記事では、このPHARの仕組みと、実務で役立つ作成方法を解説します。
基礎知識
PHARは「PHP Archive」の略称で、PHP 5.3.0から標準ライブラリとして組み込まれています。内部的には、ディレクトリ構造を保持したままバイナリ形式で圧縮・アーカイブ化し、PHPインタプリタがそれを直接読み込んで実行できるように設計されています。これにより、依存ライブラリを含めたプロジェクト全体を1つのファイルとして扱い、ポータビリティを高めることが可能です。なお、PHARを実行するには、php.iniで「phar.readonly = Off」に設定されている必要があります。
実装/解決策
PHARを作成するには、PHP標準の「Phar」クラスを使用します。主な手順は以下の通りです。
1. 新規Pharアーカイブを作成し、対象ディレクトリを登録する。
2. スタブ（Stub）と呼ばれる、アーカイブ実行時に呼び出されるエントリーポイントを設定する。
3. 必要に応じて圧縮形式（GzipやBzip2）を指定する。
サンプルプログラム
以下のコードは、指定したディレクトリ内のファイルを「app.phar」という単一の実行ファイルにまとめるためのビルドスクリプトです。
buildFromDirectory(__DIR__ . ‘/src’);
// スタブ（実行時のエントリーポイント）の設定
// このファイルが直接実行された時に呼び出されます
$defaultStub = $phar->createDefaultStub(‘index.php’);
$phar->setStub(“#!/usr/bin/env php\n” . $defaultStub);
// 圧縮が必要な場合は以下を有効化
// $phar->compressFiles(Phar::GZ);
echo “PHARファイルの作成が完了しました: ” . $pharFile . PHP_EOL;
?>
応用・注意点
実務で使用する際に最も注意すべき点は、セキュリティと依存関係の管理です。PHARファイルはPHPコードをそのまま内包するため、署名（OpenSSLを利用した秘密鍵による署名）を行わないと、改ざんのリスクに晒されます。また、Composerで外部ライブラリを利用している場合は、`vendor`ディレクトリ全体をアーカイブに含める必要がありますが、その分ファイルサイズが肥大化します。
さらに、PHAR内部のコードで`__FILE__`や`dirname()`を使用すると、ホスト環境でのパスではなく「アーカイブ内のパス」を指すため、ファイル読み込み時にエラーが発生することがあります。パスを指定する際は、Phar::running()メソッドを活用し、アーカイブ内か否かを判定する処理を組み込むのが、堅牢なアプリケーション開発の鉄則です。