函数名: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() 等)来替代。