WellCMS 3.0 正式发布

经过持续迭代，我们很高兴地宣布 WellCMS 3.0 正式版发布。这是一个里程碑式的版本，从零重写了核心框架，引入了现代化的架构设计，同时保持了轻量级和高性能的传统。

核心亮点

升级说明

暂不支持 WellCMS 2.x 升级至 3.0，旧插件不兼容。

WellCMS V3 部署说明

一、项目信息

仓库默认 README 为英文，可点击 简体中文 查看中文版本。

二、系统要求

必需环境

• PHP ≥ 7.2（建议 8.0 及以上）
• PHP 扩展：PDO、mbstring、gd / imagick、fileinfo、openssl
• 数据库：MySQL / MariaDB / PostgreSQL / SQLite
• Web 服务器：Nginx / Apache（推荐 Nginx）

可选环境

• Swoole 扩展 ≥ 4.5（如需以 Swoole 模式运行）
• Redis（如需使用 Redis 缓存或任务队列）
• Memcached / APCu / YAC（可选缓存驱动）

三、下载源码

方式一：通过浏览器下载

访问 Release 页面 Release WellCMS 3.0.0 - Initial Release · wellcms/wellcmsV3 · GitHubgithub.com  点击页面底部的 Source code (zip) 或 Source code (tar.gz) 下载。

方式二：通过命令行下载

方式三：通过 Git 克隆

git clone https://github.com/wellcms/wellcmsV3.git

cd wellcmsV3

四、目录结构

wellcmsV3/
├── app/              # 应用层（控制器、服务、中间件、模型、视图）
├── bin/              # CLI 入口（Swoole 服务器 / 任务调度器）
├── config/           # 运行时配置文件
├── install/          # 图形化安装向导
├── public/           # Web 入口与静态资源
├── src/              # 框架层（IoC、HTTP、DB、Cache、Session、Scheduler）
├── storage/          # 日志、编译缓存、上传文件
├── themes/           # 主题风格目录
├── plugins/          # 插件目录
├── README.md         # 英文说明
└── README.zh-CN.md   # 中文说明

五、FPM 模式部署

1. 上传代码

将源码上传到服务器 Web 目录，例如 /var/www/wellcmsV3/。

2. 设置目录权限

确保以下目录对 Web 用户可写：

chmod -R 755 storage/
chmod -R 755 config/
chmod -R 755 install/

3. 配置 Web 服务器

将网站文档根目录指向 public/ 目录。

Nginx 配置示例

server {
    listen 80;
    server_name your-domain.com;
    root /var/www/wellcmsV3/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(git|svn|htaccess|env) {
        deny all;
    }
}

更详细的伪静态规则请参考项目根目录下的 nginx.conf.example。

4. 运行安装向导

访问：
RTEPLACEHOLDER5
按页面提示完成 5 步安装：

1. 同意许可协议
2. 环境检测
3. 数据库配置
4. 管理员账号设置
5. 完成安装

5. 安装后安全设置

安装完成后，系统会生成 install/install.lock 文件。建议通过 Nginx 配置禁止直接访问 install/ 目录：

location ^~ /install/ {
    deny all;
}

六、Swoole 模式部署

1. 安装 Swoole 扩展

pecl install swoole

extension=swoole

2. 启动 Swoole 服务器

cd /var/www/wellcmsV3

# 前台启动，默认端口 9501
php bin/well-server start

# 后台守护进程启动
php bin/well-server start -d

3. 管理 Swoole 服务

php bin/well-server stop

# 重启
php bin/well-server restart

# 热重载
php bin/well-server reload

# 查看状态
php bin/well-server status

4. Nginx 反向代理（生产环境推荐）

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:9501;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

更详细的 Swoole 生产部署说明请参考：bin/SWOOLE_DEPLOY_GUIDE.md

七、任务调度器部署

如需使用定时任务功能，需启动调度器：

# 启动常驻任务调度器
php bin/scheduler

# 健康检查
php bin/scheduler-health-check

详细部署与运维指南请参考：bin/SCHEDULER_DEPLOY_GUIDE.md

八、配置文件说明

安装成功会将 src/Config/ 目录下的 .default.php"文件自动复制到 config/目录，无需手动。

然后根据实际环境修改 config/ 中的文件。

九、常见问题

1. 访问首页提示“未安装”

请确认 install/install.lock 文件已生成，且 config/Database.php 配置正确。

2. 静态资源 404

请检查 Nginx 中 plugins/、themes/、storage/ 等目录保持写权限。

3. 缓存不生效

请确认已安装并启用对应的缓存扩展（如 Redis、Memcached），且在 RTEPLACEHOLDER32 中配置正确。

十、相关链接

• 项目仓库：https://github.com/wellcms/wellcmsV3
• 英文 README：https://github.com/wellcms/wellcmsV3/blob/main/README.md
• 中文 README：https://github.com/wellcms/wellcmsV3/blob/main/README.zh-CN.md
• 最新 Release：https://github.com/wellcms/wellcmsV3/releases/latest

文档生成时间：2026-06-18