PHP SMB 文件上传成功但返回 500 错误的排查与修复-php教程-PHP中文网

PHP SMB 文件上传成功但返回 500 错误的排查与修复

本文详解 php 使用 icewind/smb 库通过 smb 协议上传文件时，虽实际上传成功却触发 fopen(): failed to open stream: no such file or directory 导致 500 内部服务器错误的根本原因及可靠解决方案。

本文详解 php 使用 icewind/smb 库通过 smb 协议上传文件时，虽实际上传成功却触发 fopen(): failed to open stream: no such file or directory 导致 500 内部服务器错误的根本原因及可靠解决方案。

该问题表面矛盾：文件已成功写入远程 SMB 共享目录，但 PHP 进程仍抛出致命警告并返回 HTTP 500 错误。关键线索在于错误信息中的 fopen(File.xls): failed to open stream: No such file or directory —— 它并非发生在远程操作阶段，而是本地文件读取环节失败。

回顾 NativeShare::put() 源码：

public function put($source, $target) {
    $sourceHandle = fopen($source, 'rb'); // ← 问题发生在此行！
    // ...
}

fopen($source, 'rb') 尝试以二进制只读模式打开 $source 所指的本地文件路径。若传入的 $fileToUpload = 'File.xls'（仅文件名，无路径），PHP 会在当前工作目录（通常是 Web 服务器进程的工作目录，如 /var/www/html/）下查找该文件，而非你预期的客户端上传临时目录或脚本所在目录。一旦找不到，即触发警告 → 未捕获的警告升级为 500 错误（尤其当 display_errors=Off 且 log_errors=On 时，用户仅见 500，日志中才见真实警告）。

✅ 正确做法是：始终传入 $fileToUpload 的绝对本地路径。常见场景如下：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

若来自 HTML 表单上传，应使用 $_FILES['file']['tmp_name']（这是 PHP 生成的临时文件绝对路径）；
若来自本地脚本调用，需显式拼接完整路径，例如：__DIR__ . '/uploads/File.xls' 或 realpath('File.xls')。

修正后的 upload() 方法示例：

public function upload($fileToUpload, $targetPath = "") {
    // ✅ 强制验证并规范化本地源路径
    if (!is_file($fileToUpload) || !is_readable($fileToUpload)) {
        throw new InvalidArgumentException("Local file not found or unreadable: {$fileToUpload}");
    }

    if (!empty($targetPath) && substr($targetPath, -1) !== '/') {
        $targetPath .= "/";
    }

    $fileName = basename($fileToUpload);
    $remoteTarget = $targetPath . $fileName;

    // ✅ 传入绝对路径，确保 fopen 能定位
    $this->srvShare->put($fileToUpload, $remoteTarget);
}

⚠️ 注意事项：