ThinkPHP 7.0 安装失败主因是PHP版本低于8.0、关键扩展缺失或镜像未切至阿里云;必须用composer create-project命令安装并删除vendor和composer.lock后重试,且public/index.php须正确引入autoload.php。

ThinkPHP 7.0 安装失败,90%不是命令写错了,而是 PHP 版本、扩展或镜像没对上。 直接用 composer create-project topthink/think 跑不通,说明环境卡点在底层——得一层层验。
PHP 版本和扩展必须达标(TP7 要求 PHP ≥ 8.0)
TP7 是纯 PHP 8+ 架构,不兼容 7.x。哪怕只差小数点(比如 7.4.33),create-project 也会静默失败或报 Your requirements could not be resolved。
- 运行
php -v,确认输出是PHP 8.0.2或更高(推荐 8.1+) - 运行
php -m | grep -E "(json|mbstring|xml|curl|openssl|phar|zlib|pdo)"(Linux/macOS),缺任一模块都会导致 autoload 失效或 Class not found - Windows 用户务必执行
php --ini,看 CLI 加载的是哪个php.ini—— 别只改了 Apache 的配置却用命令行跑
必须用 create-project,不能 require
composer require topthink/think 只往 vendor/ 里扔框架代码,不会生成 app/、public/、config/ 等目录结构。后续访问 public/index.php 必然报 Class 'think\App' not found。
- 正确命令:
composer create-project topthink/think tp7 - 如果提示
Could not find package topthink/think,说明镜像没切成功,不是包不存在 - 别加
--prefer-source或--dev,TP7 的稳定版不需要这些参数
镜像必须切阿里云,且要验证生效
packagist.org 在国内基本不可用,Connection refused 或 503 Service Unavailable 都是典型镜像失效表现。
立即学习“PHP免费学习笔记(深入)”;
- 全局设置:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效:
composer config -g repo.packagist输出应为该 URL,不是https://packagist.org - 若仍失败,临时加镜像参数重试:
composer create-project topthink/think tp7 --repository=https://mirrors.aliyun.com/composer/ - 别用 Laravel China 镜像——它已停止维护,2026 年起无法同步 TP7 新版本
装完跑不起来?先盯住 autoload 和入口路径
安装成功 ≠ 能访问。TP7 启动失败最常卡在自动加载链断裂。
- 打开
public/index.php,第一行必须是:require __DIR__ . '/../vendor/autoload.php';—— 少一个点、多一个斜杠、路径写成./vendor/...全都无效 - 命令行进项目根目录,运行
php think:能输出命令列表说明autoload.php加载正常;报错则说明 vendor 没生成或路径错 - 浏览器访问地址必须是
http://localhost:8000/public/index.php(或配好虚拟主机指向public/),绝不能是根目录下的index.php
真正容易被忽略的是:TP7 的 composer.json 里默认启用了 minimum-stability: stable,如果本地 composer.lock 残留了旧版依赖(比如从 TP6 项目复制过来的),create-project 会复用它并卡死在解析阶段——所以每次重试前,删干净当前目录下的 vendor/ 和 composer.lock 是硬性动作。



















