常见问题
question
TSCMS 介绍与简单使用教程
一、系统概述
1.1 什么是 TSCMS
TSCMS 是一款基于 ThinkPHP 5.1 框架开发的企业级内容管理系统（CMS），后台界面采用 Layui 构建，面向企业建站、内容门户、内部管理系统等场景，提供一站式的后台管理解决方案。
系统具备栏目管理、内容模型、模型管理、会员体系、RBAC 权限管控、多模块可插拔架构等特性。模块开发完全遵循 ThinkPHP 开发规范，不过度封装、不增加额外学习成本，熟悉 ThinkPHP 的开发者可以无缝上手，轻松完成二次开发与团队协作。
1.2 核心特性
特性 | 说明 |
栏目管理 | 无限级分类，支持单页面、文章列表、外部链接三种栏目类型 |
内容模型 | 内置单页、文章、图片三种默认模型，支持自定义模型与扩展字段 |
可插拔 模块 | 功能以模块形式独立安装/卸载，含友链、轮播、广告、表单、支付、采集、小程序等 |
RBAC 权限 | 基于后台菜单节点的细粒度权限控制，支持角色分组与授权 |
会员体系 | 会员注册/登录、积分与余额、内容收藏与投稿、充值管理 |
模板与静态化 | 多模板风格切换，自定义标签库调用数据，支持栏目/内容静态页生成 |
二、技术架构
2.1 技术栈
分类 | 技术 |
后端框架 | ThinkPHP 5.1 LTS（PHP >= 7.0） |
数据库 | MySQL 5.5+（推荐 5.7+） |
后台 UI | Layui |
前台模板 | ThinkPHP 内置模板引擎 + 自定义标签库 |
认证机制 | Session 双重签名校验 |
权限系统 | 基于菜单节点的 RBAC 模型 |
2.2 架构设计要点
• 多应用模式：后台（admin）、前台（content）、API（api）三个独立应用，共享 common 公共层
• 可插拔模块：功能以模块形式独立存在，支持按需安装与卸载
• 内容模型驱动：以模型定义内容结构，字段可自由扩展
• 自定义 URL 规则：后台配置 URL 规则模板，支持 {catdir}/{id}、{parentdir}/{catdir} 等变量
• 碎片功能：支持创建文本、编辑器、图片、多图等自定义碎片，供全站调用
三、运行环境要求
3.1 基础环境
项目 | 要求 |
PHP | >= 7.0（推荐 7.0 ~ 7.4，项目已兼容 PHP 8.0） |
MySQL | >= 5.5（推荐 5.7+） |
Web 服务器 | Apache 或 Nginx |
3.2 必须开启的 PHP 扩展
扩展 | 用途 |
PDO / pdo_mysql | 数据库连接与 MySQL 驱动 |
GD | 缩略图生成、验证码 |
mbstring | 多字节字符串处理 |
OpenSSL | 安全通信 |
CURL | 远程请求、内容采集 |
JSON | 数据交互 |
Fileinfo | 文件类型检测 |
ZIP | 模块打包与解压 |
3.3 需可写的目录
目录 | 说明 |
config/ | 数据库配置文件（安装时生成） |
runtime/ | 运行时缓存与日志 |
public/upload/ | 附件上传目录 |
application/install/ | 安装锁定文件写入 |
四、安装教程
4.1 方法一：安装向导（推荐）
1. 将源码解压到网站根目录（或 public/ 子目录）
2. 浏览器访问 http://您的域名/install.php（public 部署时访问 /public/install.php）
3. 第 1 步：阅读并同意许可协议
4. 第 2 步：环境检测，自动检查 PHP 版本、扩展与目录权限
5. 第 3 步：模块选择，勾选需要安装的扩展模块
6. 第 4 步：填写数据库连接信息和管理员账号
7. 第 5 步：自动安装，完成建表、注册模块、创建管理员
8. 安装完成后，访问 /admin 进入后台管理
注意：安装完成后，系统会在 application/install/install.lock 生成锁定文件；如需重新安装，请先手动删除该文件。
4.2 方法二：手动安装
1. 创建 UTF-8 编码的数据库
2. 导入 application/install/install.sql（安装向导会自动执行，也可手动导入）
3. 修改 config/database.php，填写数据库连接信息
4. 确保 runtime/cache/ 目录存在且可写
5. 执行以下 SQL 插入管理员信息（表前缀 ts_ 请替换为实际前缀）
INSERT INTO `ts_admin` VALUES (1, 'admin',
'3611c442253471e40a4c00a46c80e91f', 1, 'XdMi6D', '管理员', 1784725935,
'127.0.0.1', 'admin@admin.com', 1, 0, 1784700958);
6. 访问 /admin，使用默认账号 admin / 888521 登录
安全提示：手动安装使用的是项目 README 提供的示例数据，首次登录后请务必立即修改默认管理员密码。
4.3 伪静态配置（以 Nginx 为例）
将以下规则配置到站点 server 块中（public 目录部署示例）：
location / {
if (!-e $request_filename){
rewrite ^(.*)$ /index.php?s=$1 last;
break;
}
}
更多规则可参考项目根目录及 public 目录下的 nginx.htaccess 文件；ThinkPHP 5.1 的 URL 伪静态后缀默认为 .html，可通过 url_html_suffix 配置调整。
五、后台快速上手
5.1 登录后台
安装完成后，访问 http://您的域名/admin，使用安装时设置的管理员用户名和密码登录。
5.2 建站基本流程
1. 创建栏目：在栏目管理中新建站点栏目，选择栏目类型（单页面 / 文章列表 / 外部链接）
2. 配置模型：为栏目绑定内容模型（单页 / 文章 / 图片），按需为模型添加自定义字段
3. 发布内容：在内容管理中录入内容，支持缩略图、多图、附件、标签、推荐位、置顶/头条等属性
4. 配置 URL 规则：按需配置栏目与内容的 URL 规则模板，生成 SEO 友好的链接
5. 模板调用：在前台模板中使用自定义标签调用栏目与内容数据
6. 静态生成：对访问性能要求较高的站点，可对栏目与内容执行静态化生成
说明：以上为通用流程指引，具体菜单与入口名称以实际安装的版本为准。
5.3 常用功能速览
• 推荐位管理：将内容推送到置顶、头条、幻灯等推荐位
• 碎片管理：创建自定义碎片，在全站模板中灵活调用
• TAG 管理：一键导入标签，支持自定义 SEO 与自定义 URL
• 数据库管理：一键备份与还原数据库
• 敏感词与内链：批量添加敏感词并自动替换，批量添加内链实现自动内链
• Sitemap：一键生成 XML 网站地图
• 操作日志：完整记录后台所有增删改操作
六、模板开发基础
6.1 模板目录
前台模板位于 templates/ 目录，default 为默认风格。更换网站风格时，只需复制一套新的模板目录并在后台切换，无需修改程序代码。
6.2 自定义标签库
系统提供自定义标签库，用于在模板中调用内容数据，基本形式如下：
{ts module="content" action="lists" catid="1" num="10"}
{/ts}
其中 module 指定调用的模块，action 指定数据动作，catid、num 等为示例参数；完整参数与循环体语法请参考 templates/default 目录下的示例模板。
七、可插拔模块一览
模块 | 简介 |
友情链接 | 文字/图片链接管理，分组展示 |
轮播图 | 多组轮播管理，支持图片跳转链接 |
广告管理 | 广告位管理，支持多尺寸广告 |
自定义表单 | 自定义表单收集用户提交数据 |
支付模块 | 集成微信支付、支付宝 |
短信模块 | 集成阿里云、腾讯云等短信服务 |
采集模块 | 远程内容采集与批量入库 |
小程序模块 | 微信小程序接口支持 |
八、使用注意事项与建议
• 及时修改默认账号：安装完成后务必第一时间修改默认管理员密码
• 目录安全：生产环境中应禁止外部直接访问 runtime/、config/ 等非公开目录
• 定期备份：善用内置数据库备份功能，或在数据库层面定期备份
• 关注版本更新：项目处于活跃迭代期，升级前请先阅读 Gitee 提交记录并做好数据备份
• 环境选择：官方推荐 PHP 7.0 ~ 7.4，部署更高版本前建议先充分测试兼容性
