本文详细讲解如何在 Moodle 区块（如页脚）中安全、准确地获取并显示当前用户的角色名称，涵盖数据库查询误区、Moodle 原生 API 推荐用法、代码修正及关键注意事项。
本文详细讲解如何在 moodle 自定义区块中安全、准确地获取并显示当前用户的角色名称，涵盖数据库查询误区、moodle 原生 api 推荐用法、代码修正及关键注意事项。
在 Moodle 开发中，新手常误以为直接调用 $DB->get_records() 返回的数据可直接赋值给 $this->content->footer —— 但需牢记：$this->content->footer 仅接受字符串或 HTML 片段，而非数组或对象。您原始代码中存在两个关键问题：
-
变量名错误：使用了未定义的
$user->id，应为全局$USER->id； -
数据类型不匹配：
role_assignments表仅存储roleid（整数），无法直接展示角色名称（如 “Manager” 或 “Student”），且返回的是对象数组，不可直接赋值。
✅ 正确做法是使用 Moodle 内置的 get_user_roles() 函数，它自动关联上下文（context）、用户和角色表，返回含完整角色信息（包括 name、shortname、archetype 等）的数组。以下为修复后的完整 get_content() 方法：
function get_content() {
global $USER, $DB;
if ($this->content !== null) {
return $this->content;
}
$this->content = new stdClass();
$this->content->text = ''; // 可选：主内容区域留空或填充其他内容
$this->content->footer = ''; // 初始化为空字符串
// ✅ 获取当前用户在系统级上下文中的所有角色（含名称）
$roles = get_user_roles(context_system::instance(), $USER->id);
if (!empty($roles)) {
$roleNames = [];
foreach ($roles as $role) {
$roleNames[] = s($role->name); // 使用 s() 进行安全输出转义，防 XSS
}
$this->content->footer = implode(', ', $roleNames);
} else {
$this->content->footer = get_string('norolesassigned', 'moodle'); // 显示本地化提示
}
return $this->content;
}
? 关键说明与最佳实践：
-
上下文选择：
context_system::instance()表示站点全局上下文，适用于显示用户在整个 Moodle 站点的角色。若需课程级角色，请改用context_course::instance($courseid)并传入对应课程 ID； -
安全性：始终使用
s()（或format_string()）对角色名进行 HTML 转义，避免潜在 XSS 风险； -
性能考虑：
get_user_roles()已内置缓存与权限检查，比手动 JOIN 查询更高效、更符合 Moodle 架构； -
空值处理：添加
if (!empty($roles))判断，确保无角色时显示友好提示（支持多语言）； -
不要硬编码表名：避免直接操作
role_assignments表——Moodle 的角色系统涉及role,role_assignments,context等多表关联，原生 API 才能保证逻辑一致性与未来兼容性。
最后，建议在开发完成后启用 Moodle 的调试模式（$CFG->debug = DEBUG_DEVELOPER;），检查是否有 PHP Notice 或 Undefined Index 提示，并通过实际用户切换验证不同角色组合下的显示效果。
