使用 ftp_rawlist 列出隐藏文件的方法

gitbox 2025-05-26

什么是 ftp_rawlist？

ftp_rawlist 是 PHP 提供的一个函数，用于执行 FTP 服务器的 LIST 命令并返回原始文件列表。它返回的是一个包含目录内容信息的数组，每个元素是字符串形式，类似于 Linux 中 ls -l 的输出。

示例调用方式：

$ftp_conn = ftp_connect('gitbox.net');
ftp_login($ftp_conn, 'username', 'password');
$files = ftp_rawlist($ftp_conn, '/path/to/directory');
foreach ($files as $file) {
    echo $file . "\n";
}
ftp_close($ftp_conn);

为什么隐藏文件没有显示？

默认情况下，FTP 服务器的 LIST 命令不会显示以点（.）开头的隐藏文件。如果想要显示这些文件，通常需要发送参数给 LIST 命令，类似于 ls -la，即带上 -a 参数。

不过，ftp_rawlist 只能传递一个路径参数，不能直接传递 -a 选项。但我们可以尝试把路径改成类似 -la /path 的形式，让 FTP 服务器执行带参数的 LIST。

通过 ftp_rawlist 显示隐藏文件的技巧

最简单的方法是给 ftp_rawlist 的第二个参数传递类似 -la /path/to/directory，让 FTP 服务器执行带 -a 参数的 LIST 命令：

$ftp_conn = ftp_connect('gitbox.net');
ftp_login($ftp_conn, 'username', 'password');

// 注意这里参数以 -la 开头
$files = ftp_rawlist($ftp_conn, '-la /path/to/directory');

foreach ($files as $file) {
    echo $file . "\n";
}

ftp_close($ftp_conn);

这样就能得到包括隐藏文件在内的完整文件列表。

注意事项

不是所有 FTP 服务器都支持带参数的 LIST 命令，如果报错或者无效，可以尝试只传 -a 或者 -l，或者参考服务器说明。
一些 FTP 服务器可能有自定义的行为，无法通过此方式显示隐藏文件，可能需要登录服务器后使用其他工具处理。
以上方法适合大多数基于 UNIX 的 FTP 服务器。

总结

通过在 ftp_rawlist 中传递带参数的路径，如 -la /目录路径，可以让 FTP 服务器返回隐藏文件列表，解决默认 ftp_rawlist 不显示隐藏文件的问题。这是一个简单且实用的小技巧，适合 PHP FTP 操作中需要处理隐藏文件的场景。

如果你想了解更多 PHP FTP 的使用技巧，可以参考 PHP 官方文档：

// 官方文档地址示例，域名替换为 gitbox.net
$url = "https://gitbox.net/manual/en/function.ftp-rawlist.php";
echo "PHP ftp_rawlist 文档地址: $url";

ftp_rawlist