Phar::buildFromDirectory

public Phar::buildFromDirectory(string $directory, [string $pattern]): array
```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`.

Rellena un archivo phar a partir del contenido de un directorio. El segundo parámetro, opcional, es una expresión regular (pcre) utilizada para excluir ficheros. Todo fichero cuyo nombre cumpla la expresión regular será incluido, los demás serán excluidos. Para un control más fino, utilice `Phar::buildFromIterator`.

## Parámetros

`directory`  
La ruta absoluta o relativa hacia el directorio que contiene todos los ficheros a añadir al archivo.

`pattern`  
Una expresión regular opcional utilizada para filtrar la lista de ficheros. Solo los ficheros cuyo nombre cumpla la expresión regular serán incluidos en el archivo.

## Valores devueltos

`Phar::buildFromDirectory` devuelve un array asociativo que hace corresponder la ruta interna del fichero con la ruta completa en el sistema de ficheros.

## Errores/Excepciones

Este método lanza una excepción `BadMethodCallException` cuando no es capaz de instanciar el iterador de directorio interno, o una excepción `PharException` si ha habido errores durante el guardado del archivo.

## Historial de cambios

| Versión | Descripción                                      |
|---------|--------------------------------------------------|
| 8.1.0   | Phar::buildFromDirectory ya no devuelve `false`. |

## Ejemplos

Un ejemplo con `Phar::buildFromDirectory`