(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
Nota:
Este método requiere que la opción de php.ini
phar.readonly
esté establecida a0
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().
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.
No devuelve ningún valor, se lanza una excepción en caso de error.
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í
}
?>