phpEnv下安装Swoole必须手动匹配DLL：根据php -v、php --ri openssl确认PHP版本、TS/NTS及架构，下载对应php_swoole.dll放入ext目录，在CLI和Web端php.ini中均添加extension=php_swoole.dll并彻底重启服务，最后用php --ri swoole或测试代码验证。
phpEnv 环境下装 swoole 没有“一键点击安装”的简单方法——所有声称“自动匹配版本+自动配置”的工具，在 Windows 的 phpEnv 里都不可靠。你必须手动完成三件事：找对 DLL、放对目录、改对 php.ini，否则必然失败。
为什么 pecl install swoole 在 Windows 上根本跑不起来
Windows 缺少 phpize 和编译链（gcc、make、autoconf），pecl install 会直接报错：Command 'phpize' not found 或 sh: make: command not found。这不是权限或路径问题，是平台能力缺失。你不能绕过 DLL 手动匹配这一步。
怎么快速找到正确的 php_swoole.dll
别去 PECL 官网翻旧包，直接用这个地址下载预编译 DLL：Swoole 官方 Windows 二进制发布页。关键看三项：
- 运行
php -v确认主版本（如8.2.12→ 选8.2） - 运行
php --ri openssl查Thread Safety：显示enabled就是ts，disabled是nts - 查
Architecture（x64 还是 x86），通常都是x64
例如 PHP 8.2 TS VC17 x64 → 下载 swoole-5.1.3-8.2-ts-vs17-x64.zip，解压后只取 php_swoole.dll。
为什么 extension=swoole 一定不生效
Windows 下 Swoole 官方 DLL 文件名固定为 php_swoole.dll，不是 swoole.dll。写 extension=swoole 会导致 PHP 报错：PHP Warning: Unable to load dynamic library 'swoole'。
立即学习“PHP免费学习笔记（深入）”；
必须写成：
extension=php_swoole.dll
而且要确认两处 php.ini 都改了：
-
php --ini显示的Loaded Configuration File（CLI 环境） - Web 服务（Apache/Nginx）实际加载的
php.ini，路径常在C:\phpenv\php\php-8.2.12-ts\php.ini或类似位置，不是 CLI 那个
常见坑：改了 CLI 的 php.ini，但 Apache 仍读旧版，导致 phpinfo() 里看不到模块。
验证时别只信 php -m
php -m | findstr swoole 只反映 CLI 环境；Web 端是否生效，必须打开 phpinfo() 页面搜索 “swoole” 区块。更稳妥的做法是跑一行测试代码：
<?php var_dump(extension_loaded('swoole'));
输出 bool(true) 才算真正就位。如果返回 false，优先检查 php --ini 和 Web 服务器绑定的 php.ini 是否是同一个文件——这是最常被跳过的环节。
