(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::addFile — Añade un fichero del 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.
Mediante este método, cualquier fichero o URL puede ser añadido al archivo phar. Si
el segundo parámetro opcional localName
es un chaîne de caractères,
el fichero será almacenado en el archivo con ese nombre, de lo contrario el parámetro
filename
se utiliza como ruta hacia donde almacenar el archivo.
Las URL deben ser locales, de lo contrario se lanza una excepción.
Este método es idéntico a ZipArchive::addFile().
filename
Ruta absoluta o relativa hacia un fichero del disco a añadir al archivo phar.
localName
Ruta donde el fichero será almacenado en el archivo.
No hay valor de retorno, se lanza una excepción en caso de fallo.
Versión | Descripción |
---|---|
8.0.0 |
localName ahora es nullable.
|
Ejemplo #1 Un ejemplo con Phar::addFile()
<?php
try {
$a = new Phar('/ruta/al/phar.phar');
$a->addFile('/ruta/completa/al/fichero');
// demuestra cómo el fichero es almacenado
$b = $a['ruta/completa/al/fichero']->getContent();
$a->addFile('/ruta/completa/al/fichero', 'mi/fichero.txt');
$c = $a['mi/fichero.txt']->getContent();
// demuestra el uso de URL
$a->addFile('http://www.ejemplo.com', 'ejemplo.html');
} catch (Exception $e) {
// maneja los errores aquí
}
?>
Nota: Phar::addFile(), Phar::addFromString() and Phar::offsetSet() save a new phar archive each time they are called. If performance is a concern, Phar::buildFromDirectory() or Phar::buildFromIterator() should be used instead.