Phar::addFile

(PHP 5 >= 5.3.0, PHP 7, PECL phar >= 2.0.0)

Phar::addFile — Añadir un fichero desde el sistema de ficheros al archivo phar

Descripción

public Phar::addFile ( string $file [, string $localname ] ) : void

Nota:

Este método requiere que la opción de php.ini phar.readonly esté establecida a 0 para que trabaje con objetos Phar. De otra manera, se lanzará una excepción de tipo PharException.

Con este método, cualquier fichero o URL se puede añadir al arcivo phar. Si se especifica el segundo parámetro opcional localname, el fichero será almacenado en el archivo con el nombre dado por el parámetro, si no se usará el parámetro file como la ruta para almacentar dentro del archivo. Las URLs deben tener un nombre local o se lanzará una excepción. Este método es similar a ZipArchive::addFile().

Parámetros

file

La ruta completa o relativa del fichero del disco a ser añadido al archivo phar.

localname

Ruta con la que el fichero será almacenado en el archivo.

Valores devueltos

No devuelve ningún valor, se lanza una excepción en caso de error.

Ejemplos

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

<?php
try {
    $a = new Phar('/ruta/a/phar.phar');

    $a->addFile('/ruta/completa/a/fichero');
    // demuestra cómo se almacena este fichero
    $b = $a['ruta/completa/a/fichero']->getContent();

    $a->addFile('/ruta/completa/a/fichero', 'mi/fichero.txt');
    $c = $a['mi/fichero.txt']->getContent();

    // demostrar el uso de una URL
    $a->addFile('http://www.ejemplo.com', 'ejemplo.html');
} catch (Exception $e) {
    // manejar los errores aquí
}
?>

Ver también