Phar::addFile
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::addFile — Añadir un fichero desde el sistema de ficheros al archivo phar
Descripción
Nota:
Este método requiere que la opción de php.ini
phar.readonlyesté establecida a0para 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
- Phar::offsetSet() - Establecer el contenido de un fichero interno a aquel de un fichero externo
- PharData::addFile() - Añadir un fichero desde el sistema de ficheros al archivo tar/zip
- Phar::addFromString() - Añadir un fichero desde un string al archivo phar
- Phar::addEmptyDir() - Añadir un directorio vacío al archvo phar
add a note
