Archive_Tar::createModify()
Archive_Tar::createModify() – 新規アーカイブファイルを作成する
Synopsis
require_once 'Archive/Tar.php';
boolean createModify (
array $filelist
, string
$add_dir
, string
$remove_dir = ''
)
Description
このメソッドはアーカイブファイルを作成し、リストされたファイル
もしくはディレクトリを追加します。
もし同名の tar ファイルが存在していて書き込み可能な場合、
新しい tar アーカイブに置換されます。この場合、'追加' ではなく '作成'
されます。
もしファイルが存在し書き込み保護されている、もしくはフォルダの場合、
置換されません。
Parameter
-
mixed $filelist
-
ファイル名やディレクトリ名の配列、
もしくは単一のスペースで区切られた文字列を指定します
-
string $add_dir
-
リストにある各要素に追加するパスを含む文字列を指定します
-
string $remove_dir
-
該当する場合、
リストにある各要素から削除するパスを含む文字列を指定します。
デフォルトは空文字列です。
Return value
boolean
- Returns TRUE on success, FALSE on failure.
Throws
Possible PEAR_Error values
エラーコード |
エラーメッセージ |
理由 |
解決法 |
NULL |
"Invalid file list" |
関数に対する引数が正しくフォーマット、
あるいは構成されていません
|
引数のタイプミスを確認してください
|
Note
This function can not be called
statically.
Example
圧縮されたアーカイブの新規ディレクトリにファイルを追加する
<?php
$tar_object = new Archive_Tar("tarname.tgz", true);
$tar_object->setErrorHandling(PEAR_ERROR_PRINT);
$v_list[0]="dev/file.txt";
$v_list[1]="dev/data/";
$v_list[2]="log/file.log";
$tar_object->createModify($v_list, "install", "dev");
// アーカイブにストアされているファイルは次の通り :
// install/file.txt
// install/data
// install/data/file1.txt
// install/data/... data/ の全てのファイルやサブディレクトリ
// install/log/file.log
?>
圧縮されたアーカイブの新規ディレクトリにファイルを追加する
(特に Windows の場合)
<?php
$tar_object = new Archive_Tar("tarname.tgz", true);
$tar_object->setErrorHandling(PEAR_ERROR_PRINT);
$v_list[0]="c:\\dev\\file.txt";
$v_list[1]="c:\\dev\\data\\";
$v_list[2]="c:\\log\\file.log";
$tar_object->createModify($v_list, "install/temp", "c:\\dev");
// アーカイブにストアされているファイルは次の通り :
// install/temp/file.txt
// install/temp/data
// install/temp/data/file1.txt
// install/temp/data/... data/ の全てのファイルやサブディレクトリ
// install/temp/log/file.log
?>