array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'phar.loadphar.php', 1 => 'Phar::loadPhar', 2 => 'Carga cualquier archivo phar con un alias', ), 'up' => array ( 0 => 'class.phar.php', 1 => 'Phar', ), 'prev' => array ( 0 => 'phar.iswritable.php', 1 => 'Phar::isWritable', ), 'next' => array ( 0 => 'phar.mapphar.php', 1 => 'Phar::mapPhar', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/phar/Phar/loadPhar.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Phar::loadPhar

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

Phar::loadPhar — Carga cualquier archivo phar con un alias

Descripción

final public static Phar::loadPhar(string $filename, ?string $alias = null): bool

Este método puede ser utilizado para leer el contenido de un archivo Phar externo. Esto es principalmente útil para asignar un alias a un phar de tal forma que las referencias posteriores al phar puedan realizarse mediante un alias más corto o para cargar archivos Phar que contienen solo datos y que no están destinados a ser ejecutados/incluidos en scripts PHP.

Parámetros

filename

la ruta relativa o absoluta hacia el archivo phar a abrir

alias

El alias que podrá ser utilizado para referirse al archivo phar. Tenga en cuenta que muchos archivos phar especifican un alias explícito dentro del archivo phar, y se lanzará una excepción PharException si se especifica un nuevo alias en este caso.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Errores/Excepciones

Se lanza una excepción PharException si se pasa un alias mientras que el archivo phar ya tiene un alias explícito

Ejemplos

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

Phar::loadPhar puede ser utilizada en cualquier lugar para cargar un archivo phar externo mientras que Phar::mapPhar debe ser utilizada en un contenedor de carga para un Phar.

<?php
try {
Phar::loadPhar('/ruta/al/phar.phar', 'mi.phar');
echo file_get_contents('phar://mi.phar/fichero.txt');
} catch (PharException $e) {
echo $e;
}
?>

Ver también