array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'phar.setalias.php', 1 => 'Phar::setAlias', 2 => 'Define o apelido para o arquivo Phar', ), 'up' => array ( 0 => 'class.phar.php', 1 => 'Phar', ), 'prev' => array ( 0 => 'phar.running.php', 1 => 'Phar::running', ), 'next' => array ( 0 => 'phar.setdefaultstub.php', 1 => 'Phar::setDefaultStub', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/phar/Phar/setAlias.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Phar::setAlias

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

Phar::setAlias — Define o apelido para o arquivo Phar

Descrição

public Phar::setAlias(string $alias): true

Nota:

Este método requer que a configuração phar.readonly do php.ini seja definida como 0 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.

Parâmetros

alias

Uma string abreviada à qual este arquivo pode ser referenciado no acesso ao empacotador de fluxo phar.

Valor Retornado

Sempre retorna true.

Erros/Exceções

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.

Registro de Alterações

Versão Descrição
8.4.0 Phar::setAlias() agora tem um retorno provisório de true.

Exemplos

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

<?php
try {
$phar = new Phar('meuphar.phar');
$phar->setAlias('mp.phar');
} catch (Exception $e) {
// lida com erros
}
?>

Veja Também