安装 Daiying CMS 的完整步骤

适用对象

本教程适合首次部署 Daiying CMS 的站长和开发者，帮助完成从环境准备到安装完成的全流程操作。

环境要求

PHP 版本：8.3.0 或更高 必须启用 PHP 扩展：pdo、json、openssl、fileinfo、zip 推荐数据库：SQLite（适合轻量部署）或 MySQL/MariaDB（适合生产环境，建议使用 utf8mb4 编码）

下载与准备

1. 访问 Daiying CMS 官方 GitHub Releases 页面，下载最新稳定版 ZIP 压缩包。 2. 将 ZIP 包上传至服务器，解压到 Web 服务器的站点根目录。 3. 确保 Web 服务器的站点根目录指向解压后的 `public` 目录，入口文件为 `public/index.php`。

目录权限设置

确保以下目录具有可写权限（根据服务器环境设置对应权限）： `storage/` `storage/logs/` `storage/cache/` `storage/tmp/` `storage/database/` `storage/updates/incoming/` `storage/recovery/` `storage/plugin-installs/uploads/` `storage/plugin-installs/staging/` `content/uploads/` 安装器会自动检测 `config` 和 `storage` 目录的写权限。

安装步骤

1. 访问安装入口

在浏览器中访问 `http://your-domain/install` 进入安装器。

2. 环境检查

安装器会自动检测 PHP 版本和必需扩展，确保满足要求后继续。

3. 选择数据库类型

**SQLite**： 需填写数据库文件路径，路径必须有效且限制在 CMS 目录内。 目录不存在时安装器会尝试创建。 **MySQL/MariaDB**： 需填写数据库主机（host）、端口（port）、数据库名、用户名、密码。 生产环境建议使用权限最小的数据库账号。

4. 测试数据库连接

填写信息后点击测试连接，确认数据库可用。

5. 填写站点信息

站点名称（必填） 站点 URL（可选） 管理员邮箱（必填） 管理员显示名称（必填） 管理员密码（必填）

6. 提交安装

安装器将执行核心数据库迁移，写入配置文件 `config/app.php`，创建运行目录，并生成 `storage/installed.lock` 文件。

7. 安装完成

安装完成后，访问 `/install` 会自动跳转到后台登录页面 `/admin/login`。

后台登录

访问 `http://your-domain/admin/login`，使用安装时设置的管理员邮箱和密码登录后台管理界面。

健康检查

访问 `http://your-domain/health`，返回 JSON 格式的系统状态信息，包括： status mode version installed

后台恢复与更新

访问 `/admin/recovery` 进行后台恢复诊断。 访问 `/admin/update` 进行系统更新。

常见错误排查

**环境不满足**：确认 PHP 版本至少 8.3.0，且启用所有必需扩展。 **目录不可写**：检查并设置 `storage/` 和 `config/` 目录的写权限。 **数据库连接失败**：确认数据库信息正确，数据库服务正常运行。 **SQLite 路径无效**：确保路径在 CMS 目录内且目录存在或可创建。

完成以上步骤后，您的 Daiying CMS 即可正常运行。