当你执行composer create-project topthink/think myproject后,立即遇到“Your requirements could not be resolved”错误,导致安装流程彻底中断,问题根源几乎可以锁定在PHP版本上。ThinkPHP6明确要求PHP版本必须≥7.2.5,但你的命令行(CLI)环境中极可能仍在运行系统默认的PHP 7.0甚至5.6——请特别注意,这里并不是浏览器内phpinfo()显示的那个版本,而是Composer实际调用的CLI PHP版本。

确认当前PHP CLI版本是否真实有效
打开终端,直接运行:php -v
切记:不要仅凭浏览器中的phpinfo()显示的高版本就掉以轻心,Composer读取的是命令行(CLI)环境下的PHP版本,二者往往完全不同。使用Wamp、XAMPP或PhpStudy的用户尤其容易踩入这个陷阱——在图形界面切换了PHP版本,但终端依然调用旧路径的php.exe。
如果输出的结果是PHP 7.0.x、5.6.x或者直接提示command not found,那就必须立即解决,否则后续所有操作都是徒劳。
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,说明底层兼容性仍有隐患,不能用于生产环境。
