XAMPP安装Swoole扩展教程

本文详细解析了在Windows环境下为XAMPP集成Swoole扩展的关键步骤与常见陷阱，强调安装成功的核心在于严格匹配PHP版本、线程安全类型（TS/NTS）、系统架构（x86/x64）及VC编译版本，任何一项不一致都会导致扩展无法加载；文章手把手指导如何准确识别环境参数、从权威源下载正确DLL、精准配置php.ini、区分CLI与Web双环境加载机制，并提供多维度验证方法，帮你避开“明明配了却看不到swoole”的典型坑，真正实现开箱即用的高性能PHP协程能力。

确认PHP版本和TS/NTS类型是第一步

Windows下Swoole扩展必须严格匹配PHP版本、线程安全（TS/NTS）和架构（x86/x64），错一个就php -m看不到swoole，也进不了phpinfo()。别跳过这步直接下DLL。

• 打开XAMPP控制面板 → 点击Apache右侧的Config → 选PHP (php.ini)，在文件开头找PHP Version行，或直接运行C:\xampp\php\php.exe -v
• 执行C:\xampp\php\php.exe -i | findstr "Thread Safety"，输出enabled即TS，disabled即NTS
• 查系统位数：任务管理器 → 性能 → CPU → “系统类型”是x64还是x86；再看XAMPP安装目录里php\php.exe属性 → 详细信息 → “平台”字段

下载并放置正确的php_swoole.dll

PECL官网已不再提供Windows二进制包，必须从windows.php.net/pecl下载对应版本的DLL。用错源等于白装。

• 例如：XAMPP含PHP 8.1.22 NTS x64 → 下载swoole-5.1.3-8.1-nts-vc15-x64.zip（注意vc15对应VS2019编译，XAMPP 8.1默认用它）
• 解压后取php_swoole.dll，放入C:\xampp\php\ext\（不是apache\bin\，也不是php\根目录）
• 别改DLL文件名，也别加版本号后缀——extension=swoole依赖这个原始名

修改php.ini并验证加载

扩展没生效，八成卡在php.ini配置或服务未重载。XAMPP有两个php.ini：Apache用的是\xampp\apache\conf\extra\phpini.conf引入的那个，但实际编辑的是\xampp\php\php.ini（XAMPP控制面板里“Config → PHP (php.ini)”打开的就是它）。

• 用记事本或VS Code打开C:\xampp\php\php.ini，搜索;extension=swoole，去掉分号；若无此行，就在;extension=openssl这类扩展下方新增一行：extension=swoole
• 确保extension_dir指向正确路径，例如：extension_dir = "C:\xampp\php\ext"（路径里不能有中文或空格）
• 重启Apache：XAMPP控制面板中先Stop再Start，不是“Restart”——后者有时不重读php.ini
• 验证命令：C:\xampp\php\php.exe -m | findstr swoole，有输出即加载成功；C:\xampp\php\php.exe --ri swoole可看详细版本和特性开关

Swoole在XAMPP里跑不起来？检查CLI和Web环境差异

XAMPP默认只让Apache加载扩展，而php -S或命令行脚本用的是同一份php.ini，但某些旧版XAMPP会为CLI单独生成php-cli.ini。如果你写了个swoole_http_server脚本却报Class 'Swoole\Http\Server' not found，大概率是CLI没加载扩展。

• 运行C:\xampp\php\php.exe --ini，看Loaded Configuration File路径是否和你编辑的php.ini一致；若显示php-cli.ini，那就得同步改那个文件
• Windows下Swoole不支持fork模式，process_mode只能用SWOOLE_PROCESS或SWOOLE_BASE，别照Linux教程设SWOOLE_SPAWN
• phpinfo()页面里搜swoole，确认version、epoll（Windows显示select）、async_redis等关键项存在，缺失说明编译选项不对或DLL损坏

XAMPP的Swoole安装难点不在步骤多，而在每个环节都要求精确匹配——PHP版本、TS/NTS、VC运行库、php.ini作用域、CLI/Web双环境。漏掉任一环，extension=swoole就只是ini里的一行注释。

以上就是《XAMPP安装Swoole扩展教程》的详细内容，更多关于XAMPP的资料请关注golang学习网公众号！