Phar::addFile
En esta página
Phar::addFile
Añade un fichero del sistema de ficheros al archivo phar
Descripción#
public Phar::addFile(string $filename, [string $localName]): void
```php
> [!NOTE]
> Este método requiere que la variable de configuración INI `phar.readonly` esté definida a `0` para funcionar con los objetos `Phar` . De lo contrario, se lanzará una excepción `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 `string`, 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`.
## Parámetros
`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.
## Valores devueltos
No hay valor de retorno, se lanza una excepción en caso de fallo.
## Historial de cambios
| Versión | Descripción |
|---------|--------------------------------|
| 8.0.0 | `localName` ahora es nullable. |
## Ejemplos
Un ejemplo con `Phar::addFile`
```php
Notas#
[!NOTE]
Phar::addFile,Phar::addFromStringyPhar::offsetSetregistran un nuevo archivo phar cada vez que son llamadas. Si las prestaciones son una preocupación,Phar::buildFromDirectoryoPhar::buildFromIteratordeberían ser utilizadas en su lugar.
Véase también#
Phar::offsetSet, PharData::addFile, Phar::addFromString, Phar::addEmptyDir