# 服务器要求

在安装 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。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/2.x-zh-cn/guan-li-zhi-nan/admin-guide/installation/server-requirements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.