必须用 create-project 而非 require,因 ThinkPHP 是「框架即项目」结构;require 仅安装核心类,缺失 app/、public/、runtime/ 等关键文件及自动加载配置,导致 404、命令报错、类找不到;create-project 才能生成完整可运行骨架。

必须用 create-project,不能用 require。
ThinkPHP 是「框架即项目」的结构,不是普通可引入的库。composer require topthink/think 只会把核心类放进 vendor/,不生成 app/、public/、runtime/、.env、think 命令脚本等必要文件——结果必然是:
- 访问网站显示 404 或白屏(
public/index.php缺失) - 执行
php think version报错Command "version" is not defined(CLI 入口没初始化) - 运行时报
Class 'think\App' not found(自动加载规则未注册,入口逻辑缺失)
create-project 才是真正创建完整可运行项目的命令,它会:
- 下载并解压预设好的项目骨架(含目录结构、入口文件、配置模板、钩子脚本)
- 自动执行
composer install安装依赖 - 触发
post-create-project-cmd(如生成 runtime 目录、复制.env.example)
正确写法示例:
立即学习“PHP免费学习笔记(深入)”;
- 基础安装:
composer create-project topthink/think myapp - 指定稳定版(推荐):
composer create-project "topthink/think:^8.0" myapp --stability=stable --remove-vcs - 国内加速:加
--prefer-dist - 避免交互卡住:加
--no-interaction
装完后务必检查三件事:
-
public/index.php和vendor/autoload.php是否存在 -
runtime/目录是否可写(Linux/macOS 执行chmod -R 755 runtime/) - 运行
php think version能正常输出版本号
如果用了 require,删掉整个目录重来——这不是配置问题,是骨架根本没建起来。



















