> 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/guan-li-zhi-nan/admin-guide/installation/server-requirements.md).

# 服务器要求

在安装 Chamilo 2.0 之前，请确保您的服务器满足以下要求。

## 软件要求

### PHP

| 要求         | 最低版本 | 推荐版本      |
| ---------- | ---- | --------- |
| **PHP 版本** | 8.2  | 8.3 或更高版本 |

### 必需的 PHP 扩展

| 扩展                              | 用途                                    |
| ------------------------------- | ------------------------------------- |
| **curl**                        | HTTP 请求（API 集成、外部服务）                  |
| **fileinfo**                    | 上传文件的 MIME 类型检测                       |
| **gd**                          | 图像处理（缩略图、验证码）                         |
| **intl**                        | 国际化（日期、数字和字符串格式化）                     |
| **json**                        | JSON 编码/解码                            |
| **ldap**                        | LDAP 连接器。尽管您可能不会使用 LDAP，但 Chamilo 需要它 |
| **mbstring**                    | 多字节字符串处理（支持 UTF-8）                    |
| **openssl**                     | 加密操作（HTTPS、密码哈希、令牌）                   |
| **pdo\_mysql** 或 **pdo\_pgsql** | 数据库连接（安装与您的数据库匹配的扩展）                  |
| **xml**                         | XML 解析（SCORM、RSS、SOAP）                |
| **zip**                         | 处理 ZIP 存档（SCORM 包、批量导入/导出）            |
| **apcu**                        | 用户级缓存（推荐）                             |
| **opcache**                     | 操作码缓存（强烈推荐以提升性能）                      |
| **xapian**                      | 全文搜索（可选，仅在您使用搜索功能时需要）                 |

### 数据库

| 数据库         | 最低版本 |
| ----------- | ---- |
| **MySQL**   | 8.0  |
| **MariaDB** | 10.4 |

### Web 服务器

| 服务器        | 备注                                        |
| ---------- | ----------------------------------------- |
| **Apache** | 需要启用 `mod_rewrite`。                       |
| **Nginx**  | 需要手动配置 URL 重写。请参考 Symfony Nginx 文档获取参考配置。 |

### 构建工具

| 工具                | 用途                              |
| ----------------- | ------------------------------- |
| **Composer**      | PHP 依赖管理。安装 Chamilo 的 PHP 库时必需。 |
| **Node.js** (18+) | JavaScript 运行时。构建前端资源时必需。       |
| **npm**           | JavaScript 包管理器。与 Node.js 一起安装。 |

## 硬件要求

| 资源           | 最低要求        | 推荐要求               |
| ------------ | ----------- | ------------------ |
| **内存 (RAM)** | 2 GB        | 4 GB 或更多           |
| **CPU**      | 1 核         | 2 核或更多             |
| **磁盘空间**     | 2 GB（仅应用程序） | 20 GB 或更多（包括上传的内容） |
| **磁盘类型**     | HDD         | SSD（显著提升数据库和缓存性能）  |

以上为基准数据。实际要求取决于并发用户数量和托管内容的体积。

## 操作系统

| 操作系统        | 备注                                              |
| ----------- | ----------------------------------------------- |
| **Linux**   | 推荐。Ubuntu 22.04+、Debian 12+、AlmaLinux 9+ 或同等版本。 |
| **Windows** | 可能支持但未经充分测试。开发时建议使用 WSL2。                       |
| **macOS**   | 仅限开发/未经测试。                                      |

## 网络要求

* 指向您服务器的域名。
* 用于 HTTPS 的 SSL/TLS 证书（Let's Encrypt 提供免费证书）。
* 如果直接发送电子邮件，需要出站 SMTP 访问权限（或使用第三方电子邮件服务）。
* 端口 443 (HTTPS)，可选端口 80 (HTTP，用于重定向到 HTTPS)。

## 检查要求

将 Chamilo 源代码放置在服务器上后，您可以直接检查 PHP 配置：

```bash
php -m          # 列出已安装的扩展
php -i          # 完整的 PHP 信息
```

## 小贴士

* **使用 PHP-FPM** 与 Apache 或 Nginx 配合使用，性能比 mod\_php 更好。
* 对于预计超过 500 名并发用户的平台，**将数据库分离**到专用服务器上。
* **使用 SSD 存储** —— 像 Chamilo 这样数据库密集型的应用程序会显著受益于快速磁盘 I/O。