Phar::loadPhar

(PHP 5 >= 5.3.0, PHP 7, PECL phar >= 1.0.0)

Phar::loadPharЗагрузить phar-архив с псевдонимом

Описание

final public static Phar::loadPhar ( string $filename , string $alias = ? ) : bool

Может использоваться для загрузки внешнего Phar-архива. То, что для phar-архива назначается псевдоним, позволяет в дальнейшем использовать более короткие ссылки для доступа к нему или же для загрузки архивов Phar, содержащих только данные и не предназначеных для выполнения.

Список параметров

filename

Путь к загружаемому phar-архиву

alias

Псевдоним для доступа к архиву. Обратите внимание, что многие phar-архивы имеют свой явно заданный псевдоним и, при задании нового псевдонима, будет выброшено исключение PharException.

Возвращаемые значения

Возвращает true в случае успешного завершения или false в случае возникновения ошибки.

Ошибки

Если задан параметр с псевдонимом, а загружаемый архив уже имеет псевдоним, то будет выброшено исключение PharException

Примеры

Пример #1 Пример использования Phar::loadPhar()

Phar::loadPhar можно использовать где угодно, тогда как Phar::mapPhar только в загрузчике (stub) 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;
}
?>

Смотрите также

  • Phar::mapPhar() - Прочитать текущий запущенный phar-архив и зарегистрировать его манифест