関数・クラス解説

Phar::mount

version:PHP 5 >= 5.3.0, PHP 7, PECL phar (公式)

外部のパスあるいはファイルを phar アーカイブ内に仮想的にマウントする

公式リファレンス

書式

final public static Phar::mount ( string $pharpath , string $externalpath ) : void

説明

Unix のファイルシステムで外部のデバイスをディレクトリツリー上にマウントできるのと同様に、 Phar::mount() を使用すると 外部のファイルやディレクトリをあたかもアーカイブ内にあるかのように参照することができるようになります。 これを使用すると、外部の設定ファイルをアーカイブ内にあるかのように扱うなどの高度な抽象化が可能となります。

パラメータ

pharpath
マウントする場所として使用する phar アーカイブ内のパス。 これは phar アーカイブ内の相対パスでなければならず、また、 既に存在するパスを指定することはできません。
externalpath
phar アーカイブ内にマウントしたい外部ファイルあるいはディレクトリのパスあるいは URL。

返値

返り値はありません。失敗した場合は PharException をスローします。

エラー

パスのマウント時に問題が発生した場合は PharException をスローします。

サンプル

例1 Phar::mount() の例

次の例は、外部の設定ファイルをまるでそれが phar アーカイブ内のパス上にあるかのように扱うものです。

まず、phar アーカイブ内のコードを示します。

$configuration = simplexml_load_string(file_get_contents(     Phar::running(false) . '/config.xml'));

次は、設定ファイルをマウントする外部コードです。

// まずは、抽象化した config.xml // と実際のディスク上のファイルを関連づけます Phar::mount('phar://config.xml', '/home/example/config.xml'); // アプリケーションを実行します include '/path/to/archive.phar';

もうひとつの方法として、コードを phar アーカイブのスタブ内に置くというものがあります。 これは、ユーザーが設定ファイルを指定しなかった場合にデフォルトの設定ファイルを使用する例です。

// まずは、抽象化した 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:

define('EXTERNAL_CONFIG', '/home/example/config.xml'); // アプリケーションを実行します include '/path/to/archive.phar';

ワード検索


※入力キーワードが、関数名・説明文・タグに含まれるものを検索

関数名アルファベット別

A B C D E F G H I J
K L M N O P Q R S T
U V W X Y Z _

最終更新一覧

stristr
 大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

stripslashes
 バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

stripos
 大文字小文字を区別せずに文字列が最初に現れる位置を取得する

stripcslashes
 addcslashes() でクォートされた文字列をアンクォートする

strip_tags
 文字列から HTML と PHP のタグを除去して返却

strcspn
 指定した文字が最初に現れる位置を調べる

strcoll
 ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

strcmp
 2つの文字列を比較し同じか(あるいは大小)を判定する

strchr
 strstr() のエイリアス

strcasecmp
 2つの文字列を比較(大文字小文字を区別せず同じとみなす)

カテゴリー一覧

PHP の振る舞いの変更
音声フォーマットの操作
認証サービス
コマンドライン関連
圧縮およびアーカイブ
暗号
データベース関連
日付および時刻関連
ファイルシステム
自然言語および文字エンコーディング
画像処理および作成
メール関連
数学
テキスト以外の MIME 型
プロセス制御
その他の基本モジュール
その他のサービス
検索エンジン用の拡張モジュール
サーバー固有のモジュール
セッション関連
テキスト処理
変数・データ型関連
ウェブサービス
Windows 用のモジュール
XML 操作
GUI用の拡張モジュール