Net_FTP::size() (Previous) (Next) Net_FTP::rm()
View this page in Last updated: Sun, 07 Sep 2008
English | French | German | Hungarian | Japanese | Polish | Spanish | Plain HTML

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() 関数と同じ形式） を返します。

パラメータ

  • string [$dir = null] - 一覧を取得したいディレクトリ。相対パスまたは絶対パスのいずれかで 指定できます。このパラメータは省略可能で、省略した場合は カレントパスに設定されます。

  • [int $mode = NET_FTP_DIRS_FILES] - 出力形式（ディレクトリのみ、ファイルのみ、その両方、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() 関数のドキュメントを確認してください。

注意

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

例

例 54-1ls() の使用法


<?php

  var_dump($test->ls('/foo/bar'));

?>
Net_FTP::size() (Previous) (Next) Net_FTP::rm()
Download Documentation Last updated: Sun, 07 Sep 2008
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
There are no user contributed notes for this page.