PharData::buildFromDirectory

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

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

Beschreibung

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

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

directory: The full or relative path to the directory that contains all files to add to the archive.
pattern: 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, Bei einem Fehler wird false zurückgegeben..

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.

Changelog

Version	Beschreibung
8.1.0	PharData::buildFromDirectory() no longer returns `false`.

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
$phar2->buildFromDirectory(dirname(__FILE__) . '/project', '/\.php$/');
?>

Siehe auch

Phar::buildFromDirectory() - Construct a phar archive from the files within a directory
PharData::buildFromIterator() - Construct a tar or zip archive from an iterator

add a note

User Contributed Notes 1 note

down

dan ¶

5 years ago


buildFromDirectory won't add empty subdirectories on 7.2

add a note