Archive_Tar::createModify()

Archive_Tar::createModify() -- 新規アーカイブファイルを作成する

概要

require_once 'Archive/Tar.php';

boolean createModify (array $filelist, string $add_dir [, string $remove_dir = ''])

説明

このメソッドはアーカイブファイルを作成し、リストされたファイル もしくはディレクトリを追加します。

もし同名の tar ファイルが存在していて書き込み可能な場合、 新しい tar アーカイブに置換されます。この場合、'追加' ではなく '作成' されます。 もしファイルが存在し書き込み保護されている、もしくはフォルダの場合、 置換されません。

パラメータ

返り値

boolean - 成功時には TRUE 、 失敗時には FALSE を返します。

例外・エラー

表 38-1PEAR_Error の値

エラーコードエラーメッセージ理由解決法
NULL"Invalid file list"関数に対する引数が正しくフォーマット、 あるいは構成されていません 引数のタイプミスを確認してください

注意

この関数は、スタティックにコールする ことはできません。

例 38-1圧縮されたアーカイブの新規ディレクトリにファイルを追加する


<?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
?>

例 38-2 圧縮されたアーカイブの新規ディレクトリにファイルを追加する (特に 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
?>