トップページ　→関数リファレンス　→圧縮およびアーカイブ　→Phar　→PharData

関数・クラス解説

PharData::buildFromDirectory

version:PHP 5 >= 5.3.0, PHP 7, PECL phar (公式)

ディレクトリ内のファイルから tar/zip アーカイブを作成する

公式リファレンス

書式

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

説明

ディレクトリの中身をもとに tar/zip アーカイブを作成します。オプションの 2 番目のパラメータで正規表現 (pcre) を指定すると、特定のファイルを除外することができます。正規表現にマッチするすべてのファイルがアーカイブに含められ、それ以外のファイルは除外されます。より詳細に制御するには PharData::buildFromIterator() を使用します。

パラメータ

base_dir: アーカイブに追加するすべてのファイルを含むディレクトリへのフルパスあるいは相対パス。
regex: オプションで指定する pcre 正規表現。これを使用してファイル一覧をフィルタリングします。正規表現にマッチするファイルパスのみがアーカイブに追加されます。

返値

Phar::buildFromDirectory() は、連想配列を返します。これは、ファイルの内部パスをファイルシステム上のフルパスを対応させたものです。

エラー

このメソッドは、内部ディレクトリイテレータのインスタンスの作成に失敗したときに BadMethodCallException をスローします。また、phar アーカイブの保存時にエラーが発生した場合は PharException をスローします。

サンプル

例1 PharData::buildFromDirectory() の例 

$phar = new PharData('project.tar');
// project 内のすべてのファイルを追加します
$phar->buildFromDirectory(dirname(__FILE__) . '/project');

$phar2 = new PharData('project2.zip');
// project 内のファイルのうち、php ファイルだけを追加します
$phar2->buildFromDirectory(dirname(__FILE__) . '/project', '/\.php$/');