如何用PHP读取Windows共享驱动器（映射Z盘）的文件与目录

我来帮你搞定这个问题——之前我也踩过类似的路径和权限坑，给你几个靠谱的实操方案：

核心思路：路径写法与权限是关键 #

你有两种路径可选：要么用已映射的Z盘，要么直接用UNC共享路径（无需依赖磁盘映射），但要注意PHP里的路径转义规则。另外，PHP运行进程的权限是最容易被忽略的关键点，必须确保它能访问这个共享目录。

方案1：使用映射的Z盘读取 #

直接用Z盘路径，但要注意路径分隔符的写法（推荐用正斜杠，避免反斜杠转义错误）：

$mappedPath = 'Z:/Directory'; // 也可以写成 'Z:\\Directory'（双反斜杠转义）

// 先验证路径是否可访问
if (is_dir($mappedPath)) {
    // 获取目录下所有文件和子目录
    $items = scandir($mappedPath);
    
    // 过滤掉默认的.和..目录
    $filteredItems = array_filter($items, function($item) {
        return $item !== '.' && $item !== '..';
    });
    
    // 遍历输出，区分文件和目录
    foreach ($filteredItems as $item) {
        $fullPath = $mappedPath . '/' . $item;
        echo (is_dir($fullPath) ? '[目录]' : '[文件]') . ' ' . $item . '<br>';
    }
} else {
    echo '错误：路径不存在或PHP进程无访问权限';
}

方案2：直接使用UNC共享路径（无需映射磁盘） #

如果映射磁盘不稳定或者权限受限，直接用UNC路径更可靠，PHP原生支持这种写法：

// UNC路径两种写法：正斜杠更省心，双反斜杠需要转义
$uncPath = '//172.16.XX.XX/fileserver/Directory';
// 或者 $uncPath = '\\\\172.16.XX.XX\\fileserver\\Directory';

if (is_dir($uncPath)) {
    // 递归读取所有层级的文件和目录（用迭代器更高效）
    $directoryIterator = new RecursiveDirectoryIterator(
        $uncPath,
        RecursiveDirectoryIterator::SKIP_DOTS // 自动跳过.和..
    );
    $recursiveIterator = new RecursiveIteratorIterator(
        $directoryIterator,
        RecursiveIteratorIterator::SELF_FIRST // 先遍历目录，再遍历文件
    );
    
    foreach ($recursiveIterator as $item) {
        $type = $item->isDir() ? '目录' : '文件';
        $size = $item->isFile() ? '（大小：' . $item->getSize() . '字节）' : '';
        echo "[{$type}] {$item->getFilename()} {$size}<br>";
    }
} else {
    // 开启错误提示排查问题
    error_reporting(E_ALL);
    ini_set('display_errors', 1);
    var_dump(error_get_last()); // 查看具体错误信息，比如权限不足、路径不存在等
}

必看注意事项 #

• 权限配置：这是90%的问题根源！PHP运行的用户（比如IIS的IUSR、Apache的服务用户，或者PHP-FPM的运行用户）必须拥有该Windows共享目录的读取权限。如果是域环境，要确保这个用户在域中被授权访问共享资源。
• 路径分隔符：Windows下PHP支持正斜杠/，比反斜杠\更省心（不用额外转义）。
• 网络连通性：确保运行PHP的服务器能ping通共享主机，并且SMB服务端口（445）未被防火墙拦截。
• 错误排查：如果代码报错，先开启PHP错误提示，用error_get_last()定位具体问题，不要盲目试错。

内容的提问来源于stack exchange，提问作者Tausif Anwar