Net_FTP::getRecursive()

Net_FTP::getRecursive() – スクリプトを動作させているコンピュータ上にディレクトリを丸ごとダウンロードする

Synopsis

require_once 'Net/FTP.php';

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 から戻されるエラーにはいくつかの種類があります。エラー番号は (現時点では)不定で、エラーメッセージについての情報は得られません。 発生する可能性のあるエラーは以下のとおりです。

Possible PEAR_Error values
エラーメッセージ 説明 対処方法
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));
    
?>
ファイルを FTP サーバにアップロードする (Previous) ディレクトリを丸ごと FTP サーバにアップロードする (Next)
Last updated: Sun, 21 Dec 2014 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.