Dutch PHP Conference 2025 - Call For Papers

PharData::buildFromDirectory

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

PharData::buildFromDirectoryConstruct a tar/zip archive from the files within a directory

Опис

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().

Параметри

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.

Значення, що повертаються

Phar::buildFromDirectory() returns an associative array mapping internal path of file to the full path of the file on the filesystem, або false в разі помилки.

Помилки/виключення

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

Журнал змін

Версія Опис
8.1.0 PharData::buildFromDirectory() no longer returns false.

Приклади

Приклад #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$/');
?>

Прогляньте також

add a note

User Contributed Notes 1 note

up
0
dan
4 years ago
buildFromDirectory won't add empty subdirectories on 7.2
To Top