根本原因是PHP CLI版本低于7.2.5或必需扩展未启用,需运行php -v和php -m | grep -E 'pdo|mbstring|json|openssl|curl|xml|ctype'确认环境,Windows用户须确保PhpStudy等工具已正确绑定CLI PHP版本并重启服务。

刚执行composer create-project topthink/think myproject就报错“Your requirements could not be resolved”,根本走不下去,问题大概率出在PHP版本上——ThinkPHP6明确要求PHP≥7.2.5,而你当前CLI环境跑的还是系统默认的PHP 7.0甚至5.6。
确认当前PHP CLI版本是否真实有效
打开终端,直接运行:
php -v
注意:不要只看浏览器里phpinfo()显示的版本,Composer读取的是命令行(CLI)环境下的PHP版本,两者常不一致。Wamp/XAMPP/PhpStudy用户尤其容易踩这个坑——界面切换了PHP版本,但终端仍调用旧路径的php.exe。
若输出是PHP 7.0.x、5.6.x或报command not found,必须立刻处理,否则后续所有操作都是徒劳。
立即学习“PHP免费学习笔记(深入)”;
Windows下快速切换CLI PHP版本(以PhpStudy为例)
方法一:通过PhpStudy面板强制绑定
打开PhpStudy → 左侧「软件管理」→ 找到「PHP」→ 点击对应高版本(如7.4.33或8.0.30)右侧的「设置为当前版本」→ 弹窗确认后,**关闭并重启PhpStudy主程序**。
方法二:手动指定PHP路径执行(绕过PATH污染)
进入PhpStudy安装目录,例如:
F:\PhpStudy\PHPTutorial\php\php-7.4.33\ → 在此目录下按住Shift+右键 → 「在此处打开Powershell窗口」→ 运行:
.\php.exe -v
看到正确版本后,再执行:
.\php.exe C:\ProgramData\ComposerSetup\bin\composer.phar create-project topthink/think myproject
这一步跳过了系统PATH干扰,确保Composer调用的就是你确认过的那个PHP版本。
Linux/macOS下修正CLI默认PHP版本
第一步:查清当前CLI实际调用路径
which php
第二步:查看可用PHP版本列表
ls /usr/bin/php*
第三步:用alternatives(CentOS/RHEL)或update-alternatives(Ubuntu/Debian)重新配置默认项:
sudo update-alternatives --config php
终端会列出所有已注册PHP版本,输入对应编号回车确认。完成后再次运行php -v验证输出是否更新。
⚠️ 注意:别只改Apache/Nginx的php.ini——Web服务器用的PHP和Composer用的CLI PHP是两套独立配置,改错地方毫无作用。
验证扩展是否真正启用
仅版本达标还不够,ThinkPHP6依赖pdo、mbstring、json、openssl、curl、xml、ctype等扩展。运行:
php -m | grep -E 'pdo|mbstring|json|openssl|curl|xml|ctype'
若任一关键词无输出,说明该扩展未被CLI环境加载。Windows用户需检查php.ini路径是否正确——执行php --ini,确认Loaded Configuration File指向的是CLI模式下的php.ini(通常在PHP安装目录根部),而非Apache模块下的那个。
Linux/macOS用户若用apt/yum/brew安装PHP,扩展常需单独安装,例如Ubuntu下:
sudo apt install php-mbstring php-xml php-curl php-zip
装完必须重启PHP-FPM或Apache服务,否则扩展不会生效。
绕过版本校验仅作临时验证(慎用)
如果确认PHP版本和扩展都已就位,但Composer仍拒绝安装,可加参数强制跳过平台检查:
composer create-project --ignore-platform-reqs "topthink/think:^6.3" myproject
这能帮你快速判断是否真为版本问题。但成功安装后必须立刻运行php think测试命令是否正常输出,若报Class not found或Fatal error,说明底层兼容性仍有缺陷,不能用于生产环境。



















