array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'phardata.buildfromdirectory.php', 1 => 'PharData::buildFromDirectory', 2 => 'Construye un archivo tar/zip a partir de los ficheros de un directorio', ), 'up' => array ( 0 => 'class.phardata.php', 1 => 'PharData', ), 'prev' => array ( 0 => 'phardata.addfromstring.php', 1 => 'PharData::addFromString', ), 'next' => array ( 0 => 'phardata.buildfromiterator.php', 1 => 'PharData::buildFromIterator', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/phar/PharData/buildFromDirectory.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 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