是的,ThinkPHP 6 必须通过 Composer 的 create-project 命令安装,因其采用“项目即框架”模型,需自动生成 app/、public/、runtime/ 等完整骨架及 autoload 规则;手动下载或 require 会导致 Class 'think\App' not found。

是的,ThinkPHP 6 及以上版本必须通过 Composer 安装,没有 Composer 就无法正确搭建框架。手动下载 ZIP、FTP 上传或 Git 克隆后不运行 Composer 命令,都会导致 Class 'think\App' not found 这类核心类加载失败——因为 vendor 目录、自动加载规则、app/ 和 public/ 结构全靠 Composer 初始化生成。
为什么必须用 Composer
ThinkPHP 6+ 采用“项目即框架”模型,它不是一个可直接 require 的纯库,而是一个带完整骨架(app/、config/、public/、runtime/、.env 模板、think 命令脚本)的标准化应用模板。Composer 的 create-project 命令会:
- 下载官方项目模板,而非仅框架源码
- 自动执行初始化脚本(如清空 runtime、生成基础配置)
- 注册
think\根命名空间到 autoload 规则中 - 确保
public/index.php能正确加载vendor/autoload.php并启动 App 实例
安装前必须确认的三项基础环境
执行任何安装命令前,请先验证:
-
PHP 版本:TP6 需 PHP ≥7.2.5,TP8 需 PHP ≥8.1;运行
php -v查看 -
必要扩展:mbstring、openssl、pdo、json、filter 必须启用;可用
php -m检查 -
Composer 可用:运行
composer --version,若提示未找到命令,需先配置系统 PATH 或重装 Composer
推荐安装方式:create-project(一步到位)
这是官方唯一推荐、开箱即用的方式:
立即学习“PHP免费学习笔记(深入)”;
- 进入目标目录(如
/var/www或D:\htdocs),执行:composer create-project topthink/think myapp - 想装指定版本(例如 TP6.3 LTS):
composer create-project "topthink/think:^6.3" myapp(加英文双引号防 shell 解析) - 国内网络慢?先切阿里云镜像:
composer config -g repo.packagist https://mirrors.aliyun.com/composer/ - 安装完成后,进入项目目录:
cd myapp,检查是否存在public/index.php和vendor/autoload.php
安装后关键检查项
光有文件还不够,还需确认运行条件:
-
runtime/ 目录必须可写:Linux/macOS 执行
chmod -R 755 runtime/;Windows 下确保 Apache/IIS 进程用户对该目录有修改权限 -
Web 服务器根目录必须指向 public/:Nginx/Apache 配置中 document_root 应为
myapp/public,否则访问报 404 或 “Primary script unknown” -
快速验证是否成功:在项目根目录运行
php think version,输出类似v6.3.10即表示框架已就绪
不复杂但容易忽略



















