PharData::addFromString
PharData::buildFromIterator
PharData
PHP Manual

# PharData::buildFromDirectory

(No version information available, might be only in CVS)

PharData::buildFromDirectory — Construct a tar/zip archive from the files within a directory.

### Beschreibung

array Phar::buildFromDirectory ( string `$base_dir` [, string `$regex` ] )

Populate a tar/zip archive from directory contents. The optional second parameter is a regular expression (pcre) that is used to exclude files. Any filename that matches the regular expression will be included, all others will be excluded. For more fine-grained control, use PharData::buildFromIterator().

### Parameter-Liste

`base_dir`

  The full or relative path to the directory that contains all files to add to the archive.

`regex`

  An optional pcre regular expression that is used to filter the list of files. Only file paths matching the regular expression will be included in the archive.

### Rückgabewerte

Phar::buildFromDirectory() returns an associative array mapping internal path of file to the full path of the file on the filesystem.

### Fehler/Exceptions

This method throws BadMethodCallException when unable to instantiate the internal directory iterators, or a PharException if there were errors saving the phar archive.

### Beispiele

Beispiel #1 A PharData::buildFromDirectory() example

`<?php
$phar = new PharData('project.tar');
// add all files in the project
$phar->buildFromDirectory(dirname(__FILE__) . '/project');
$phar2 = new PharData('project2.zip');
// add all files in the project, only include php files
$phar->buildFromDirectory(dirname(__FILE__) . '/project', '/\.php$/');
?>`

### Siehe auch

- Phar::buildFromDirectory()
- PharData::buildFromIterator()

PharData::addFromString
PharData::buildFromIterator
PharData
PHP Manual