ThinkPHP 3.2.3适用于PHP 5.3–5.6老旧环境、零Composer单文件部署;5.x适合中小企业快速开发,需注意5.1与5.2中间件差异;6.x要求PHP≥7.1、强制Composer与PSR规范,原生支持协程和队列,适配高并发场景。

你需要为新项目选型ThinkPHP版本,但面对3.2.3、5.x、6.x多个主流分支拿不定主意——不同版本的路由机制、队列支持、Composer依赖方式、安全策略差异极大,选错版本会导致后期重构成本飙升。
ThinkPHP 3.2.3:老项目维护与轻量级内网系统首选
该版本仍被大量政企内网系统、老旧OA、本地部署CMS持续使用,核心优势是零 Composer 依赖、单文件部署、Apache + .htaccess 即可运行。
第一步:确认服务器环境为 PHP 5.3–5.6,且无法升级。若已启用 PHP 7.0+,强行运行会触发 fatal error —— 【3.2.3不兼容PHP 7.0及以上】。
第二步:检查项目是否含大量自定义函数库(如 common.php)和非命名空间类。3.2.3无PSR-4自动加载,所有类需手动 require 或通过 App::import() 加载。
立即学习“PHP免费学习笔记(深入)”;
第三步:若需 HTTPS 强制跳转或伪静态,直接编辑根目录 .htaccess 文件,启用 RewriteEngine 并配置 RewriteBase / —— 这是它唯一可靠的路由控制方式。
ThinkPHP 5.x:中小企业官网、后台管理系统快速交付主力
这是当前国内中小企业采用率最高的版本,兼顾开发速度、中文文档成熟度与部署灵活性,特别适合需要快速上线、团队PHP基础中等的项目。
方法一:命令行初始化(推荐)→ 执行 composer create-project topthink/think=5.1.* tp5 → 进入 tp5 目录 → 运行 php think run 启动内置服务器。
方法二:手动下载压缩包 → 解压后执行 chmod -R 755 runtime/ public/ → 确保 runtime 目录可写,否则日志、缓存、模板编译全部失败。
注意:5.1 与 5.2 存在重大差异——5.2 默认启用中间件机制,而 5.1 仍以钩子(Hook)为主;若复用旧插件,请核对 vendor/topthink/think-installer 版本号,【5.1 插件无法直接用于 5.2】。
ThinkPHP 6.x:高并发API服务、微服务模块、队列驱动型系统的标配
TP6 是首个完全基于 PSR-12 规范、强制依赖 Composer、原生支持协程(需 Swoole 扩展)的版本,适用于订单中心、支付回调、实时消息推送等强一致性场景。
- 安装前必须确认 PHP ≥ 7.1,且已启用 mbstring、openssl、json、PDO 扩展——缺一不可,否则 composer install 直接中断。
- 执行
composer create-project topthink/think tp6→ 自动生成 app、config、route、app/provider 等标准目录结构。 - 队列任务发布只需一行:
think\queue\Job::push('app\common\job\ClearOrderJob', ['order_id' => 1001]);→ 对应消费者进程监听 redis 队列即可执行。 - 若启用多应用模式(如 admin + api),需在 config/app.php 中设置
'multi_app' => true,并确保每个应用有独立的 route/ 目录与 middleware/ 配置。



















