Phar::mapPhar
(PHP >= 5.3.0, PECL phar >= 1.0.0)
Phar::mapPhar — 現在実行されている (phar 形式の) ファイルを読み込み、その内容を登録する
説明
final public static bool Phar::mapPhar
([ string
$alias
[, int $dataoffset = 0
]] )この静的メソッドは、直接実行されたときや 他のスクリプトからインクルードされたときに Phar アーカイブのローダスタブ内で使用され、 phar を初期化します。
パラメータ
-
alias -
このアーカイブを参照する際にフルパスのかわりに使用する、 phar:// 形式の URL。
-
dataoffset -
未使用。PEAR の PHP_Archive との互換性のために用意しています。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
エラー / 例外
PHP から直接コールされなかった場合、 ソースファイル内に __HALT_COMPILER(); トークンがなかった場合、 あるいはファイルを読み込みモードでオープンできなかった場合に PharException をスローします。
例
例1 Phar::mapPhar() の例
mapPhar は、phar のローダスタブ内でのみ使用します。 外部の phar をメモリに読み込むには、loadPhar を使用します。
mapPhar を使用する Phar ローダスタブの例は、このようになります。
<?php
function __autoload($class)
{
include 'phar://me.phar/' . str_replace('_', '/', $class) . '.php';
}
try {
Phar::mapPhar('me.phar');
include 'phar://me.phar/startup.php';
} catch (PharException $e) {
echo $e->getMessage();
die('Phar を初期化できません');
}
__HALT_COMPILER();
忘却曲線を使ってこの知識を確実に記憶に残す
