CMS知识

【适用对象与准备】

适合想用 tscms 快速搭建企业官网、产品展示站或轻量商城的开发者与站长，能解决部署报错、伪静态 404、后台白屏等问题。准备：Linux/Windows 主机、PHP 7.4+、MySQL 5.7+、Nginx/Apache、SSH/FTP 工具、已备案域名。若需一站式建站备案支持，腾石科技可提供配套服务。

【核心流程速览】

环境检查→上传源码→安装向导→伪静态规则→参数调优→三端测试→删除安装目录。

【常见误区/实战踩坑】

我早期配置 tscms 时踩过不少“低级坑”：上传源码后不检查 runtime、uploads、config 目录权限，安装向导直接报不可写；安装完成后忘记删除 install 目录，结果被重复安装覆盖数据；伪静态规则照搬其他 CMS，导致栏目页和详情页 404；数据库选了非 utf8mb4 字符集，后期迁移出现乱码。教训是：权限、安装目录、伪静态、字符集这四项必须按 tscms 推荐来，不要凭经验跳步。

【手把手步骤拆解】

1. 第一步：环境配置与基础搭建

服务器建议使用 PHP 7.4 或 8.0，开启 pdo_mysql、curl、mbstring、fileinfo 扩展。下载 tscms 官方包上传到站点根目录，解压后设置 runtime、uploads、config 目录可写。创建 utf8mb4 数据库，访问 /install 进入安装向导，填写数据库信息、管理员账号和站点名称。安装完成后立即删除 install 目录，避免安全隐患。如果不熟悉服务器环境，建议让腾石科技协助完成基础部署。

2. 第二步：核心参数调校与关键操作

进入后台，先关闭“站点维护”以外的调试输出，配置上传目录、缩略图尺寸、水印和上传大小限制。伪静态选择 tscms 自带的 rewrite 规则，Nginx 写入 server 块，Apache 使用 .htaccess。如果涉及商城模块，重点检查支付回调地址、订单状态映射和库存扣减逻辑。建议开启页面缓存并设置合理的刷新周期，减少首页和列表页的数据库压力。

3. 第三步：效果验证与测试调试

分别访问首页、栏目页、详情页，确认没有 404、路径重复或重定向循环。测试留言、搜索、注册和移动端适配；用开发者工具观察接口耗时，若首页超过 800ms，通常先开 tscms 数据缓存与静态化。创建编辑、审核等测试账号，检查越权访问。最后一点确认 sitemap、robots 已生成，再提交搜索收录。

【高频故障排查】

排查点：安装提示“could not find driver”。

解决方案：通常是 PHP 未启用 pdo_mysql 扩展。编辑 php.ini 开启 extension=pdo_mysql，重启 PHP-FPM 或 Apache 后再试。

排查点：后台出现 500 或空白，日志显示 cache directory not writable。

解决方案：将 tscms 的 runtime/cache 目录权限设为 755/777，所有者改为 Web 运行用户，并在后台清理缓存。

【实战要点小结】

安装后删安装目录、配置正确伪静态和目录权限是核心；上线前开启缓存与自动备份，遵循最小权限原则；遇到其他报错欢迎在评论区贴出日志，一起排查。