Phar::loadPhar

Podręcznik PHP
Poprzedni		Następny

Phar::loadPhar

(no version information, might be only in CVS)

Phar::loadPhar -- Loads any phar archive with an alias

Opis

bool Phar::loadPhar ( string filename [, string alias] )

This can be used to read the contents of an external Phar archive. This is most useful for assigning an alias to a phar so that subsequent references to the phar can use the shorter alias, or for loading Phar archives that only contain data and are not intended for execution/inclusion in PHP scripts.

Parametry

filename: the full or relative path to the phar archive to open
alias: The alias that may be used to refer to the phar archive. Note that many phar archives specify an explicit alias inside the phar archive, and a PharException will be thrown if a new alias is specified in this case.

Zwracane wartości

Zwraca TRUE w przypadku sukcesu, FALSE w przypadku porażki.

Błędy/Wyjątki

PharException is thrown if an alias is passed in and the phar archive already has an explicit alias

Przykłady

Przykład 1. A Phar::loadPhar() example

Phar::loadPhar can be used anywhere to load an external Phar archive, whereas Phar::mapPhar should be used in a loader stub for a Phar.


<?php
try {
    Phar::loadPhar('/path/to/phar.phar', 'my.phar');
    echo file_get_contents('phar://my.phar/file.txt');
} catch (PharException $e) {
    echo $e;
}
?>

Patrz także

Phar::mapPhar()

Tools

Sonstiges

Poprzedni	Spis treści	Następny
Phar->isFlushingToPhar	Początek rozdziału