[函数]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() 等）来替代。