Forum und email

Phar::mapPhar

(PECL phar:1.0.0-1.2.1)

Phar::mapPhar — Reads the currently executed file (a phar) and registers its manifest

Beschreibung

mixed Phar::mapPhar ([ string $alias [, int $dataoffset ]] )

This static method can only be used inside a Phar archive's loader stub in order to initialize the phar when it is directly executed, or when it is included in another script.

Parameter Liste

alias

The alias with which this phar should be referred to.

dataoffset

Rückgabewerte

Gibt bei Erfolg TRUE zurück, im Fehlerfall FALSE.

Fehler/Exceptions

PharException is thrown if not called directly within PHP execution, if no __HALT_COMPILER(); token is found in the current source file, or if the file cannot be opened for reading.

Beispiele

Example#1 A Phar::mapPhar() example

mapPhar should be used only inside a phar's loader stub. Use loadPhar to load an external phar into memory.

Here is a sample Phar loader stub that uses mapPhar.

<?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(
'Cannot initialize Phar');
}
__HALT_COMPILER();

Siehe auch