# Phar::loadPhar

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

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

### Descripción

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

Este método se puede usar para leer el contenido de una archivo Phar externo. Esto es más útil para asignar un alias a un phar, por lo que las referencias subsiguientes al phar puedan usar el alias más corto, o para cargar archivos Phar que contengan solamente datos y no estén concebidos para la ejecución/inclusión en scripts de PHP.

### Parámetros

`filename`

  La ruta completa o relativa al archivo phar a abrir

`alias`

  El alias que puede usarse para referirse al archivo phar. Observe que muchos archivos phar especifican un alias explícito dentro del archivo phar, y que una excepción de tipo PharException será lanzada si en este caso se especifica un nuevo alias.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Errores/Excepciones

Lanza una excepción de tipo PharException si se pasa un alias y en archivo phat ya tiene uno explícito

### Ejemplos

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

Phar::loadPhar puede usarse en cualquier lugar para cargar un archivo Phar externo, mientras que Phar::mapPhar debería usarse en una rutina de interoperabilidad cargadora para un Phar.

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

### Ver también

- Phar::mapPhar() - Leer el fichero (un phar) que está en ejecución y registrar su manifiesto