Moodle API集成异常：Laravel调用手动选课接口无效果求助

核心问题：API函数调用错误 #

你要实现用户选课功能，但当前调用的是enrol_manual_unenrol_users——这是取消用户选课的接口，完全和需求反向。正确的选课接口应该是enrol_manual_enrol_users，这是导致操作无效果的首要原因。

其他潜在问题及修正方案 #

1. 冗余认证参数
   你已经通过wstoken传递了webservice认证信息，无需再添加auth参数（基本认证）。同时传递两种认证方式可能导致Moodle解析异常，直接移除'auth' => [$username, $password]即可。

2. 参数有效性验证

   • 确认roleid=5是Moodle中对应“学生”的角色ID（不同环境角色ID可能不同，可在Moodle后台「站点管理→用户→权限→定义角色」中查看）。
   • 确保courseId和userId是Moodle中真实存在的有效ID，且课程已启用手动选课插件（该API依赖此插件，可在课程设置的「选课方法」中确认）。

3. 响应处理逻辑优化
   当前代码仅判断HTTP状态码200就返回成功，但Moodle的部分API（比如取消选课）成功时确实会返回null，而选课接口成功会返回空数组[]。应该解析响应内容，结合业务逻辑判断结果：

修正后的代码示例 #

$client = new Client();
$moodleUrl = config('services.moodle.moodle_url');
$courseId = 1;
$userId = 1;

$response = $client->post("$moodleUrl/webservice/rest/server.php", [
    'form_params' => [
        'wstoken' => config('services.moodle.moodle_token_id'),
        'wsfunction' => 'enrol_manual_enrol_users', // 改为选课接口
        'moodlewsrestformat' => 'json',
        'enrolments[0][roleid]' => 5,
        'enrolments[0][userid]' => $userId,
        'enrolments[0][courseid]' => $courseId
    ]
]);

$responseData = json_decode($response->getBody(), true);
// 选课接口成功返回空数组，失败会返回包含error的数组
if ($response->getStatusCode() === 200 && !isset($responseData['error'])) {
    return true;
} else {
    // 可打印错误信息排查：var_dump($responseData);
    return false;
}

额外排查步骤 #

• 查看Moodle后台的「站点管理→服务器→webservice→webservice日志」，检查请求是否被正确接收，是否有具体的错误提示（比如参数无效、权限不足）。
• 用Postman测试修正后的接口：调用enrol_manual_enrol_users，传递相同参数，确认是否能成功选课。

内容的提问来源于stack exchange，提问作者Roberto Ceballos Ramirez