phpstudy pro配置swoole扩展需四步:一查php版本、ts/nts及架构;二下匹配dll放ext目录;三在php.ini末尾加extension=php_swoole;四停止再启动服务,用php -m | findstr swoole及php --ri swoole验证。

PHPStudy Pro(即原phpEnv)本身不自带Swoole扩展,也不能通过界面一键安装所有版本的Swoole——它只在“扩展管理”中提供部分预编译好的DLL,且严格绑定PHP版本、线程安全模式(TS/NTS)和系统架构(x86/x64)。开启失败,绝大多数是因为版本没对上,或配置未生效。
确认当前PHP环境信息
这是最关键的一步,跳过就容易白忙活:
- 打开PHPStudy Pro → 选中你正在用的PHP版本 → 点击「配置」→ 查看phpinfo()页面
- 记下三项核心信息:PHP版本(如8.0.30)、Thread Safety(显示enabled=TS,disabled=NTS)、Architecture(x64或x86)
- 同时执行命令:
php --ini,确认CLI模式下加载的是哪份php.ini(路径通常类似:D:\phpstudy_pro\Extensions\php\php80n\php.ini)
下载并放置正确的php_swoole.dll
别直接搜“swoole.dll”,必须按环境精准匹配:
- 访问官方PECL镜像或可信源(如pecl.php.net/package/swoole),找到对应版本的Windows DLL包
例如:PHP 8.0 NTS VC15 x64 → 下载php_swoole-5.0.3-8.0-nts-vc15-x64.zip - 解压出
php_swoole.dll,放入该PHP版本的ext目录(路径示例:D:\phpstudy_pro\Extensions\php\php80n\ext\) - 确保文件名是
php_swoole.dll(不是swoole.dll,也不是带版本号的其他名字)
修改php.ini并重启服务
改错ini文件或只点“重载配置”是常见失效原因:
- 编辑你刚才确认过的那份php.ini(Web和CLI可能不同,建议两份都加,或至少确保当前运行环境所用的那一份)
- 在文件末尾添加一行:
extension=php_swoole(Windows下不写.dll后缀,也不写路径) - 保存后,在PHPStudy Pro中:先【停止】Apache/Nginx → 再【启动】(不能只点“重载配置”)
验证是否真正生效
别只信phpinfo页面,要分场景验证:
- Web环境:刷新phpinfo()页面,搜索“swoole”,看到模块信息即表示Web SAPI加载成功
-
CLI环境:命令行执行
php -m | findstr swoole(Windows)或php -m | grep swoole(WSL),有输出才算CLI可用 - 进阶验证:
php --ri swoole,能打印出版本、协程支持等详情才说明完全就绪
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











