Composer安装ThinkPHP 5失败是因为topthink/think默认拉取TP6，正确方式是用composer create-project topthink/think tp5 --prefer-dist -n后执行composer require topthink/framework:^5.1 --update-with-dependencies。
Composer 安装 ThinkPHP 5 不需要手动下载 ZIP 或复制文件，直接用 create-project 命令即可完成初始化，但必须指定正确的包名和版本约束，否则会拉取到不兼容的 dev 分支或空骨架。
为什么 composer create-project topthink/think 会失败或装错？
ThinkPHP 5 的稳定版（5.1.x）已归档进 topthink/framework，而 topthink/think 是 6.x+ 的入口包。直接运行不带版本号的命令，默认拉取最新版（即 TP6），导致你以为在装 TP5，实际得到的是 TP6。
- TP5.1 的正确包名是
topthink/framework，它本身不含 public 入口，需配合topthink/think（TP5 版本）骨架使用 - 官方推荐的 TP5 初始化方式是：用
topthink/think作为项目模板，再通过require指定topthink/framework:^5.1 - 如果本地 Composer 镜像没切回官方源（如 packagist.org），某些旧版本可能无法命中
快速部署 TP5 项目的三步实操（含验证）
以下命令在终端中逐行执行，无需额外配置，适用于 PHP 7.1+、Composer 2.x 环境：
- 运行
composer create-project topthink/think tp5 --prefer-dist -n（-n跳过交互，--prefer-dist加速下载） - 进入目录后检查
composer.json中"topthink/framework"的版本是否为^5.1；若看到^6.0，立刻删掉vendor和composer.lock，改用composer require topthink/framework:^5.1 --update-with-dependencies - 启动内置服务器验证：
php think run（TP5.1.39+ 支持）或php -S localhost:8000 -t public/，访问http://localhost:8000应显示 TP5 默认首页
常见错误现象与对应解法
部署后打不开、报错或路由失效，大概率不是环境问题，而是版本错位或入口路径不对：
立即学习“PHP免费学习笔记（深入）”；
- 浏览器显示
Warning: require(): open_basedir restriction in effect→ 检查public/index.php中define('APP_PATH')路径是否写死为../application/，TP5.1 默认用../app/ - 访问
/index.php/hello报 404，但php think route:list能列出路由 → Apache 未开启mod_rewrite或 Nginx 重写规则缺失；开发阶段优先用php -S绕过 -
php think命令提示Command "route:list" is not defined→think可执行文件权限不足，或think文件被误删，可从vendor/topthink/think-console复制一份回来
TP5 的核心复杂点不在安装，而在后续的模块加载顺序和自动加载映射——比如你改了 app/ 目录名却忘了同步更新 composer.json 的 "autoload": {"psr-4": {...}} 段，就会导致控制器找不到。这点容易被跳过，但一出问题就很难定位。
