Win10 XAMPP下Laravel8用Imagick生成PNG二维码提示未装扩展

问题状态 #

触发报错：You need to install the imagick extension to use this back end
运行环境：Windows 10 + XAMPP(Apache) + Laravel 8 + simple-qrcode扩展包
触发场景：Blade模板中调用QrCode::format('png')生成base64格式PNG二维码时抛出异常

触发代码 #

<div class="modal-body">
    <div class="container" style="text-align: center;">
        <!-- generate function from simple-qr code package -->
        <!-- {{!! QrCode::size(250)->generate($row->link); !!}} -->
        <img src="data:image/png;base64, {!! base64_encode(QrCode::format('png')->size(100)->generate($row->link)) !!} "> 
    </div>
    <div class="codesource-link" style="text-align: center;">
        <a href="https://codesource.io/">Download</a>
    </div>
</div>

参考配置截图 #

#

分步排查&解决方案 #

XAMPP环境下Imagick安装后仍无法识别，基本都是版本不匹配、加载路径错误、Web/CLI环境配置不一致导致，按以下顺序逐一验证：

• 验证双环境扩展加载状态
  多数安装失败的核心原因是混淆了Apache Web运行环境和PHP CLI运行环境的配置文件：
  1. 在XAMPP的htdocs目录新建phpinfo.php，写入<?php phpinfo();，浏览器访问该文件，记录Loaded Configuration File的具体路径，搜索Imagick项确认是否正常加载，同时记录PHP版本、架构（x86/x64）、线程安全状态（TS/NTS）、编译器版本（VC15/VS16等参数）。
  2. 打开命令行进入XAMPP的PHP目录（默认路径C:\xampp\php），执行php -m查看已加载扩展列表，如果列表中没有imagick，说明CLI环境未加载扩展——如果使用php artisan serve启动Laravel项目，走的是CLI环境的PHP配置，和Apache加载的php.ini不是同一个文件，两个配置文件都需要添加Imagick扩展配置。
• 核对Imagick版本匹配规则
  Windows环境下Imagick扩展必须严格匹配所有参数，任意一项不匹配都会导致加载失败：
  • PHP主版本完全一致（如PHP 7.4不能使用适配PHP 8.0的扩展包）
  • 架构匹配：x64/x86和phpinfo中显示的PHP架构一致，和操作系统位数无关
  • 线程安全匹配：phpinfo中Thread Safety显示为enabled则选TS版本扩展，disabled则选NTS版本
  • 编译器版本匹配：扩展包的编译器版本和phpinfo中Compiler项显示的版本完全一致
    注意：除了将php_imagick.dll放到PHP的ext目录外，还需要将对应版本ImageMagick依赖包内所有CORE_RL_*.dll文件，分别复制到C:\xampp\apache\bin和C:\xampp\php目录下，缺失这步会导致扩展无法正常加载。
• 检查配置项正确性
  打开对应php.ini文件，确认扩展配置项为extension=imagick（PHP7.4+版本不需要写.dll后缀），同时确认extension_dir配置为PHP目录下ext文件夹的绝对路径，例如extension_dir = "C:\xampp\php\ext"。
  修改配置后必须重启Apache服务；如果使用artisan serve启动项目，需要终止进程后重新启动才会加载新配置。
• 清除Laravel缓存
  确认扩展加载成功后，在项目根目录执行以下命令清除缓存：

  php artisan config:clear
  php artisan cache:clear
  php artisan view:clear
  

• 零配置替代方案
  如果多次调试Imagick仍无法正常加载，可以直接切换QrCode扩展的图像驱动为GD，GD扩展是XAMPP默认开启的，不需要额外安装：
  1. 执行php artisan vendor:publish --provider="SimpleSoftwareIO\QrCode\QrCodeServiceProvider"发布配置文件
  2. 打开config/qrcode.php，将driver参数的值从imagick改为gd即可正常生成PNG格式二维码。

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