(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.2.1)
Phar::setAlias — Define o apelido para o arquivo Phar
Nota:
Este método requer que a configuração
phar.readonly
do php.ini seja definida como0
para funcionar com objetos Phar. Caso contrário, uma exceção PharException será lançada.
Define o apelido para o arquivo Phar e o grava como o apelido permanente
para este arquivo Phar. Um apelido pode ser usado internamente em um arquivo Phar para
garantir que o uso do empacotador de fluxo phar
para acessar arquivos internos
sempre funcione, independentemente da localização do arquivo Phar no
sistema de arquivos. Outra alternativa é confiar na interceptação de Phar de
include ou usar Phar::interceptFileFuncs()
e usar caminhos relativos.
alias
Uma string abreviada à qual este arquivo pode ser referenciado
no acesso ao empacotador de fluxo phar
.
Sempre retorna true
.
Lança UnexpectedValueException quando o acesso de gravação está desabilitado e PharException se o apelido já estiver em uso ou se algum problema for encontrado ao liberar as alterações no disco.
Versão | Descrição |
---|---|
8.4.0 | Phar::setAlias() agora tem um retorno provisório de true. |
Exemplo #1 Um exemplo de Phar::setAlias()
<?php
try {
$phar = new Phar('meuphar.phar');
$phar->setAlias('mp.phar');
} catch (Exception $e) {
// lida com erros
}
?>