> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/2.x/zh/kai-fa-zhe-zhi-nan/developer-guide/backend/symfony-architecture.md).

# Symfony 架构

## 束（Bundles）

Chamilo 2.0 分为三个 Symfony 束：

### CoreBundle (`src/CoreBundle/`)

最大的束，处理平台范围内的所有事务：

* **用户和认证** — 用户实体、角色、JWT 令牌、OAuth2 提供商
* **资源系统** — ResourceNode 和 ResourceFile（统一的内容抽象）
* **平台设置** — 位于 `src/CoreBundle/Settings/` 的设置模式，涵盖每个可配置的方面
* **管理** — 用于用户、课程、会话和插件管理的管理员控制器
* **AI 提供商** — 针对 OpenAI、Gemini、Mistral、DeepSeek、Grok 的工厂模式
* **文件存储** — 基于 Flysystem 的存储适配器（本地、S3、Azure、GCS）
* **安全** — 投票者、访问控制、角色层级
* **工具** — 通过工具系统注册的课程工具定义

### CourseBundle (`src/CourseBundle/`)

与课程内容相关的所有内容：

* **内容实体** — 101 个实体，涵盖文档、练习、学习路径、论坛、词汇表、调查、考勤、博客、作业等
* **课程复制** — 支持 Common Cartridge 1.3 和 Moodle 格式的导入/导出
* **课程设置** — 课程级别的设置模式

### LtiBundle (`src/LtiBundle/`)

LTI 1.3 标准实现：

* **平台和工具注册** — 管理外部工具连接
* **启动处理** — LTI 启动流程控制器
* **成绩回传** — 将外部工具的成绩返回到 Chamilo

## 服务容器

Chamilo 使用 Symfony 的依赖注入容器。服务配置在：

* `config/services.yaml` — 全局服务定义
* 每个束的 `DependencyInjection/` 目录 — 特定束的服务

## 安全架构

安全系统配置在 `config/packages/security.yaml` 中：

* **密码哈希** — 支持 bcrypt（默认），并从旧版的 SHA1 和 MD5 迁移
* **角色层级** — 18 个角色按层级组织（ROLE\_GLOBAL\_ADMIN > ROLE\_ADMIN > ROLE\_TEACHER > ROLE\_STUDENT > ROLE\_USER；其他角色包括 ROLE\_HR、ROLE\_INVITEE、ROLE\_STUDENT\_BOSS、ROLE\_SESSION\_MANAGER、ROLE\_QUESTION\_MANAGER）
* **上下文敏感角色** — 课程级别的角色（ROLE\_CURRENT\_COURSE\_TEACHER、ROLE\_CURRENT\_COURSE\_STUDENT）根据注册情况在每次请求时计算
* **防火墙** — API 使用 JWT 认证，Web 界面使用基于会话的认证
* **投票者** — 通过 Symfony 投票者实现资源级别的访问控制

## 遗留代码

某些功能仍然使用位于 `public/main/` 的遗留 PHP 代码：

* 练习渲染和交互
* 学习路径播放器
* 一些管理工具

这些功能正在逐步迁移到 Symfony+Vue 架构。遗留页面通过一个兼容层提供服务，该兼容层启动了 Symfony 内核。