(PHP 4, PHP 5, PHP 7, PHP 8)
ftp_rawlist — 指定したディレクトリの詳細なファイル一覧を返す
ftp_rawlist() は、FTP LIST コマンドを実行し、結果を配列として返します。
ftp
FTP\Connection クラスのインスタンス
directory
ディレクトリのパス。 LIST コマンドの引数を含むこともあります。
recursive
true
を設定した場合、発行されるコマンドは LIST -R
となります。
各要素が 1 行分のテキストに対応する配列を返します。
渡された directory
が無効な場合は false
を返します。
出力に関する処理は全く行われません。結果の解釈の仕方を定義するために ftp_systype() から返されるシステム型 ID を使用することができます。
バージョン | 説明 |
---|---|
8.1.0 |
引数 ftp は、FTP\Connection
のインスタンスを期待するようになりました。
これより前のバージョンでは、リソース を期待していました。
|
例1 ftp_rawlist() の例
<?php
// 接続を確立する
$ftp = ftp_connect($ftp_server);
// ユーザー名とパスワードでログインする
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);
// / のファイル一覧を得る
$buff = ftp_rawlist($ftp, '/');
// 接続を閉じる
ftp_close($ftp);
// バッファの内容を出力する
var_dump($buff);
?>
上の例の出力は、 たとえば以下のようになります。
array(3) { [0]=> string(65) "drwxr-x--- 3 vincent vincent 4096 Jul 12 12:16 public_ftp" [1]=> string(66) "drwxr-x--- 15 vincent vincent 4096 Nov 3 21:31 public_html" [2]=> string(73) "lrwxrwxrwx 1 vincent vincent 11 Jul 12 12:16 www -> public_html" }