Construye un archivo tar/zip a partir de los ficheros de un directorio

# PharData::buildFromDirectory

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

PharData::buildFromDirectory — Construye un archivo tar/zip a partir de los ficheros de un directorio

### Descripción

public function PharData::buildFromDirectory(string `$directory`, string `$pattern` = ""): array

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

Ejemplo #1 Un ejemplo con PharData::buildFromDirectory()

    <?php
    $phar = new PharData('projet.tar');
    // añade todos los ficheros al proyecto
    $phar->buildFromDirectory(dirname(__FILE__) . '/projet');

    $phar2 = new PharData('projet2.zip');
    // añade todos los ficheros al proyecto incluyendo solo los ficheros php
    $phar2->buildFromDirectory(dirname(__FILE__) . '/projet', '/\.php$/');
    ?>

### Ver también

- Phar::buildFromDirectory() - Construye un archivo phar a partir de los ficheros de un directorio
- PharData::buildFromIterator() - Construye un archivo tar o zip a partir de un iterador

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open