array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'phar.setalias.php', 1 => 'Phar::setAlias', 2 => 'Establece el alias del archivo 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' => 'es', '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 — Establece el alias del archivo Phar

Descripción

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

Nota:

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

Ejemplo #1 Un ejemplo con Phar::setAlias()

<?php
try {
$phar = new Phar('monphar.phar');
$phar->setAlias('monp.phar');
} catch (Exception $e) {
// trata los errores
}
?>

Ver también