phpStudy安装Swoole必须手动匹配DLL：先查PHP版本、TS/NTS及架构，再下载对应php_swoole.dll放入ext目录，编辑对应php.ini添加extension=php_swoole，最后分别验证CLI和Web环境。
可行，但必须用 DLL 手动匹配，不能靠“一键安装”或 PECL。
phpStudy 的 swoole 扩展本质是预编译 DLL
phpStudy（旧称 phpEnv）自带的 PHP 是 Windows 编译版，不支持源码编译扩展。Swoole 官方从不提供 Windows 原生扩展，所有 Windows 下的 swoole 都是第三方（主要是小皮团队）基于特定 PHP 版本打包的 php_swoole.dll。这意味着：
- 你不能运行
pecl install swoole—— 会报错“command not found”或“no build environment” - 面板里搜不到
swoole，大概率是因为当前 PHP 版本 + TS/NTS + 架构（x86/x64）组合没有对应 DLL - 即使下载了 DLL，放错
ext目录或改错php.ini，也会静默失效（php -m不显示、phpinfo()不出现模块）
手动装 DLL 的三步关键动作
绕过面板，直接控制加载路径和配置，成功率最高。操作前先确认你的 PHP 环境信息（打开 phpinfo 页面看 PHP Version、Thread Safety、Architecture）：
- 去 PECL 官网 或小皮镜像页，找和你环境**完全一致**的 DLL：例如
PHP 8.1 NTS VC15 x64→ 对应文件名通常是php_swoole-5.1.3-8.1-nts-vc15-x64.dll - 把
php_swoole.dll放进对应 PHP 版本的ext目录，路径类似：D:\phpstudy_pro\Extensions\php\php81n\ext\（注意不是系统级ext，也不是 Apache 的） - 编辑该 PHP 版本实际生效的
php.ini（用php --ini查 Loaded Configuration File），在末尾加一行：extension=php_swoole（Windows 下不写.dll，也不写路径）
验证必须分 CLI 和 Web 两套环境
phpStudy 同时跑 Apache/Nginx（Web SAPI）和命令行（CLI SAPI），它们用的是**不同 php.ini**，且扩展加载互不影响：
立即学习“PHP免费学习笔记（深入）”；
- Web 端验证：刷新 phpinfo 页面，搜索
swoole，有模块信息才算 Web 加载成功 - CLI 端验证：在终端执行
php --ri swoole或php -m | findstr swoole，没输出就说明 CLI 没启——此时要检查php --ini输出的配置文件是否和 Web 的那个一样 - 常见坑：
php -v显示的是系统 PATH 里的 PHP，不是 phpStudy 自带的；务必用完整路径调用，比如D:\phpstudy_pro\Extensions\php\php81n\php.exe --ri swoole
为什么装完还是不生效？重点查这三点
90% 的失败不是因为“不能装”，而是版本或路径错配：
-
PHP Warning: PHP Startup: Unable to load dynamic library 'swoole'：DLL 文件名写错了（比如写了extension=swoole而不是extension=php_swoole），或 DLL 本身不兼容（VC 版本、架构不匹配） - phpinfo 有 swoole 但
php -m没：CLI 和 Web 用了不同php.ini，CLI 的那份没加extension=php_swoole - 扩展加载了但
swoole_version()报错或功能异常：phpStudy 自带 PHP 默认禁用sockets扩展，而 Swoole 强依赖它——必须在同一个php.ini里确保extension=sockets在extension=php_swoole前面启用
真正麻烦的不是步骤多，而是每个环节都卡在细节上：VC 版本对不上、NTS/TS 搞反、CLI 和 Web 的 php.ini 分不清、sockets 扩展被忽略。动手前花两分钟看清楚 phpinfo 里的三行关键字段，比反复重启服务有用得多。
