如何在Moodle项目中利用Composer管理插件和依赖？（LMS集成）

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）。

标签： php js git json composer pdf 镜像源