在 phpStudy 8.1.1.0 中配置 Swoole 扩展需手动匹配 DLL:先确认 PHP 版本(如 8.1.1 NTS x64)、下载对应 php_swoole.dll 放入 ext 目录,再在该版本 php.ini 末尾添加 extension=php_swoole,彻底停止并重启 Apache/PHP 服务,最后分别通过 phpinfo() 和 php --ri swoole 验证 Web 与 CLI 环境。

在 phpStudy 8.1.1.0 中配置 Swoole 扩展,核心是手动匹配 DLL 文件并正确修改对应 PHP 版本的 php.ini,不是靠面板“一键安装”就能搞定。因为 phpStudy 自带的扩展管理列表里常缺 Swoole(尤其新版),必须自己下载、放对位置、写对配置、重启到位。
确认你的 PHP 环境细节
打开 phpStudy 控制面板 → 点击右上角「其他选项菜单」→「PHP 设置」→ 查看当前启用的 PHP 版本(比如 8.1.1 NTS x64)。再点击该版本右侧的「配置文件」按钮,它会直接打开 Apache/Nginx 实际加载的 php.ini 路径(例如:D:\phpstudy_pro\Extensions\php\php81n\php.ini)。
务必记下三点:
• PHP 主版本号(8.1)
• 是否 NTS(绝大多数 phpStudy 默认是 NTS)
• 架构(x64)
下载并放置正确的 php_swoole.dll
去官方 PECL Windows 下载页(https://www.php.cn/link/948d25d346008436180931cd87fb5cf1)找匹配的 DLL:
• 选与你 PHP 版本一致的 swoole 版本(如 PHP 8.1 推荐用 swoole-5.1.x 或 6.0.x)
• 下载后解压,取出 php_swoole.dll
• 将它复制到你当前 PHP 版本的 ext 目录下(路径类似:D:\phpstudy_pro\Extensions\php\php81n\ext\)
修改 php.ini 并重启服务
用记事本或 VS Code 打开刚才确认的 php.ini 文件,在文件末尾新增一行:extension=php_swoole
注意:
• 不要加 .dll 后缀
• 不要写完整路径
• 不要加引号
保存后,回到 phpStudy 面板:
• 先点击「停止」Apache 和 PHP 服务
• 再分别点击「启动」Apache 和 PHP(必须 stop → start,点「重载配置」无效)
立即学习“PHP免费学习笔记(深入)”;
分环境验证是否生效
只看网页版 phpinfo() 不够,Swoole 常用于命令行场景:
• Web 环境:新建 info.php 放在网站根目录,内容为 <?php phpinfo(); ?>,浏览器访问后搜索 “swoole”,确认模块存在且有版本号
• CLI 环境:在命令行执行:D:\phpstudy_pro\Extensions\php\php81n\php.exe --ri swoole
如果提示 “Extension 'swoole' not present”,说明 CLI 用的是另一份 php.ini,需同步修改(可用 php --ini 查看 CLI 加载路径)



















