本文详解 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 的绝对本地路径。常见场景如下：
立即学习“PHP免费学习笔记（深入）”；
- 若来自 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);
}⚠️ 注意事项：
- 不要依赖相对路径（如 'File.xls'），Web 服务器工作目录不可控；
- 在调用前务必用 is_file() 和 is_readable() 校验本地文件有效性；
- 启用错误日志（error_log）而非仅依赖浏览器响应，500 错误常掩盖底层警告；
- 若使用表单上传，确认 enctype="multipart/form-data" 已设置，且未在 php.ini 中禁用 file_uploads。
总结：该 500 错误本质是本地文件路径解析失败引发的 fopen 警告，与 SMB 远程操作无关。解决核心在于确保 put() 的 $source 参数为服务端可访问的绝对路径，并加入前置校验。严谨的路径处理和错误防御，是稳定集成 SMB 文件操作的关键。
