Moodle 4.0自定义：如何获取课程图片并在项目课程卡片中展示

云原生阿岚

2026-8-7

解决Moodle 4.0中项目课程卡片展示课程图片的问题

Moodle的课程封面图不是直接存在数据库表中，而是存储在moodledata目录的文件存储区，数据库的files表仅保存文件的元数据（比如文件ID、所属上下文、路径哈希等），直接查数据库找不到图片本身，得用Moodle的核心API来获取。

正确获取课程图片的方法

别硬查数据库，用Moodle内置函数，能兼容权限控制和默认图片 fallback 逻辑：

先通过课程ID获取完整课程对象：
```
$course = get_course($courseid);
```
调用course_get_image()直接获取图片的可访问URL，课程无自定义图片时会自动返回默认图：
```
$courseimageurl = course_get_image($course);
```

学员数量可以用count_enrolled_users()函数获取：

$enrolledcount = count_enrolled_users(context_course::instance($courseid));

卡片渲染示例代码

假设你从My programs插件拿到了项目下的课程ID数组，用PHP渲染卡片的代码可以这么写：

// 假设$program_courses是项目关联的课程ID集合
foreach ($program_courses as $courseid) {
    $course = get_course($courseid);
    $course_img = course_get_image($course);
    $student_count = count_enrolled_users(context_course::instance($courseid));
    ?>
    <div class="course-card">
        <img src="<?= $course_img ?>" alt="<?= format_string($course->fullname) ?>">
        <h4><?= format_string($course->fullname) ?></h4>
        <span>学员数：<?= $student_count ?></span>
    </div>
    <?php
}