array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'phar.loadphar.php', 1 => 'Phar::loadPhar', 2 => 'Carrega qualquer arquivo phar com um apelido', ), 'up' => array ( 0 => 'class.phar.php', 1 => 'Phar', ), 'prev' => array ( 0 => 'phar.iswritable.php', 1 => 'Phar::isWritable', ), 'next' => array ( 0 => 'phar.mapphar.php', 1 => 'Phar::mapPhar', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/phar/Phar/loadPhar.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Phar::loadPhar

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

Phar::loadPhar — Carrega qualquer arquivo phar com um apelido

Descrição

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

Isto pode ser usado para ler o conteúdo de um arquivo Phar externo. Isto é mais útil para atribuir um apelido a um phar para que referências subsequentes ao phar possam usar o apelido mais curto, ou para carregar arquivos Phar que contêm apenas dados e não se destinam à execução/inclusão em scripts PHP.

Parâmetros

filename

O caminho completo ou relativo do arquivo phar a ser aberto.

alias

O apelido que pode ser usado para se referir ao arquivo phar. Observe que muitos arquivos phar especificam um apelido explícito dentro do arquivo phar, e uma PharException será lançada se um novo apelido for especificado neste caso.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

PharException é lançada se um apelido for passado e o arquivo phar já tiver um apelido explícito.

Exemplos

Exemplo #1 Um exemplo de Phar::loadPhar()

Phar::loadPhar pode ser usado em qualquer lugar para carregar um arquivo Phar externo, enquanto Phar::mapPhar deve ser usado em um stub de carregador para um Phar.

<?php
try {
Phar::loadPhar('/caminho/para/phar.phar', 'meu.phar');
echo file_get_contents('phar://meu.phar/arquivo.txt');
} catch (PharException $e) {
echo $e;
}
?>

Veja Também