ThinkPHP6.0如何安装_使用Composer安装ThinkPHP6.0【教程】

先说个关键点：用Composer装ThinkPHP 6，最稳妥的方式永远是 composer create-project topthink/think。这命令会直接生成完整的项目骨架——包括 app/ 目录、public/index.php 入口文件、think 命令行脚本等等。要是图省事用 composer require topthink/think，那就麻烦了：它只会把核心包丢进 vendor/，剩下的 app/、public/ 一个都没有，自动加载规则也注册不全。结果就是页面直接报 Class 'thinkApp' not found 或 Failed opening required 'base.php'，连入口都进不去。

所以这个坑一定要避开。

为什么 composer require topthink/think 一定失败

TP6 的设计理念是“框架即项目”——topthink/think 本身就是一个完整的项目模板，不是普通的 Composer 库。用 require 安装，它只会被当作一个依赖包塞进 vendor/，后果非常具体：

• public/index.php 不存在 → Web 服务器找不到入口，Nginx/Apache 会报 Primary script unknown 或者直接白屏。
• think 命令行不可用 → 执行 php think version 会提示 Command "version" is not defined，连版本号都看不到。
• 自动加载规则未注册 → Container、App 这类核心类根本不会被识别，后续所有依赖解析全部崩溃。

换句话说，这不是命令写错了，而是选错了命令类型。

composer create-project 的正确写法和版本控制

正确的命令需要带上项目目录名，而且强烈建议显式指定稳定版本号——这是为了防止 Composer 拉取到 dev-main 或 RC 版本，引发兼容性问题：

• 基础命令：composer create-project topthink/think tp6-demo （项目名随意取）
• 指定稳定版（推荐）：composer create-project "topthink/think:^6.1" myapp —— 注意双引号，防止 shell 把 ^ 解析成特殊字符。
• 安装特定旧版（如 v6.0.13）：composer create-project topthink/think@v6.0.13 oldapp
• 国内网络速度慢？加上 --prefer-dist 强制用压缩包：composer create-project topthink/think tp6 --prefer-dist

执行成功后，Composer 会自动创建目录、初始化 Git（如果系统有）、解压所有骨架文件——这才是 TP6 能跑起来的前提条件。

安装完立刻验证的三个硬性条件

生成目录 ≠ 能访问。进到项目根目录后，必须确认以下三点，缺一不可：

• public/index.php 和 vendor/autoload.php 必须存在 —— 缺任意一个说明镜像损坏或安装过程中断了（可以先用 composer clear-cache 清缓存再重试）。
• runtime/ 目录必须可写：Linux/macOS 下执行 chmod -R 755 runtime/；Windows 下要确保 IIS 或 PHP-CGI 进程用户有写权限。
• 运行 php think version 输出应为 v6.x.x —— 如果报错，基本可断定没走 create-project 流程，而是误用了 require。

.env 文件不配，TP6 就是“静默哑火”

TP6 默认不会生成 .env 文件，也不会报错——它会直接 fallback 到内置默认值：数据库为空、APP_DEBUG=false、路由关闭。你改了代码却看不到效果，很容易误以为是代码写错了。

• 手动复制：cp .env.example .env
• 最小可用配置（UTF-8 无 BOM）：

APP_DEBUG = true
APP_ENV = local

• 注意：不要在 .env 里写中文注释或留空行——TP6 的 Env 类解析器会直接中断加载，后面所有变量都会失效。

说实话，真正让人头疼的从来不是命令敲错，而是 runtime/ 权限不对、.env 没生效、Web 根目录没指向 public/。这三处出问题，页面会毫无提示地白屏，排查成本远高于重装一次。所以安装完别急着写代码，先把环境验证走一遍。