Moodle 3.7+ 支持 Composer 管理插件，需用 Composer 2.2+、启用 plugininstallbypackagist，并通过 Packagist 镜像或私有源注册插件；Git 插件需配置 repositories 和 installer-paths；安装后仍需访问 /admin/index.php 完成数据库迁移与手动启用。
在 Moodle 项目中用 Composer 管理插件和依赖，核心是把第三方插件（尤其是非官方、自研或社区维护的）当作 Composer 包来安装和更新，同时确保与 Moodle 核心的版本兼容性。官方插件市场（moodle.org/plugins）多数不原生支持 Composer，所以需要借助特定方式接入。
确认 Moodle 版本与 Composer 兼容性
Moodle 3.7+ 原生支持通过 composer.json 声明插件依赖，但要求使用 Composer 2.x（推荐 2.2+），且需启用 plugininstallbypackagist 配置（默认关闭）。务必检查 config.php 中未禁用插件自动安装机制。
- 运行
php admin/cli/check_config.php验证基础配置 - 确认
$CFG->disableupdatenotifications = false;（否则部分 Composer 插件更新可能被跳过） - 避免在生产环境直接启用
allow_unstable，除非明确需要测试版插件
将插件注册为 Composer 包（Packagist 或私有源）
官方插件库不托管 Composer 元数据，所以常用做法是：使用第三方 Packagist 镜像（如 packagist.moodle.org），或自己维护私有 Composer 仓库（如 Satis 或 Private Packagist）。
- 添加镜像源：
composer config -g repos.packagist-moodle composer https://www.php.cn/link/9db8f0f4772ca5e1a6187c37826a60ac - 在项目根目录
composer.json的require中写入插件包名，例如："moodle/assignfeedback_editpdf": "^2023.05"（注意命名格式为moodle/{插件类型}{插件名}） - 插件 ZIP 包需含合法
version.php和db/install.xml，否则 Composer 安装后 Moodle 可能无法识别
手动集成非 Packagist 插件（Git 方式）
对未上架到任何 Composer 源的插件（如内部开发模块），可在 composer.json 中用 repositories 声明 Git 路径，并指定安装路径（installer-paths）。
- 示例配置片段：
"repositories": [
{
"type": "package",
"package": {
"name": "acme/moodle-mod-xyz",
"version": "v1.2.0",
"type": "moodle-module",
"dist": {
"url": "https://git.example.com/acme/moodle-mod-xyz/archive/v1.2.0.zip",
"type": "zip"
}
}
}
],
"extra": {
"installer-paths": {
"mod/xyz/": ["acme/moodle-mod-xyz"]
}
}
- 关键点：
"type": "moodle-module"（或moodle-block、moodle-filter等）触发 Moodle 专用安装器 - 必须配合 moodle-composer-installer（在
require-dev中声明）
执行安装与日常维护
运行命令前，先备份数据库和 plugins/ 目录；Composer 安装不会自动执行插件升级脚本，仍需访问 /admin/index.php 完成数据库迁移。
- 首次安装插件：
composer install --no-dev（跳过开发依赖） - 更新全部插件：
composer update --with-all-dependencies（慎用，建议按包更新） - 仅更新某插件：
composer update moodle/filter_multilang - 查看已装插件列表：
composer show | grep moodle
基本上就这些。不复杂但容易忽略的是：Composer 只管文件部署，Moodle 的启用、设置、权限配置仍需在后台完成。把 Composer 当作“搬运工”，不是“管理员”。
