安装包下载
公开安装包正在整理。当前版本的环境要求和安装方式见下文。
公开安装包尚未提供
当前核心版本 0.3.9
环境要求
安装需要 PHP、数据库驱动、必要扩展和 Apache 或 Nginx。运行环境不需要 Composer、Node.js 或前端构建工具。
- PHP:8.2 ~ 8.4(命令行与 Web 请使用同一个版本)
- 必需扩展:
pdo及对应数据库驱动、mbstring、gd、json - 建议扩展:
fileinfo;缺失时上传校验会使用内置文件头嗅探 - 图片方向:
exif可选,用于自动纠正相机照片方向 - 数据库:MySQL 5.7 / 8.0,或直接使用 SQLite
- Web 服务器:Apache 需开启
mod_rewrite并允许.htaccess;Nginx 需配置try_files把不存在的路径交给入口文件 - 可写目录:
config/、storage/、public/uploads/
安装方式
01浏览器向导
适合没有命令行权限的虚拟主机。上传整个目录、建好空数据库,然后访问 /install.php 按提示填写。
1. 上传整个目录到服务器
2. 把站点根目录指向 public/
3. 创建一个空数据库(用 SQLite 可跳过)
4. 浏览器访问 /install.php,填写数据库与管理员信息
5. 安装器会尝试自删;若页面提示失败,立即手动删除 public/install.php
6. 访问 /admin 登录后台02命令行安装
命令行安装通过参数完成数据库、管理员和站点配置,不需要交互输入。
# SQLite:适合本地开发和小站,数据落在 storage/ 下的单文件里
php bin/install.php --driver=sqlite \
--admin-user=admin --admin-pass='ChangeMe123!' \
--site-name="我的公司"
# MySQL:需要先建好空库和账号
php bin/install.php --driver=mysql \
--host=127.0.0.1 --port=3306 --db=site --user=site --pass=secret \
--admin-user=admin --admin-pass='ChangeMe123!' \
--site-name="我的公司"03校验安装包
下载后先核对 SHA-256,与本页公布的值一致再解压。
sha256sum cms-0.3.9.tar.gz # Linux
shasum -a 256 cms-0.3.9.tar.gz # macOS
certutil -hashfile cms-0.3.9.tar.gz SHA256 # Windows安装后检查
- 删除安装文件:安装成功后必须删除
public/install.php。 - 站点根必须指向
public/:指向项目根会把配置文件、日志和数据库暴露到公网。 - 填写站点网址:进后台「设置」把站点网址填成带协议的完整地址,canonical、sitemap、RSS 和分享图都依赖它。
- 不要复制别的站点的
config/与storage/:每个实例都应由安装器生成自己的配置与密钥。 - 升级使用完整发行包:先运行
php bin/cms.php upgrade /path/to/package.tar.gz --dry-run,不要手工覆盖核心目录。