新项目推荐ThinkPHP 6.x或8.0版本，因二者在稳定性、性能、维护性及部署适配方面真正扛得住生产环境；TP3.2和TP5.x已掉队，TP6是PHP 7.1–8.0下经大量线上验证的成熟主力，TP8是PHP 8.0+下深度集成新特性的长期技术锚点。
ThinkPHP部署对PHP环境有明确要求，选错版本或漏装扩展，轻则白屏、404，重则502报错甚至路由失效。核心不是“越高越好”，而是“匹配才稳”。
选对PHP版本：TP6认准8.0，禁用8.3+
ThinkPHP 6.x 官方明确推荐 PHP 8.0，不兼容 PHP 8.3 及以上版本。PHP 8.3+ 中部分函数被移除或行为变更，会导致 TP6 启动失败、路由解析异常、扩展加载报错。
- 在宝塔「软件商店」中手动搜索并安装 PHP 8.0（注意不是“最新版”或“PHP 8.3”）
- 如使用 ThinkPHP 5.1 或 5.2，可选 PHP 7.2–7.4；但新项目强烈建议统一用 TP6 + PHP 8.0 组合
- MySQL 建议搭配 5.7 或 8.0，与本地开发环境保持一致，避免字符集或严格模式差异
装齐关键扩展：5个必须，缺一不可
TP6 的路由、数据库、缓存、加密和文件处理全部依赖特定扩展。仅安装 PHP 不够，必须启用并重启服务。
- fileinfo：文件类型检测，上传校验必需
- openssl：HTTPS、加密、JWT 等功能底层支持
- mbstring：多字节字符串处理，中文路由、JSON 输出依赖它
- pdo_mysql：数据库驱动核心，没它连不上 MySQL
- redis：缓存、Session、队列等常用组件的基础扩展
操作路径：宝塔 → 已安装的 PHP 8.0 → 设置 → 安装扩展 → 全部勾选 → 点击安装 → 务必点击“重启PHP服务”
立即学习“PHP免费学习笔记（深入）”；
别跳过初始化方式：用 create-project，不用 require
ThinkPHP 不是普通 Composer 包，不能用 composer require topthink/think 安装——那只会拉取类库，缺失 public 入口、app 目录、think 命令脚本，必然报 Class 'think\App' not found 或 404。
- 在空目录下执行：
composer create-project topthink/think myapp - 指定版本（如 TP8）：
composer create-project topthink/think myapp@8.0 - 国内慢？先换镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
运行前检查三件事
代码上传后不能直接访问，还需确认以下配置已生效：
-
网站运行目录设为 /public：宝塔站点设置 → 网站目录 → 运行目录填
/public（开头带斜杠） -
Nginx 伪静态规则正确：
location / { try_files $uri $uri/ /index.php?$query_string; } -
.env 配置已启用：重命名
.example.env为.env，取消APP_DEBUG=true注释，清空runtime/cache/目录
