ThinkPHP部署PHP环境怎么选择 安装指南分享

新项目选型，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 远远不够，必须启用并重启服务。这 5 个是基础中的基础： - fileinfo：文件类型检测，上传校验必需 - openssl：HTTPS、加密、JWT 等功能底层支持 - mbstring：多字节字符串处理，中文路由、JSON 输出都依赖它 - pdo_mysql：数据库驱动核心，没它连不上 MySQL - redis：缓存、Session、队列等常用组件的基础扩展 操作路径：宝塔 → 已安装的 PHP 8.0 → 设置 → 安装扩展 → 全部勾选 → 点击安装 → 最后一步很关键：务必点击“重启PHP服务”，否则扩展不会生效。

别跳过初始化方式：用 create-project，不用 require

ThinkPHP 不是普通 Composer 包，不能用 `composer require topthink/think` 来安装——那样只会拉取类库，缺失 public 入口、app 目录、think 命令脚本，必然报 `Class 'thinkApp' 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/` 目录 这三步做完，基本就能顺滑跑起来了。如果还出问题，大概率是扩展没装全或版本不匹配，回头检查一遍就好。