必须用composer create-project创建完整项目骨架,禁用require:后者仅装空包致class not found;需验证public/index.php、vendor/autoload.php存在,runtime可写,且php think version能正常输出版本号。

ThinkPHP6 必须通过 Composer 安装,不能手动下载 ZIP 或用 Git 克隆。核心原则只有一条:用 composer create-project 创建完整项目骨架,绝不能用 composer require topthink/think —— 后者只会装一个空包,必然报错。
安装 Composer 工具本身
Composer 是 PHP 的依赖管理工具,必须先装好才能安装 TP6:
- Windows 用户:直接去 官网下载 Composer-Setup.exe,双击安装,按向导选择 PHP 路径(如用 phpstudy、XAMPP、Wamp,就指向其 bin/php 目录)
-
macOS / Linux 用户:终端执行三行命令(逐行复制运行):
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer -v
最后一行能显示版本号,说明安装成功
配置国内镜像加速(强烈建议)
默认走国外源极慢,甚至超时失败。执行以下任一命令设为国内镜像:
- 阿里云镜像(推荐):composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 腾讯云或 Laravel China 镜像(备选):composer config -g repo.packagist composer https://packagist.laravel-china.org
设置后可运行 composer config -g repo.packagist 确认是否生效。
用 create-project 创建 TP6 项目
进入你打算放项目的目录(比如 D:\www 或 ~/Sites),确保该目录为空,然后运行:
- 装最新稳定版:composer create-project topthink/think myapp
- 装指定版本(如 v6.1.8):composer create-project "topthink/think:^6.1" myapp(注意双引号,防止 shell 解析 ^)
- 网络卡顿加 --prefer-dist 强制用压缩包:composer create-project topthink/think tp6 --prefer-dist
执行完会自动生成完整结构:app/、public/、runtime/、think 命令脚本等——这才是 TP6 能跑起来的基础。
安装后必须验证的三件事
进项目根目录(如 cd myapp),立刻检查:
- public/index.php 和 vendor/autoload.php 是否存在?缺一个就说明安装中断或镜像损坏,可先运行 composer clear-cache 再重试
- runtime/ 目录是否可写?Linux/macOS 执行 chmod -R 755 runtime;Windows 下确认 IIS 或 PHP-CGI 进程用户有写权限
- 运行 php think version,输出应为类似 v6.1.8。若报 “Command not found” 或 “Class 'think\App' not found”,基本可断定误用了 require 而非 create-project
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











