(No version information available, might be only in CVS)
Phar::mount — 外部のパスあるいはファイルを phar アーカイブ内に仮想的にマウントする
Unix のファイルシステムで外部のデバイスをディレクトリツリー上にマウントできるのと同様に、 Phar::mount() を使用すると 外部のファイルやディレクトリをあたかもアーカイブ内にあるかのように参照することができるようになります。 これを使用すると、外部の設定ファイルをアーカイブ内にあるかのように扱うなどの高度な抽象化が可能となります。
マウントする場所として使用する phar アーカイブ内のパス。 phar アーカイブ内で使用した場合は、これは相対パスとなります。 それ以外の場合は、完全な phar URL にしなければなりません。
phar アーカイブ内にマウントしたい外部ファイルあるいはディレクトリのパスあるいは URL。
返り値はありません。失敗した場合は PharException をスローします。
パスのマウント時に問題が発生した場合は PharException をスローします。
例1 Phar::mount() の例
次の例は、外部の設定ファイルをまるでそれが phar アーカイブ内のパス上にあるかのように扱うものです。
まず、phar アーカイブ内のコードを示します。
<?php
$configuration = simplexml_load_string(file_get_contents(
Phar::running(false) . '/config.xml'));
?>
次は、設定ファイルをマウントする外部コードです。
<?php
// まずは、抽象化した config.xml
// と実際のディスク上のファイルを関連づけます
Phar::mount('phar:///path/to/archive.phar/config.xml', '/home/example/config.xml');
// アプリケーションを実行します
include '/path/to/archive.phar';
?>
もうひとつの方法として、コードを phar アーカイブのスタブ内に置くというものがあります。 これは、ユーザが設定ファイルを指定しなかった場合にデフォルトの設定ファイルを使用する例です。
<?php
// まずは、抽象化した config.xml
// と実際のディスク上のファイルを関連づけます
if (defined('EXTERNAL_CONFIG')) {
Phar::mount('config.xml', EXTERNAL_CONFIG);
if (file_exists(__DIR__ . '/extra_config.xml')) {
Phar::mount('extra.xml', __DIR__ . '/extra_config.xml');
}
} else {
Phar::mount('config.xml', 'phar://' . __FILE__ . '/default_config.xml');
Phar::mount('extra.xml', 'phar://' . __FILE__ . '/default_extra.xml');
}
// アプリケーションを実行します
include 'phar://' . __FILE__ . '/index.php';
__HALT_COMPILER();
?>
...and the code externally to load this phar archive:
<?php
define('EXTERNAL_CONFIG', '/home/example/config.xml');
// アプリケーションを実行します
include '/path/to/archive.phar';
?>