Phar::setAlias

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

> [!NOTE]
> Este método requiere que la variable de configuración INI `phar.readonly` esté definida a `0` para 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.

## Parámetros

`alias`  
Una pequeña cadena con la que se referirá a este archivo durante los accesos con el flujo `phar`.

## Valores devueltos

Retorna siempre `true`.

## Errores/Excepciones

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.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.4.0 | Phar::setAlias ahora tiene un tipo de retorno provisional de tipo `true`. |

## Ejemplos

Un ejemplo con `Phar::setAlias`