Net_FTP::ls()
Synopsis
mixed Net_FTP::ls (
string $dir = null
,
string $mode =
= NET_FTP_DIRS_FILES
)
Description
この関数は、ファイル/ディレクトリ/その両方 の一覧、あるいは 整形されていない配列（PHP の ftp_rawlist() 関数と同じ形式） を返します。
Parameter
-
string $dir = null - 一覧を取得したいディレクトリ。相対パスまたは絶対パスのいずれかで 指定できます。このパラメータは省略可能で、省略した場合は カレントパスに設定されます。
-
int $mode = - 出力形式（ディレクトリのみ、ファイルのみ、その両方、ftp_rawlist() 形式） をあらわす定数。 このパラメータは定数で定義されます（参照： 定数）。 このパラメータは省略可能で、省略した場合はディレクトリとファイルの 両方を構造化された配列形式で出力します。
Return value
mixed - 成功時には指定した形式による ディレクトリ内の一覧、それ以外は PEAR::Error
Throws
ls から戻されるエラーにはいくつかの種類があります。 エラー番号は （現時点では）不定で、エラーメッセージについての情報は得られません。 発生する可能性のあるエラーは以下のとおりです。
| エラーメッセージ | 説明 | 対処方法 |
|---|---|---|
| Raw directory-list in wrong format. | PHP の ftp_rawlist() 関数から返ってきた値のフォーマットが 間違っています。取得しようとしているディレクトリ名が正しいものか、 そしてそのディレクトリへのアクセス権限があるかどうかを 確認してください。 | 正確なディレクトリパス（例. /my/file/path/, ../）を指定し、そのディレクトリに対する アクセス権限を確認（必要なら、変更）してください。 |
| Could not get last-modification-date of '$file'. | 最終更新日が取得できませんでした。理由として考えられるのは、 FTP サーバがそのコマンドをサポートしていないこと、あるいは 存在しないファイルの情報を取得しようとしたことです。 |
|
| Date-format failed on timestamp '$res'. | 指定されたフォーマット文字列が不正確です。 | PHP の date() 関数のドキュメントを確認してください。 |
Note
This function can not be called statically.
Example
ls() の使用法
<?php
var_dump($test->ls('/foo/bar'));
?>
忘却曲線を使ってこの知識を確実に記憶に残す
