string $local_file -
アップロードしたいファイル名。絶対パス、あるいはスクリプトの
ディレクトリからの相対パスで指定します(注意:include を利用している
場合、スクリプトのディレクトリはインクルード元のファイルがある場所と
なります!)
string $remote_file - アップロード先のパス
(ファイル名を含む)。絶対パス、あるいは相対パスで指定します
(ディレクトリ名ではありません!
Net_FTP::putRecursive() 参照)。
bool $overwrite = false -
リモートファイルが存在した場合に、それを上書きするかどうか。
指定しなかった場合、ファイルは上書きされません。
int $mode = null -
定数 FTP_ASCII あるいは
FTP_BINARY のどちらかを指定しなければなりません。
指定されなかった場合、ファイルの拡張子から(extensions.ini によって)
モードを決定します。それにも失敗した場合は標準転送モード
(mode プロパティの値)が用いられます。
put から戻されるエラーにはいくつかの種類があります。エラー番号は (現時点では)不定で、エラーメッセージについての情報は得られません。 発生する可能性のあるエラーは以下のとおりです。
表 47-1PEAR_Error の値
| エラーメッセージ | 説明 | 対処方法 |
|---|---|---|
| Local file '$local_file' does not exist. | 指定したローカルファイルは存在しません。 | ローカルファイルのパスを修正します。 |
| Remote file '$remote_file' exists and may not be overwriten. | 指定した場所にはすでにファイルが存在しますが、上書きできません。 | おそらくファイルを上書きする権限がないのでしょう。 ファイルのパーミッションを確認してください。 |
| File '$local_file' could not be uploaded to '$remote_file'. | ローカルファイルのアップロードに失敗しました。 | いくつかの原因が考えられます:ローカルファイルが存在しない、 アップロード先リモートディレクトリが存在しない、あるいは リモートディレクトリへの書き込み権限がないなど。 |