(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.2.1)
Phar::setAlias — Establece el alias del archivo Phar
Nota:
Este método requiere que la variable de configuración INI
phar.readonlyesté definida a0para funcionar con los objetos Phar. De lo contrario, se lanzará una excepción PharException.
Establece el alias del archivo Phar y lo escribe como alias permanente de este archivo phar.
Un alias puede ser utilizado dentro de un archivo phar para asegurar que el uso del flujo
phar para acceder a ficheros internos funcione siempre independientemente
de la ubicación del archivo phar en el sistema de ficheros. Una alternativa consiste en confiar
en la intercepción de include
realizada por Phar o en utilizar Phar::interceptFileFuncs()
y usar rutas relativas.
alias
Una pequeña cadena con la que se referirá a este archivo durante los accesos con el flujo
phar.
Retorna siempre true.
Se lanza una excepción UnexpectedValueException cuando el acceso en escritura está desactivado y se lanza una excepción PharException si el alias ya está en uso o si se ha encontrado un problema al escribir los cambios en el disco.
| Versión | Descripción |
|---|---|
| 8.4.0 | Phar::setAlias() ahora tiene un tipo de retorno provisional de tipo true. |
Ejemplo #1 Un ejemplo con Phar::setAlias()
<?php
try {
$phar = new Phar('monphar.phar');
$phar->setAlias('monp.phar');
} catch (Exception $e) {
// trata los errores
}
?>