Net_FTP::ls()

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

Synopsis

require_once 'Net/FTP.php';

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

Possible PEAR_Error values
エラーメッセージ 説明 対処方法
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() 関数のドキュメントを確認してください。

Note

This function can not be called statically.

Example

ls() の使用法

<?php

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

?>
ファイルのサイズをバイト数で返す (Previous) ファイルあるいはディレクトリを削除する (Next)
Last updated: Thu, 30 Oct 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.