PHP内置服务器中GD已加载但无法使用的问题求助

排查步骤与解决方法 #

1. 确认CLI与内置服务器使用的PHP.ini一致 #

Laravel内置服务器依赖PHP CLI环境，运行以下命令查看CLI加载的PHP.ini路径：

php --ini

对比输出中的Loaded Configuration File路径是否为你修改过的c:\xampp\php\php.ini。如果不一致，说明你修改的是Apache用的PHP.ini，而CLI用的是另一个文件（比如php.ini-development或php.ini-production），需要同步修改对应文件的extension=gd配置。

2. 检查PHP扩展目录配置 #

打开目标PHP.ini文件，确认extension_dir配置正确：

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

确保路径为绝对路径且拼写无误，避免因相对路径解析错误导致扩展无法加载。

3. 验证系统PATH与GD依赖库 #

GD扩展依赖libpng.dll、libjpeg.dll等系统库，这些文件位于C:\xampp\php目录下：

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在系统变量的PATH中添加C:\xampp\php
• 重启命令提示符和php artisan serve，确保CLI能找到依赖库

4. 直接验证内置服务器的GD加载状态 #

在Laravel项目中新增路由，直接输出内置服务器的PHP扩展状态：

// routes/web.php
Route::get('/check-gd', function () {
    var_dump(extension_loaded('gd'));
    if (extension_loaded('gd')) {
        var_dump(gd_info());
    }
});

访问http://localhost:8000/check-gd，查看是否返回bool(true)及GD详细信息，以此确认内置服务器环境下GD是否真的加载成功。

5. 排查Intervention配置问题 #

• 确认config/image.php中driver设置为gd：

  'driver' => env('IMAGE_DRIVER', 'gd'),
  

• 清除配置缓存：

  php artisan config:clear
  

6. 替换GD扩展文件 #

若上述步骤无效，可能是php_gd.dll文件损坏：

• 从PHP官方下载**对应版本（PHP 8.1.6，线程安全版）**的GD扩展
• 替换C:\xampp\php\ext目录下的php_gd.dll文件
• 重启内置服务器后再次测试

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