PHP 8.2.12中ZeroMQ扩展加载失败问题及Windows安装求助

错误原因 #

你的警告明确显示系统找不到php_zmq.dll或依赖库，大概率是扩展版本不匹配、文件未放置正确，或者php.ini配置重复导致的。

快速修复当前问题 #

1. 清理重复配置
   打开C:\xampp\php\php.ini，搜索所有包含zmq的行，你会发现重复添加了extension=zmq和extension=php_zmq.dll，只保留一行（推荐用extension=zmq，符合PHP 7+的简化写法），删掉多余的配置。

2. 检查扩展文件
   去C:\xampp\php\ext目录看看有没有php_zmq.dll，没有的话直接按下面的完整步骤重新安装。

Windows下PHP 8.2.12 ZeroMQ完整安装流程 #

1. 确认PHP环境参数 #

打开命令提示符，运行php -i，记下这三个关键信息：

• PHP版本：必须是8.2.12
• 线程安全（Thread Safety）：enabled（TS）或disabled（NTS）
• 架构：x86或x64

2. 下载匹配的扩展文件 #

• 找对应版本的php_zmq.dll，必须严格匹配上面三个参数，错一个都会加载失败
• 同时下载配套的libzmq.dll（ZeroMQ核心依赖库，一般和扩展包一起提供）

3. 放置文件到指定目录 #

• 把php_zmq.dll复制到C:\xampp\php\ext文件夹
• 把libzmq.dll复制到C:\xampp\php（PHP根目录）或者C:\Windows\System32（64位系统）/C:\Windows\SysWOW64（32位系统）

4. 配置php.ini #

在php.ini里添加一行：

extension=zmq

确保没有重复添加这行。

5. 验证安装 #

重启XAMPP的Apache服务，然后运行php -m，如果输出里有zmq，说明安装成功；也可以写个phpinfo页面，访问后搜索zmq，能找到相关配置就没问题。

注意事项 #

• XAMPP的Apache和PHP架构要一致，别一个x86一个x64
• TS和NTS版本的扩展不能混用，比如PHP是TS版，就必须下TS版的zmq扩展
• 如果还是报错，检查libzmq.dll的版本是否和php_zmq.dll兼容

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