PHP中使用phpseclib3\Net\SFTP能否服务器端过滤SFTP目录列表？

AI 小北

2026-7-7

关于SFTP通配符过滤的问题解答

一、psftp/Windows自带SFTP的`ls`通配符是本地处理

你用的psftp和Windows命令行SFTP的ls prefix_*.txt，本质都是本地过滤——这些客户端会先从服务器拉取完整的目录列表，然后在本地用通配符规则匹配筛选结果，并非服务器端直接返回过滤后的列表。因为SFTP协议本身没有内置的服务器端通配符过滤目录的功能。

二、PHP中实现SFTP文件过滤的方式

1. 无法实现标准SFTP协议下的服务器端过滤

phpseclib3的nlist和rawlist不支持通配符，且你尝试的exec('ls')失败（服务器仅允许SFTP连接），这是因为SFTP协议和SSH命令行是两个独立的服务通道，大部分严格配置的SFTP服务器会禁用SSH命令执行权限。而SFTP协议本身没有提供服务器端通配符过滤的标准接口，所以无法通过标准方式实现服务器端过滤。

2. 常规解决方案：本地过滤

必须先获取完整的目录列表，再在PHP本地进行通配符筛选。用fnmatch()函数可以方便实现类似shell通配符的匹配，示例代码：

use phpseclib3\Net\SFTP;

// 初始化SFTP连接
$sftp = new SFTP('你的SFTP服务器地址');
if (!$sftp->login('用户名', '密码')) {
    exit('登录失败');
}

// 获取目标目录的完整文件列表
$targetDir = '/目标目录路径';
$allFiles = $sftp->nlist($targetDir);

// 本地过滤符合prefix_*.txt规则的文件
$filtered = array_filter($allFiles, function($filename) {
    return fnmatch('prefix_*.txt', $filename);
});

// 输出结果
print_r($filtered);