Windows下PHP8.1.4+Laravel9提示GD Library扩展不可用求助

问题对应环境 #

• 报错信息：GD Library extension not available with this PHP installation
• 系统：Windows
• 版本栈：PHP 8.1.4、Laravel v9、XAMPP v3.3.0
• 已尝试操作：修改php.ini移除;extension=gd前的注释符，重启后报错未消失

排查修复步骤 #

• 确认修改的是正确的配置文件
  XAMPP目录内存在多份php.ini副本，手动找目录改文件很容易改错。正确操作是打开XAMPP控制面板，找到Apache行的Config按钮，下拉选择PHP (php.ini)打开编辑，这个文件才是Apache运行PHP时实际加载的配置。

  校验方法：在XAMPP的htdocs目录下新建phpinfo.php，写入代码<?php phpinfo();，浏览器访问该文件，查看Loaded Configuration File项显示的路径，确保你编辑的ini文件和该路径完全一致。

• 校验扩展文件与配置项正确性
  1. 打开XAMPP安装目录下的php/ext文件夹，确认目录内存在php_gd.dll文件，文件缺失的话补入对应PHP8.1.4版本的同名dll即可。
  2. 注意PHP 8.0+版本GD扩展的配置项就是extension=gd，对应dll为php_gd.dll，不要按照旧教程配置extension=gd2，该配置在PHP8版本已被移除，会直接导致扩展加载失败。
• 检查扩展目录配置
  在正确的php.ini文件中搜索extension_dir，Windows环境下需要配置为你本地XAMPP中php扩展目录的绝对路径，默认配置参考：

  extension_dir = "C:\xampp\php\ext"
  

  如果你自定义过XAMPP安装路径，把路径替换为实际的php/ext目录绝对路径即可，不要用相对路径，避免PHP找不到扩展目录。
• 补全运行依赖
  PHP 8.1在Windows环境下运行需要VC15（对应Visual Studio 2019/2022）运行库支持，系统缺失该运行库时GD扩展会静默加载失败，安装对应版本的VC运行库后重启系统即可。
• 正确重启服务
  修改配置后不要只刷新网页，要在XAMPP控制面板中先停止Apache服务，等服务完全退出后再重新启动，必要时可以右键以管理员身份运行XAMPP再启动服务，避免权限不足导致配置加载失败。
• 校验CLI环境配置（可选）
  如果你需要用artisan命令执行涉及GD库的操作（比如命令行处理图片、生成验证码等），需要额外校验CLI模式下的PHP配置：打开cmd执行php --ini查看CLI模式加载的php.ini路径，按照前面的步骤同样开启GD扩展，执行php -m确认输出列表里存在gd项即可。
• 最终验证
  重启服务后刷新phpinfo.php页面，搜索gd模块，看到GD Support显示为enabled即代表扩展加载成功，回到Laravel项目刷新页面报错就会消失。

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