ThinkPHP 8.0必须用composer create-project安装,因依赖自动加载、服务发现等机制,手动复制或Git克隆无法初始化结构;需PHP 8.0+(推荐8.1/8.2)并启用fileinfo、mbstring、openssl、pdo扩展,安装后执行php think version和php think run验证。

ThinkPHP 8.0 必须用 Composer 新建项目,不能靠手动复制或 Git 克隆“代替安装”——因为框架依赖自动加载、服务发现、配置合并等机制,只有 create-project 能一次性完成结构初始化和依赖安装。
确认 PHP 环境已就绪
TP8.0 要求 PHP 8.0+(推荐 8.1 或 8.2),且必须启用四项核心扩展:fileinfo、mbstring、openssl、pdo。执行以下两步验证:
- 运行
php --ini,确认 Loaded Configuration File 指向你实际修改的php.ini(不是php.ini-development) - 运行
php -m | grep -E "fileinfo|mbstring|openssl|pdo"(Mac/Linux)或php -m | findstr "fileinfo mbstring openssl pdo"(Windows),确保四者全部列出 - 若缺失某项,打开对应 php.ini,取消
extension=...行前的分号;注意后缀:Windows 用.dll,Linux/macOS 用.so - 改完重启终端再验证——PATH 指向旧 PHP 目录是 Windows 用户最常踩的坑
换国内镜像源(提速防失败)
Composer 默认源在国外,首次使用极易卡在解压或超时。执行一次即可全局生效:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/- 如遇 zlib_decode 错误或长时间卡在 installing dependencies,临时关闭 Windows Defender 实时防护
执行 create-project 创建项目
进入你打算存放项目的目录(如 D:\projects 或 /data/www),运行命令:
- 标准安装(自动拉最新稳定版 TP8.x):
composer create-project topthink/think blog→ 生成blog/文件夹 - 指定版本(防意外降级):
composer create-project topthink/think blog 8.0.12 - 当前目录安装(适合已有空文件夹):
composer create-project topthink/think .(末尾是英文句点)
⚠️ 注意:目标文件夹必须为空,否则报错 Destination folder already exists and is not empty。
启动并验证项目
进入项目根目录后,快速验证是否成功:
- 查看框架版本:
php think version→ 应输出类似v8.0.12 - 启动内置服务器:
php think run→ 访问 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a 看到 ThinkPHP 欢迎页即成功 - 不要用
php -S直接跑 public/index.php —— TP8 的路由和中间件依赖think run启动器
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











