PharData::addFile

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

PharData::addFile — Añadir un fichero desde el sistema de ficheros al archivo tar/zip

Descripción

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

Con este método, cualquier fichero o URL se puede añadir al arcivo tar/zip. 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 PharData::addFile()


<?php
try {
    $a = new PharData('/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

PharData::offsetSet() - Establecer el contenido de un fichero dentro de un tar/zip a aquel de un fichero o cadena externos
Phar::addFile() - Añadir un fichero desde el sistema de ficheros al archivo phar
PharData::addFromString() - Añadir un fichero desde el sistema de ficheros al archivo tar/zip
PharData::addEmptyDir() - Añadir un directorio vacío al archivo tar/zip