使用phpSPO上传文件至SharePoint始终失败，请求排查解决

你的代码存在几个关键错误，加上缺少异常捕获导致无法定位具体问题，以下是修正和排查步骤：

代码中的核心问题 #

1. ClientContext初始化错误：ClientContext应当传入SharePoint站点的根URL（而非直接指向文件夹），文件夹需通过站点对象单独获取。
2. 目标路径重复冗余：$relativeUrl已经包含完整的文件夹路径，你又重复拼接了一遍，导致目标路径无效。
3. 目标文件名设置错误：$targetFile应该是目标文件夹下的文件名（如Example.txt），而非本地文件的路径。

修正后的代码 #

<?php
require_once '../vendor/autoload.php';

use Office365\Runtime\Auth\UserCredentials;
use Office365\Runtime\Exceptions\RequestException;
use Office365\SharePoint\ClientContext;
use Office365\SharePoint\File;

try {
    // 站点根URL（替换为你的实际站点地址）
    $siteUrl = "https://mytennant.sharepoint.com/sites/LMS";
    // 文件夹的服务器相对路径（从站点根开始）
    $folderRelativeUrl = "/sites/LMS/Sharepoint/10./Test_folder";
    $username = "myemail@mytennant.onmicrosoft.com"; // 确保是完整租户邮箱
    $password = "mypassword";

    $credentials = new UserCredentials($username, $password);
    $client = (new ClientContext($siteUrl))->withCredentials($credentials);

    $filePath = "../files/Example.txt";
    $fileName = basename($filePath); // 获取本地文件名
    $fileContent = file_get_contents($filePath);

    // 上传文件到指定文件夹
    File::saveBinary($client, $folderRelativeUrl . "/" . $fileName, $fileContent);
    
    echo "文件上传成功";
} catch (RequestException $e) {
    // 打印详细错误信息，方便排查
    echo "错误信息: " . $e->getMessage() . "\n";
    if ($e->getResponse()) {
        echo "HTTP状态码: " . $e->getResponse()->getStatus() . "\n";
        echo "响应内容: " . $e->getResponse()->getBody() . "\n";
    }
} catch (\Exception $e) {
    echo "其他错误: " . $e->getMessage();
}
?>

关键排查步骤 #

• 确认认证有效性：
  • 确保用户名是完整的租户邮箱（如xxx@yourtenant.onmicrosoft.com）。
  • 如果账号启用了多因素认证(MFA)，UserCredentials方式无法使用，需改用应用权限认证或设备码认证。
• 验证文件夹路径：
  • 在SharePoint中打开目标文件夹，点击右上角「查看属性」，复制正确的「服务器相对路径」，确保和代码中的$folderRelativeUrl完全一致。
• 检查权限：
  • 确认你的账号对目标文件夹有「编辑」或「完全控制」权限，可手动上传文件测试权限是否正常。
• 查看详细错误：
  • 修正后的代码加入了异常捕获，运行后会输出具体的HTTP错误信息（如401=认证失败、403=权限不足、404=路径不存在），根据错误码针对性解决。

内容的提问来源于stack exchange，提问作者Quarter Pie