ThinkPHP版本选型与企业级开发标准_技术栈选择准则-ThinkPHP-PHP中文网

tp6 更值得用于企业级项目。tp8虽为官方主推且支持协程，但生态不成熟、文档碎片化、扩展包适配滞后；tp6 lts版本稳定，中间件、事务、nginx部署等机制清晰可控，适合长期维护。

thinkphp版本选型与企业级开发标准_技术栈选择准则

ThinkPHP 6 和 ThinkPHP 8 哪个更值得用？

TP8 是官方当前主推版本，但企业级项目选 TP6 更稳妥。TP8 虽然底层改用 Hyperf 风格协程支持、路由更灵活，但生态适配滞后：主流扩展包（如 topthink/think-queue、topthink/think-captcha）在 TP8 下要么未适配，要么仅 alpha 版；文档碎片化严重，vendor/topthink/framework/src/ 内部类命名和生命周期与 TP6 差异大，二次开发成本高。

实操建议：

新项目若需长期维护、依赖成熟中间件（如 Redis 队列、多语言、审计日志），优先选 thinkphp/framework v6.3.x（LTS 版本）
TP8 仅建议用于纯 API 服务 + 自研组件栈 + 团队熟悉 Swoole 协程模型的场景
注意 Composer 安装时别手滑执行 composer create-project topthink/think——它默认拉 TP8，要指定版本：composer create-project "topthink/think:^6.3"

TP6 中 `Db::transaction()` 的坑怎么避？

事务不是加个函数就自动兜底的。常见错误是嵌套调用时没处理好连接复用，或异常被捕获后没主动 rollback，导致锁表、数据不一致。

实操建议：

不要在事务块内调用含独立 Db::connect() 的第三方方法，否则可能跨连接，事务失效
显式捕获异常后必须手动 Db::rollback()，不能只靠 finally 里的 commit —— TP6 的 Db::transaction() 不会自动 rollback 未抛出的异常
高并发下慎用长事务，Db::transaction() 默认使用主库连接，阻塞期间其他写请求排队，容易触发 MySQL Lock wait timeout exceeded

示例安全写法：

try {
    Db::transaction(function () {
        Db::table('order')->insert([...]);
        Db::table('log')->insert([...]);
    });
} catch (\Exception $e) {
    // 日志记录 + 抛出，让外层统一处理
    throw $e;
}

TP6 多应用模式下 `app/middleware.php` 和中间件类加载顺序混乱？

TP6 多应用（app/admin、app/api）共存时，全局中间件和应用级中间件的注册时机不同，app/middleware.php 里配置的中间件会早于应用自己的 middleware.php 加载，但执行顺序却受路由绑定影响，容易误以为“没生效”。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

实操建议：

全局中间件（app/middleware.php）只放真正全站通用逻辑，比如基础 CORS、请求 ID 注入；业务相关中间件一律定义在对应应用目录下（如 app/admin/middleware/AuthCheck.php）并显式绑定到路由组
检查中间件是否被跳过：TP6 默认对 static 目录、.html 后缀等静态资源路径不执行中间件，可在 app/middleware.php 中调整 except 配置
调试加载顺序可用 echo get_class($middleware) . "\n"; 在中间件 handle() 开头输出，配合日志确认实际执行链

TP6 部署到 Nginx 时 404 或路由错乱？

根本原因不是 ThinkPHP 本身，而是 Nginx 没把非静态资源请求全部转发给 index.php 入口，导致路由解析失败。常见于直接复制 Apache 的 .htaccess 规则、或用了过时的 TP5 伪静态配置。

实操建议：

Nginx 配置中必须包含这段 location 块：
```
location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
    }
}
```
注意：不是 try_files，TP6 的 URL 解析依赖 s= 参数
确保 PHP-FPM 的 SCRIPT_FILENAME 正确传递，Nginx 配置里要有 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
如果用子目录部署（如 https://example.com/admin/），需在 config/app.php 中设置 'app_subpath' => true，否则路由解析会丢掉前缀
上线前务必关掉 app_debug = false，否则部分 404 错误会显示为白屏而非友好提示，掩盖真实问题