> 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-tw/kai-fa-zhe-zhi-nan/developer-guide/backend/symfony-architecture.md).

# Symfony 架構

## Bundles

Chamilo 2.0 結構化為三個 Symfony bundles：

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

最大的 bundle，處理所有平台範圍的關注點：

* **用戶與認證** — User entity、角色、JWT tokens、OAuth2 providers
* **資源系統** — ResourceNode 和 ResourceFile（統一的內容抽象）
* **平台設定** — `src/CoreBundle/Settings/` 中的設定架構，涵蓋每個可配置面向
* **管理** — 用戶、課程、工作坊和插件管理的管理控制器
* **AI 提供者** — OpenAI、Gemini、Mistral、DeepSeek、Grok 的工廠模式
* **檔案儲存** — 基於 Flysystem 的儲存適配器（local、S3、Azure、GCS）
* **安全性** — Voters、存取控制、角色階層
* **工具** — 透過工具系統註冊的課程工具定義

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

所有特定於課程內容的功能：

* **內容實體** — 101 個實體，用於文件、測驗、學習路徑、論壇、詞彙表、調查、出席、部落格、作業等
* **課程複製** — 支援 Common Cartridge 1.3 和 Moodle 格式的匯入/匯出
* **課程設定** — 課程層級的設定架構

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

LTI 1.3 標準實作：

* **平台與工具註冊** — 管理外部工具連線
* **啟動處理** — LTI 啟動流程控制器
* **成績回傳** — 從外部工具將成績回傳至 Chamilo

## Service Container

Chamilo 使用 Symfony 的依賴注入容器。服務配置於：

* `config/services.yaml` — 全球服務定義
* 每個 bundle 的 `DependencyInjection/` 目錄 — Bundle 特定服務

## Security Architecture

安全性系統配置於 `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 認證，網頁介面使用基於工作階段的認證
* **Voters** — 透過 Symfony voters 實現資源層級存取控制

## Legacy Code

某些功能仍使用 `public/main/` 中的舊版 PHP 程式碼：

* 測驗渲染與互動
* 學習路徑播放器
* 某些管理工具

這些功能正逐步遷移至 Symfony+Vue 架構。舊版頁面透過啟動 Symfony kernel 的相容層提供服務。