Net_FTP::ls()

Net_FTP::ls() -- 指定した方法で、ディレクトリ内の一覧を返す

概要

require_once 'Net/FTP.php';

mixed Net_FTP::ls ([string $dir = null [, string $mode = NET_FTP_DIRS_FILES]])

説明

この関数は、ファイル/ディレクトリ/その両方 の一覧、あるいは 整形されていない配列(PHP の ftp_rawlist() 関数と同じ形式) を返します。

パラメータ

返り値

mixed - 成功時には指定した形式による ディレクトリ内の一覧、それ以外は PEAR::Error

例外・エラー

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

表 54-1PEAR_Error の値

エラーメッセージ説明対処方法
Raw directory-list in wrong format. PHP の ftp_rawlist() 関数から返ってきた値のフォーマットが 間違っています。取得しようとしているディレクトリ名が正しいものか、 そしてそのディレクトリへのアクセス権限があるかどうかを 確認してください。 正確なディレクトリパス(例. /my/file/path/, ../)を指定し、そのディレクトリに対する アクセス権限を確認(必要なら、変更)してください。
Could not get last-modification-date of '$file'. 最終更新日が取得できませんでした。理由として考えられるのは、 FTP サーバがそのコマンドをサポートしていないこと、あるいは 存在しないファイルの情報を取得しようとしたことです。

  • 指定したファイルが存在することを確認する

  • FTP サーバの管理者に連絡する

Date-format failed on timestamp '$res'. 指定されたフォーマット文字列が不正確です。 PHP の date() 関数のドキュメントを確認してください。

注意

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