查询

ftp_rawlist()函数—用法及示例

「 获取指定目录下的文件列表,并以数组形式返回 」


函数名:ftp_rawlist()

适用版本:PHP 4, PHP 5, PHP 7

用法:ftp_rawlist(resource $ftp_stream, string $directory [, bool $recursive = false]) : array|false

该函数用于获取指定目录下的文件列表,并以数组形式返回。每个文件的信息以字符串的形式表示,保留了原始的FTP服务器响应。

参数:

  • $ftp_stream:FTP 连接资源,通过 ftp_connect() 或 ftp_ssl_connect() 函数获取。
  • $directory:要获取文件列表的目录路径。
  • $recursive(可选):是否递归地获取子目录下的文件列表,默认为 false。

返回值:

  • 成功时,返回包含文件列表的数组。
  • 失败时,返回 false。

示例:

// 建立 FTP 连接
$ftp_server = 'ftp.example.com';
$ftp_user = 'username';
$ftp_pass = 'password';
$ftp_conn = ftp_connect($ftp_server);
ftp_login($ftp_conn, $ftp_user, $ftp_pass);

// 获取文件列表
$directory = '/public_html';
$file_list = ftp_rawlist($ftp_conn, $directory);

// 打印文件列表
if ($file_list !== false) {
    foreach ($file_list as $file) {
        echo $file . "\n";
    }
} else {
    echo "无法获取文件列表。\n";
}

// 关闭 FTP 连接
ftp_close($ftp_conn);

注意事项:

  • 在调用 ftp_rawlist() 函数之前,需要先建立 FTP 连接并登录到 FTP 服务器。
  • 返回的文件列表数组中的每个元素都是一个字符串,表示一个文件的信息。可以使用字符串处理函数(如 explode())对每个文件信息进行解析。
  • 如果需要获取详细的文件信息(如文件名、大小、修改日期等),可以考虑使用其他 FTP 函数(如 ftp_nlist()、ftp_mlsd() 等)来替代。
补充纠错
上一个函数: ftp_rename()函数
下一个函数: ftp_raw()函数
热门PHP函数