一、环境要求

二、安装前的准备

2.1 下载解压

将 TScms 源码包解压到网站目录，解压后目录结构如下：

wwwroot/
├── application/          # 应用代码（模块）
├── config/               # 配置文件（安装时会写入 database.php）
├── extend/               # 扩展类库
├── public/               # 入口 + 静态资源
├── route/                # 路由
├── runtime/              # 运行时缓存（须可写）
├── templates/            # 模板文件
├── thinkphp/             # TP5.1 框架核心
├── vendor/               # Composer 依赖
├── index.php             # 前台入口
├── install.php           # ★ 安装向导入口（关键！）
└── nginx.htaccess        # Nginx 伪静态规则参考

2.2 检查目录权限

以下目录必须可写（755 或 777）：

2.3 配置伪静态

Nginx 参考配置：

server {
    listen 80;
    server_name yourdomain.com;
    root /path/to/your/site;
    index index.php;

    location / {
        if (!-e $request_filename) {
            rewrite ^/(.*)$ /index.php/$1 last;
        }
    }

    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;
    }
}

Apache .htaccess：

Options +FollowSymlinks -Multiviews
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]

三、安装流程（共 5 步）

在浏览器中访问：http://yourdomain.com/install.php

第 1 步：许可协议
阅读 TScms 软件使用协议 → 勾选 "我已阅读并同意以上协议" → 点击 "下一步"

第 2 步：环境检测
系统自动检测 15 项（PHP 版本、扩展、目录权限、URL 重写等）。
不通过的项目显示红色提示，"下一步"按钮被禁用。请根据提示修复后再继续。

第 3 步：模块选择
系统核心（必装）：系统管理、内容管理、会员中心
可选模块（按需勾选）：广告、轮播图、友情链接、表单引导、采集、微信小程序、Bug 反馈、短信服务等
 选择完成后点击 "下一步"。

第 4 步：数据库配置 + 管理员账号

数据库设置：
主机（默认 localhost）、端口（3306）、用户名、密码、数据库名（不存在则自动创建）、表前缀（默认 tc_）填写后点击 "测试连接" 验证。
管理员账号：
管理员用户名、密码（建议 8 位以上）、确认密码、邮箱填写完成后点击 "安装" 提交。

第 5 步：执行安装（实时进度条）
系统逐项执行：
3% ~ 75%：创建数据表（执行 install.sql）
76%：安装选择的模块（执行模块 SQL + 注册菜单）
88%：创建超级管理员
95%：自动生成 config/database.php 配置文件
100%：创建安装锁 install.lock → 安装完成

 ✅ 安装完成页面会显示后台地址和管理员信息。

四、安装后操作

1. 修改管理员密码：系统 → 管理员管理 → 修改密码

2. 更新系统缓存：系统 → 更新缓存 → 全部更新

3. 配置网站信息：系统 → 系统配置 → 基本设置

4. 配置 URL 规则（可选）：扩展 → URL规则管理

5. 删除安装文件（安全）：验证 install.lock 已生成即可

后台访问

前台首页：http://yourdomain.com/
后台管理：http://yourdomain.com/admin
默认管理员：admin（你在第4步设置的用户名）

五、常见问题

Q1：访问 install.php 提示"系统已安装"

说明 install.lock 已存在。如需重装，需删除 /application/install/install.lock 文件。

Q2：环境检测不通过

根据红色提示逐一修复：缺少扩展则安装对应 PHP 扩展，目录不可写则设置 755 权限。

Q3：数据库连接失败

确认 MySQL 服务已启动、用户名密码正确、MySQL 允许连接（不在本机时需开启远程连接）。

Q4：安装到一半卡住

检查 PHP max_execution_time 是否过小，或数据库权限不足。

Q5：安装后前台 404

检查伪静态配置是否正确，Nginx 确保 rewrite 规则已生效。重启 Nginx/Apache 试试。

Q6：后台验证码不显示

检查 GD 库是否安装，runtime/cache/ 目录是否可写。

六、public 目录部署方式（推荐）

为安全起见，建议将网站根目录指向 public/：

1. 网站根目录配置为 /path/to/public/

2. 访问 http://yourdomain.com/install.php 开始安装

3. 在入口文件定义常量：define('IF_PUBLIC', true);

七、安装文件一览

八、安装后数据表概览

安装程序会创建以下核心表（表前缀默认为 tc_，可在第 4 步自定义）：