Linux服务器上 ThinkPHP 更新与维护实操手册
一 升级前准备
- 明确目标版本与变更范围：优先查阅官方升级指南与版本变更说明，避免跨大版本跳跃；必要时采用逐步升级（如先到中间版本再升级到目标版本）。
- 检查运行环境：确认PHP 版本与扩展满足目标版本要求（例如 ThinkPHP 8.x 要求 PHP >= 8.0.0），并核对数据库、缓存、队列等依赖。
- 全量备份：备份代码、数据库、附件与配置，并准备可回滚方案（如 Git 标签/分支、快照）。
- 搭建预发布环境：尽量在与生产一致的预发布环境验证升级，覆盖关键业务与第三方扩展。
- 变更记录：梳理将要调整的配置结构、路由规则、废弃 API与扩展兼容性问题，形成升级清单。
二 标准升级流程
- 方式 A（Composer 推荐）：在项目根目录执行
- 调整 composer.json 的版本约束（如 TP8 常见为：“topthink/framework”: “^8.0”）；
- 执行升级：composer update；
- 若涉及大版本变更，按官方指引执行命令（如：php think service:discover、php think vendor:publish）；
- 视情况删除 composer.lock 并重新安装依赖（谨慎，确保锁文件受控）。
- 方式 B（替换框架核心目录）：
- 仅替换thinkphp 框架目录，务必保留你的应用目录（application 或 app）；
- 升级后清理runtime 目录缓存；
- 检查并更新配置文件结构与差异。
- 方式 C（在线升级脚本，谨慎）：如确有需要，可使用社区脚本（如将 updateTP.php 放入 public 后访问执行），务必在隔离环境验证并先备份。
- 通用后续：
- 按官方升级说明修改不兼容代码（函数废弃、参数变更、路由规则调整等）；
- 升级第三方扩展至兼容版本；
- 执行数据库迁移/结构变更并回归测试。
三 兼容性处理与常见问题
- PHP 与扩展：核对目标版本对 PHP 版本与扩展的要求；在 CentOS 等系统可通过 EPEL 安装所需扩展（如 php-mysql、php-gd、php-mbstring、php-xml、php-zip）。
- 第三方库：逐一确认扩展与依赖包与新版本框架的兼容性，必要时升级或替换。
- 废弃与变更：重点排查函数/类废弃、配置结构变化、路由规则调整等，并参考官方迁移指南逐项修正。
- 路径与入口：若出现类似 “ThinkPHP/ThinkPHP.php 不存在” 的报错，检查入口文件引入路径是否正确，并确认框架目录存在与权限无误。
- 环境一致性：在本地或预发布环境模拟生产进行调试与测试，尽早暴露兼容性问题。
四 生产发布与回滚策略
- 发布窗口与灰度：选择低峰时段发布，优先灰度小流量，观察日志与监控后再全量。
- 原子化发布：使用软链接切换或蓝绿/金丝雀发布，确保可快速回滚；代码与配置分离管理。
- 服务管理：使用 Supervisor 管理常驻进程（如队列、自定义命令），发布后执行重启；注意热更新仅用于开发环境，生产环境不建议依赖文件变动自动重启。
- 回滚预案：保留上一版本可运行包与数据库备份；回滚时优先恢复代码与配置，再校验数据与扩展版本。
- 发布后验证：核对关键业务链路、错误日志、慢查询、第三方回调与缓存命中率。
五 日常维护与安全加固
- 环境与依赖：持续关注 PHP 与扩展的安全更新；使用 Composer 管理依赖并及时升级。
- 安全加固：严格校验输入过滤与输出转义，防范 SQL 注入、XSS 等常见漏洞；最小化文件与目录权限，禁止执行上传目录脚本。
- 性能与缓存：合理配置数据缓存、页面缓存、模板缓存；优化数据库索引与查询；启用 OPcache 提升性能。
- 日志与监控：完善应用与 PHP-FPM 日志，接入监控告警（错误率、响应时延、磁盘与内存）；定期审计异常请求与登录。
- 备份与演练：定期全量与增量备份，并进行恢复演练验证可用性；保留多份历史备份与校验值。