Archive_Tar::extractList()
Archive_Tar::extractList() – リスとされたファイルを伸長する
Synopsis
require_once 'Archive/Tar.php';
boolean extractList (
array $filelist
, string
$path = ''
, string
$remove_path = ''
)
Description
このメソッドは $filelist で指定されたファイルのみをアーカイブから伸長します。 これらのファイルはカレントディレクトリもしくはオプションの $path パラメータで指定されたディレクトリに伸長されます。
Parameter
-
string $filelist - ファイル名やディレクトリ名の配列、 もしくはスペースで区切られた単一の文字列を指定します。
-
string $path - ファイルやディレクトリを伸長するために必要な ディレクトリのパスを指定します。
-
string $remove_path - ファイルやディレクトリパスの最初に現れる場合に削除する 記録されたパスの一部を指定します
Return value
boolean - Returns TRUE on success, FALSE on failure.
Throws
| エラーコード | エラーメッセージ | 理由 | 解決法 |
|---|---|---|---|
| NULL | " Unable to open in read mode archive " | ファイルが他のアプリケーションによって排他的にロックされています。 | 当該ファイルを使用している他のアプリケーションを確認してください。 これは競合する Archive_Tar でアーカイブを処理している場合は発生しません。 |
| NULL | " Unable to open in write mode archive " | ファイルが他のアプリケーションによってロックされています。 | 当該ファイルを使用している他のアプリケーションを確認してください。 これは競合する Archive_Tar でアーカイブを処理している場合に発生するかも知れません。 |
| NULL | " Invalid extractlist mode mode " | 実装エラーです。 | 発生しないはずですが、その場合はバグレポートをお願いします。 |
| NULL | " Directory name already exists as a file " | そのファイルはアーカイブ中でディレクトリとしてマークされています。 | 壊れたアーカイブなのかも知れません |
| NULL | " File name already exists as a directory " | そのディレクトリはアーカイブ中でファイルとしてマークされています。 | 壊れたアーカイブなのかも知れません |
| NULL | " File name already exists and is write protected. " | アーカイブは伸長先ディレクトリにすでに存在しているファイルを 含んでおり、上書きすることができません。 | 空のディレクトリにアーカイブを伸長してください。 |
| NULL | " Unable to create path for name " | 1 つもしくはそれ以上のネストした新規ディレクトリは 伸長先ディレクトリに生成できません。 | 伸長先ディレクトリと全てのネストしたディレクトリが 要求される権限を持っているか確認してください。 |
| NULL | " Unable to create directory name " | ディレクトリを伸長先ディレクトリに生成することができませんでした。 | 伸長先ディレクトリに要求される権限を持っているか確認してください。 |
| NULL | " Error while opening name in write binary mode " | ファイルを生成することができませんでした。 | ファイルがロックされている可能性があります。 |
| NULL | " Extracted file filename does not have the correct file size filesize (size expected). Archive may be corrupted. " | メッセージを参照してください。 | メッセージを参照してください。 |
Note
This function can not be called statically.
Example
圧縮されたアーカイブを伸長する
<?php
// tarname.tar は以下のファイルを含む :
// dev/data/file.txt
// dev/data/log.txt
// readme.txt
$tar_object = new Archive_Tar("tarname.tar");
$tar_object->extractList("dev/data/file.txt readme.txt", "install",
"dev");
// 伸長されるファイルは以下の通り :
// install/data/file.txt
// install/readme.txt
?>
忘却曲線を使ってこの知識を確実に記憶に残す
