PharData::buildFromDirectory
En esta página
PharData::buildFromDirectory
Construye un archivo tar/zip a partir de los ficheros de un directorio
Descripción#
public PharData::buildFromDirectory(string $directory, [string $pattern]): array
```php
Rellena un archivo tar/zip a partir del contenido de un directorio. El segundo argumento opcional es una expresión regular (pcre) utilizada para excluir ficheros. Cualquier fichero cuyo nombre cumpla la expresión será incluido, todos los demás serán excluidos. Para un control más fino, utilice `PharData::buildFromIterator`.
## Parámetros
`directory`
La ruta relativa o absoluta hacia el directorio que contiene todos los ficheros a añadir al archivo.
`pattern`
Una expresión regular opcional que se utiliza para filtrar la lista de ficheros. Solo los ficheros cuyos nombres cumplan la expresión serán incluidos en el archivo.
## Valores devueltos
`Phar::buildFromDirectory` devuelve un array asociativo que hace corresponder una ruta de fichero interno con una ruta completa en el sistema de ficheros, o `false` si ocurre un error.
## Errores/Excepciones
Este método lanza una excepción `BadMethodCallException` cuando no es capaz de instanciar los iteradores internos de directorio, o una excepción `PharException` si se han encontrado errores durante el registro del archivo phar.
## Historial de cambios
| Versión | Descripción |
|---------|------------------------------------------------------|
| 8.1.0 | PharData::buildFromDirectory ya no devuelve `false`. |
## Ejemplos
Un ejemplo con `PharData::buildFromDirectory`
```php
Véase también#
Phar::buildFromDirectory, PharData::buildFromIterator