Moodle自定义主题：实现用户个人资料页更换头像方法咨询

核心思路：优先复用Moodle原生逻辑，避免重复开发 #

Moodle核心已经提供了完整的头像上传、处理机制，无需从零构建，你只需要在重写的个人资料页中整合这些逻辑即可。

步骤1：在自定义个人资料页添加上传表单 #

在你重写的个人资料模板文件（如theme/yourtheme/templates/myprofile.mustache或对应PHP模板）中，添加头像上传表单：

<form action="<?php echo $CFG->wwwroot; ?>/user/edit.php" method="post" enctype="multipart/form-data">
    <!-- 隐藏字段：用户ID、返回页、会话令牌 -->
    <input type="hidden" name="id" value="<?php echo $USER->id; ?>">
    <input type="hidden" name="returnto" value="<?php echo $PAGE->url; ?>">
    <?php echo $OUTPUT->sesskey(); ?>

    <div class="avatar-section">
        <!-- 显示当前头像 -->
        <div class="current-avatar">
            <?php echo $OUTPUT->user_picture($USER, ['size' => 120]); ?>
        </div>
        <!-- 上传控件 -->
        <label for="userpicture">选择新头像</label>
        <input type="file" name="userpicture" id="userpicture" accept="image/jpeg,image/png,image/gif">
        <button type="submit" name="submitbutton" value="uploadpicture">保存更换</button>
    </div>
</form>

• 表单直接提交到Moodle核心的user/edit.php，该脚本会自动处理文件上传、头像裁剪、权限验证等逻辑
• $OUTPUT->sesskey()自动生成会话令牌，防止CSRF攻击
• accept属性限制上传文件类型，过滤无效文件

步骤2：（可选）主题内新增独立处理文件 #

如果需要完全自定义处理逻辑，可在主题目录下新建avatarupload.php，内容如下：

<?php
// 初始化Moodle环境
require_once('../../config.php');
require_login();

// 验证会话和权限
if (!confirm_sesskey() || !has_capability('moodle/user:editownprofile', context_user::instance($USER->id))) {
    redirect($CFG->wwwroot, get_string('nopermissions', 'error'), null, \core\output\notification::NOTIFY_ERROR);
}

// 处理文件上传
if (isset($_FILES['userpicture']) && $_FILES['userpicture']['error'] === UPLOAD_ERR_OK) {
    // 调用Moodle核心函数更新头像
    $result = user_update_picture($USER, $_FILES['userpicture']);
    if ($result) {
        redirect($PAGE->url, get_string('changeprofilesuccess', 'user'), null, \core\output\notification::NOTIFY_SUCCESS);
    } else {
        redirect($PAGE->url, get_string('uploadfailed', 'user'), null, \core\output\notification::NOTIFY_ERROR);
    }
} else {
    redirect($PAGE->url, get_string('invalidfile', 'error'), null, \core\output\notification::NOTIFY_ERROR);
}

此时表单的action需指向该文件：

<form action="<?php echo $CFG->wwwroot; ?>/theme/yourtheme/avatarupload.php" method="post" enctype="multipart/form-data">
    <!-- 其他字段同上 -->
</form>

关键注意事项 #

• 权限控制：必须验证用户是否拥有moodle/user:editownprofile权限，防止普通用户越权操作
• 文件验证：Moodle核心的user_update_picture函数会自动处理文件大小、格式、裁剪等逻辑，无需手动编写验证规则
• 样式适配：根据主题风格自定义上传表单的CSS样式，确保和页面整体风格统一

内容的提问来源于stack exchange，提问作者Mohammad Khawaja