本地搭建CakePHP项目遇Composer安装错误及PHP模块问题求助

1. 先解决PHP版本/模块API不匹配的核心问题 #

模块API版本不匹配说明系统里同时存在多个PHP环境（XAMPP自带的+单独安装的），导致命令行调用的PHP和XAMPP的PHP版本不一致，加载了错误版本的扩展模块：

• 打开系统环境变量（Win+R输入sysdm.cpl→高级→环境变量），在系统变量的PATH里，删除单独安装的PHP路径，只保留XAMPP自带的PHP路径（比如C:\xampp\php），并确保这个路径在最前面
• 打开命令提示符，执行php -v，确认输出的PHP版本和XAMPP安装的版本一致（比如XAMPP装的是PHP 8.1，输出应该是8.1.x，对应API版本20210902）

2. 正确配置XAMPP的PHP.ini #

只修改XAMPP目录下的php.ini（路径一般是C:\xampp\php\php.ini），不要碰其他PHP的配置文件：

• 取消extension=openssl的注释，同时确保extension_dir配置正确：

  extension_dir = "ext"
  # 或者用绝对路径更稳妥：
  extension_dir = "C:/xampp/php/ext"
  

• 配置SSL证书路径，避免后续SSL连接出错：

  openssl.cafile = "C:/xampp/php/extras/ssl/cacert.pem"
  

• 保存php.ini后，重启XAMPP的Apache服务

3. 用XAMPP的PHP执行Composer #

直接指定XAMPP的PHP来运行composer，避免调用错PHP版本：

C:\xampp\php\php.exe composer.phar install

如果之前尝试过disable-tls，记得把composer配置改回来（删除disable-tls=true），因为启用TLS更安全

4. 修复扩展模块加载失败 #

• 检查XAMPP的php/ext目录，确保php_bz2.dll、php_curl.dll、php_openssl.dll等文件存在，且是XAMPP自带的版本（不要替换成其他PHP版本的模块）
• 执行php -m命令，查看输出列表里是否包含openssl、curl等模块，确认扩展已正常加载

5. 验证环境有效性 #

执行以下命令验证openssl配置：

php -r "var_dump(openssl_get_cert_locations());"

如果输出正常显示证书路径，说明openssl扩展已正确配置

内容的提问来源于stack exchange，提问作者Shubham Upadhyay