MacOS Mojave+Apache下Yii2新安装联系页报错，已启GD如何修复

嘿，我之前在MacOS Mojave上搭Yii2的时候也碰到过一模一样的问题！别着急，咱们一步步来排查修复：

第一步：确认GD扩展真的开启了FreeType支持 #

你说已经启用了GD扩展，但Yii2报错要求的是带FreeType支持的GD，光有GD还不够。咱们来验证一下：

• 在你的网站根目录新建一个info.php文件，内容写：

  <?php phpinfo(); ?>
  

• 访问这个文件（比如http://localhost/info.php），页面里搜索“GD”，找到FreeType Support这一项。如果显示的是enabled，那这一步没问题；如果是disabled或者根本没这个条目，那就是GD扩展没带FreeType支持，得先解决这个。

如果GD没FreeType支持，分两种情况处理： #

情况1：用Homebrew安装的PHP7

Homebrew装的PHP配置更灵活，咱们重新安装带FreeType的版本：

• 先卸载现有PHP（以7.4为例，换成你的实际版本）：

  brew uninstall php@7.4
  

• 重新安装并指定FreeType：

  brew install php@7.4 --with-freetype
  

• 安装完成后重启Apache：

  sudo apachectl restart
  

情况2：用系统自带的PHP7

系统自带的PHP默认GD可能没开FreeType，而且修改起来比较麻烦，我更推荐直接用Homebrew替换掉系统PHP，步骤就跟上面一样。如果不想换，那得手动编译PHP并加入FreeType支持，这个过程比较繁琐，不推荐。

第二步：检查Yii2的组件配置 #

有时候PHP扩展没问题，但Yii2没正确识别到，咱们手动指定图片处理驱动：

• 打开Yii2的Web配置文件config/web.php，找到components节点，如果没有image配置就加上：

  'components' => [
      // 其他组件...
      'image' => [
          'class' => 'yii\image\ImageDriver',
          'driver' => 'gd', // 明确指定用GD驱动
      ],
  ],
  

• 另外，联系页面大概率用到了验证码（Captcha），检查Captcha的配置，确保它用的是正确的驱动：

  'captcha' => [
      'class' => 'yii\captcha\CaptchaAction',
      'backend' => 'gd', // 指定GD作为验证码的后端
  ],
  

第三步：清理Yii2缓存 #

Yii2会缓存配置信息，有时候扩展启用了但缓存没更新，咱们手动清一下：

• 找到Yii2项目里的runtime/cache目录，删掉里面所有文件
• 如果你有命令行权限，也可以运行：

  ./yii cache/flush-all
  

第四步：重启所有相关服务 #

最后别忘了重启Apache和PHP-FPM，确保配置生效：

• 重启Apache：

  sudo apachectl restart
  

• 如果用了PHP-FPM（Homebrew装的PHP默认会开），也重启一下：

  brew services restart php@7.4
  

做完这些步骤，再访问联系页面应该就没问题了！如果还是报错，再去phpinfo里确认GD和FreeType确实都启用了，也可以检查php.ini里有没有extension=gd.so这一行（没有的话加上再重启服务）。

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