Archive_Tar::extractModify()

説明

このメソッドはアーカイブの全ての内容を path で指定されたディレクトリに伸長します。 ファイルやディレクトリの記録されたパスが該当する場合、 ファイルやディレクトリパスの最初にある remove_path が削除されます。

ファイルを伸長している間、ファイルがすでに存在する場合は、 最終更新日を確認することなく置換されます。 もしファイルがすでに存在しており書き込み保護されている場合、 伸長は中止されます。 もし同名のディレクトリがすでに存在する場合、伸長は中止されます。

ディレクトリを伸長している間、同名のファイルがすでに存在している場合は 伸長が中止されます。 ファイルやディレクトリを伸長している間、伸長先のディレクトリが存在し かつ書き込み保護されている、もしくは存在しないかつ作成できない場合、 伸長は中止されます。 もし伸長後のファイルが正しいファイルサイズではない場合、 伸長は中止されます。

パラメータ

• string $path - ファイルやディレクトリを伸長するために必要な ディレクトリのパスを指定します。

• string $remove_path - ファイルやディレクトリパスの最初に現れる場合に削除する 記録されたパスの一部を指定します

返り値

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

例外・エラー

注意

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

例

// tarname.tar は以下のファイルを含む :
//   dev/data/file.txt
//   dev/data/log.txt
//   readme.txt

$tar_object = new Archive_Tar("tarname.tar");
$tar_object->extractModify("install", "dev");

// 伸長されるファイルは以下の通り :
//   install/data/file.txt
//   install/data/log.txt
//   install/readme.txt

// tarname.tar は以下のファイルを含む :
//   dev/data/file.txt
//   dev/data/log.txt
//   readme.txt

$tar_object = new Archive_Tar("tarname.tar");
$tar_object->extractModify("d:\\install\\temp", "dev");

// 伸長されるファイルは以下の通り :
//   d:\\install\\temp\\data\\file.txt
//   d:\\install\\temp\\data\\log.txt