唯一推荐方式是composer create-project topthink/think myapp,它自动下载tp8骨架、安装依赖、生成.env和runtime目录;需确保php≥8.1、composer 2.5+、空目录,并检查app_debug、runtime可写及web根目录指向public/。

确认基础环境是否就绪
在执行命令前,请确保以下几点已满足:
- PHP 版本 ≥ 8.1(TP8 官方要求,PHP 8.5.5 也完全可用)
- Composer 2.5 已正确安装并可全局调用(终端输入 composer --version 应显示 Composer version 2.5.x)
- 当前所在目录为空,不包含
composer.json或vendor/等残留文件
执行标准初始化命令
在终端中运行:
composer create-project topthink/think myapp
其中 myapp 是你想要的项目目录名,可按需修改。该命令会自动完成以下动作:
- 下载 ThinkPHP 8 最新稳定版骨架(含
app/、config/、public/、runtime/等完整结构) - 安装全部依赖到
vendor/目录 - 执行内置脚本:复制
.env.example为.env,创建runtime/目录等
如需指定 TP8 的具体小版本
例如固定安装 8.0.x 分支(避免自动升级到 8.1+),使用语义化版本约束:
composer create-project topthink/think:^8.0 myapp
注意:^8.0 允许安装 8.0.x 至 8.9.x,而 8.0.* 仅锁定 8.0.x 小版本;若要严格锁定 8.0.10,则写 8.0.10。
国内用户加速安装(必做)
若遇到卡在 Cloning into 或 GitHub rate limit 提示,立即切换镜像源:
composer config -g repo.packagist https://mirrors.aliyun.com/composer/
该配置对 Composer 2.5 生效,之后所有项目都会走阿里云源,大幅提升拉取速度。
初始化后必须检查的三件事
项目生成后不要急着访问,先验证以下配置:
-
.env 中确认
APP_DEBUG=true,否则错误将被静默吞掉 -
runtime/ 目录需对 Web 服务器用户(如
www-data或_www)可写 - Web 服务器根目录必须指向
public/子目录,而非项目根目录
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











