ThinkPHP新手必看:PHP版本过低安装失败解决方法
ThinkPHP6要求PHP≥7.2.5,安装失败常因CLI环境版本过低。通过php-v确认后,Windows用PhpStudy切换或手动指定路径,Linux/macOS用update-alternatives配置默认版本。还需检查pdo、mbstring等扩展,临时可用--ignore-platform-reqs绕过但需验证兼容性。
执行composer create-project topthink/think myproject后立即报错“Your requirements could not be resolved”,安装无法继续。问题大概率出在PHP版本上——ThinkPHP 6明确要求PHP≥7.2.5,而当前CLI环境运行的是系统默认的PHP 7.0甚至5.6。注意:这里说的不是浏览器中显示的PHP版本,而是命令行下Composer实际调用的那个版本。

确认当前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是两套独立配置,改错地方毫无效果。
验证扩展是否真正启用
仅版本达标还不够,ThinkPHP 6依赖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,说明底层兼容性仍有缺陷,不能用于生产环境。
