安装部署指南

从环境准备到首屏可见的完整安装流程。

环境要求

• PHP 8.2+（推荐 8.3）
• MySQL 8.0+ 或 MariaDB 10.6+
• Nginx / Apache / 内置 php think run
• Composer 2.5+
• 必装扩展：pdo_mysql、mbstring、openssl、json、fileinfo、gd

获取代码

git clone https://your-repo/xpcms.git
cd xpcms/tp
composer install

配置数据库

编辑 .env 文件：

[DATABASE]
TYPE = mysql
HOSTNAME = 127.0.0.1
DATABASE = xpcms
USERNAME = root
PASSWORD = your_password
HOSTPORT = 3306
CHARSET = utf8mb4
PREFIX = xp_

初始化数据库

php think migrate:run
php think db:seed

启动开发服务器

php think run
# 访问 http://localhost:8000

生产环境部署

• Nginx 配置 root 指向 tp/public，开启 try_files 重写
• PHP-FPM 7.4+（推荐 8.2）
• 关闭 display_errors，开启 opcache
• 静态资源目录 public/static/ 由 Nginx 直连
• 设置 storage/ 与 runtime/ 可写

主题切换

登录后台 → 系统 → 主题管理，点击「启用」即可切换前台主题。所有主题位于 themes/frontend/{主题名}/ 目录。

提示：default 主题受 ThemeService 硬编码保护，只能停用不能卸载。