快速开始

最后更新 2026-07-29 ·从环境检查到安装、启动和基础站点配置。

本文说明如何检查环境、安装有得CMS、启动本地服务并完成基础站点配置。

环境要求

  • PHP 8.2 ~ 8.4（命令行与 Web 使用同一个版本）
  • 扩展：pdo 及对应数据库驱动、mbstring、gd、json；fileinfo 可选但建议开启
  • 数据库：MySQL 5.7 / 8.0，或直接用 SQLite（无需额外服务）
  • 不需要 Composer，不需要 Node，不需要任何构建步骤

检查当前环境是否达标：

php -v
php -m | grep -E 'pdo|mbstring|gd|json|fileinfo'

命令行安装

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="我的公司"

安装器会生成 config/config.php、创建数据表、写入初始设置和管理员账号，并生成安装标记文件。重复执行不会覆盖已有配置。重装前需要移除现有配置并清空对应数据库。

浏览器安装

没有命令行权限时，可以上传整个目录，把站点根目录指向 public/，再访问 /install.php 填写数据库和管理员信息。安装成功后删除 public/install.php；如果安装器自删失败，页面会明确提示。

启动本地服务

本地开发可以使用 PHP 内置服务器。public/router.php 会把未命中静态文件的请求交给入口文件：

php -S 127.0.0.1:8000 -t public public/router.php
  • 前台： http://127.0.0.1:8000/
  • 后台： http://127.0.0.1:8000/admin

安装后的设置

  1. 进后台「设置」填站点名称、描述、联系方式和站点网址（site.url 影响 canonical 与 sitemap 的绝对地址）。
  2. 进「栏目」规划信息结构：列表型栏目出列表页和详情页，单页型栏目只有一篇正文。
  3. 进「菜单」组织主导航。导航项可以绑定栏目，也可以填写站内或外部地址。
  4. 复制 public/themes/default/ 为你自己的主题目录，改完用命令行切换：
php bin/set-theme.php mytheme
  1. 需要英文站时，进「语言」新增语言。默认语言不带 URL 前缀，其它语言带前缀（如 /en/news）。

常用命令

php bin/cms.php health         # 环境与配置体检
php bin/cms.php version        # 当前版本
php bin/cms.php cache:clear    # 清整页缓存与对象缓存
php bin/cms.php backup         # 备份数据库
php bin/cms.php migrate        # 执行尚未运行的编号迁移

安装发行包的升级应使用 php bin/cms.php upgrade <安装包.tar.gz>，它会完成预检、备份、清单校验、迁移和健康检查，不要手工覆盖核心目录。