Net_FTP::getRecursive()
Synopsis
mixed Net_FTP::getRecursive (
string $remote_path
,
string $local_path
,
bool $overwrite = false
,
int $mode = null
)
Description
スクリプトを動作させているコンピュータに、FTP サーバから ディレクトリを丸ごとダウンロードします。
Parameter
-
string $remote_path - ダウンロードしたいディレクトリ。絶対パス、あるいは相対パスで指定します （パスの最後には '/' をつけます）。
-
string $local_path - ダウンロードしたディレクトリの保存先。絶対パス、あるいはスクリプトの ディレクトリからの相対パスで指定します（注意：include を利用している 場合、スクリプトのディレクトリはインクルード元のファイルがある場所と なります！）
-
bool $overwrite = false - ローカルファイルが存在した場合に、それを上書きするかどうか。 指定しなかった場合、ディレクトリは上書きされません。
-
int $mode = null - 定数 FTP_ASCII あるいは FTP_BINARY のどちらかを指定しなければなりません。 指定されなかった場合、ファイルの拡張子から（extensions.ini によって） モードを決定します。それにも失敗した場合は標準転送モード （mode プロパティの値）が用いられます。
Return value
mixed - 成功時には true 、それ以外は PEAR::Error
Throws
getRecursive から戻されるエラーにはいくつかの種類があります。エラー番号は （現時点では）不定で、エラーメッセージについての情報は得られません。 発生する可能性のあるエラーは以下のとおりです。
| エラーメッセージ | 説明 | 対処方法 |
|---|---|---|
| Given remote-path '$remote_path' seems not to be a directory. | あなたが指定したパスは、FTP サーバ上の有効なディレクトリではありません。 | パスが '/' で終わっていない、あるいはそのディレクトリが存在しないのでしょう。 |
| Given local-path '$local_path' seems not to be a directory. | あなたが指定したパスは、ローカルホスト上の有効なディレクトリではありません。 | パスが '/' で終わっていない、あるいはそのディレクトリが存在しないのでしょう。 |
| Could not create dir '$local_path'. | 指定されたディレクトリが作成できません。 | ディレクトリのパーミッションを確認しましょう。 |
Note
This function can not be called statically.
Example
getRecursive() の使用
<?php
var_dump($test->getRecursive('foo/', '/tmp/foo/', true));
?>
忘却曲線を使ってこの知識を確実に記憶に残す
