服务器要求

在安装 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 配置：

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

小贴士

• 使用 PHP-FPM 与 Apache 或 Nginx 配合使用，性能比 mod_php 更好。

• 对于预计超过 500 名并发用户的平台，将数据库分离到专用服务器上。

• 使用 SSD 存储 —— 像 Chamilo 这样数据库密集型的应用程序会显著受益于快速磁盘 I/O。