标签使用
biaoqian
TSCMS安装教程
一、环境要求
| 组件 | 要求 | 推荐 |
|---|---|---|
| Web 服务器 | Apache / Nginx / IIS | Nginx |
| PHP 版本 | >= 7.0.0 | 7.2 ~ 7.4 |
| MySQL | >= 5.5 | 5.7+ |
| PHP 内存限制 | memory_limit >= 128M | 256M |
| 必装扩展 | PDO、PDO_MySQL、GD、Session、mbstring、OpenSSL、CURL、JSON、Fileinfo、ZIP | |
| URL 重写 | 需要支持（Nginx Rewrite / Apache mod_rewrite） | |
二、安装前的准备
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）：
| 目录 | 说明 |
|---|---|
| /config/ | 安装时写入 database.php 配置文件 |
| /runtime/ | 运行时缓存 |
| /application/install/ | 安装完成后写入 install.lock 锁文件 |
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 重写等）。
不通过的项目显示红色提示，"下一步"按钮被禁用。请根据提示修复后再继续。
| 检查项 | 要求 |
|---|---|
| PHP 版本 | >= 7.0.0 |
| PDO / PDO_MySQL | 已开启 |
| Session / GD / mbstring | 已开启 |
| OpenSSL / CURL / JSON | 已开启 |
| Fileinfo / ZIP | 已开启 |
| config / runtime / uploads / install 目录 | 可写 |
| memory_limit | >= 128M |
| URL 重写 | 支持 |
第 3 步：模块选择
系统核心（必装）：系统管理、内容管理、会员中心
可选模块（按需勾选）：广告、轮播图、友情链接、表单引导、采集、微信小程序、Bug 反馈、短信服务等
选择完成后点击 "下一步"。
第 4 步：数据库配置 + 管理员账号
数据库设置：
主机（默认 localhost）、端口（3306）、用户名、密码、数据库名（不存在则自动创建）、表前缀（默认 tc_）填写后点击 "测试连接" 验证。
管理员账号：
管理员用户名、密码（建议 8 位以上）、确认密码、邮箱填写完成后点击 "安装" 提交。
第 5 步：执行安装（实时进度条）
系统逐项执行：
3% ~ 75%：创建数据表（执行 install.sql）
76%：安装选择的模块（执行模块 SQL + 注册菜单）
88%：创建超级管理员
95%：自动生成 config/database.php 配置文件
100%：创建安装锁 install.lock → 安装完成
✅ 安装完成页面会显示后台地址和管理员信息。
四、安装后操作
修改管理员密码：系统 → 管理员管理 → 修改密码
更新系统缓存：系统 → 更新缓存 → 全部更新
配置网站信息：系统 → 系统配置 → 基本设置
配置 URL 规则（可选）：扩展 → URL规则管理
删除安装文件（安全）：验证 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/：
网站根目录配置为
/path/to/public/访问
http://yourdomain.com/install.php开始安装在入口文件定义常量：
define('IF_PUBLIC', true);
七、安装文件一览
| 文件 | 说明 |
|---|---|
| /install.php | 安装入口（根目录部署） |
| /public/install.php | 安装入口（public 部署） |
| /application/install/controller/Index.php | 安装逻辑控制器（完整安装流程） |
| /application/install/view/index/ | 5 个步骤的视图模板 |
| /application/install/install.sql | 数据库初始化 SQL（约 1100 行、30+ 张表） |
| /application/install/install.lock | 安装锁（安装完成后自动生成） |
八、安装后数据表概览
安装程序会创建以下核心表（表前缀默认为 tc_，可在第 4 步自定义）：
| 表名 | 说明 |
|---|---|
| tc_admin | 管理员 |
| tc_article / tc_article_data | 文章模型（主表+附表） |
| tc_attachment | 附件 |
| tc_auth_group | 权限角色组 |
| tc_category | 栏目 |
| tc_config | 系统配置（29 条默认值） |
| tc_member / tc_member_data | 会员（主表+附表） |
| tc_menu | 后台菜单（约 165 条） |
| tc_model / tc_model_field | 模型定义 + 字段定义 |
| tc_page | 单页模型 |
| tc_picture / tc_picture_data | 图片模型（主表+附表） |
| tc_position / tc_position_data | 推荐位 |
| tc_tag / tc_tag_data | 标签 |
| tc_urlrule | URL 规则（约 24 种） |
| tc_log | 操作日志 |
| tc_recycle | 回收站 |
| tc_module | 模块注册 |
| + 各可选模块表 | ad、swiper、link 等 |
