XAMPP多端口部署Swoole教程

本文深入解析了在XAMPP环境下无法直接通过Apache运行Swoole WebSocket的根本原因——Swoole是独立常驻的TCP服务进程，与仅处理HTTP/HTTPS的Apache天然隔离，二者必须分端口并行（如Apache用80，Swoole用9501），而非强行整合；文章手把手指导如何确认Swoole扩展正确加载、选择安全端口、编写多协议监听脚本、使用XAMPP自带PHP启动服务，并揭露了phpinfo()显示正常但php -m不显示等典型环境陷阱，帮你避开路径错位、ABI不匹配、防火墙拦截等隐形坑，真正实现Apache网页服务与Swoole长连接服务稳定共存。

为什么不能直接用XAMPP的Apache跑Swoole WebSocket

因为Swoole是独立于Apache/Nginx的常驻进程服务，它自己监听TCP端口（比如9501），不走HTTP服务器转发。XAMPP自带的Apache只处理HTTP/HTTPS请求，对WebSocket协议（ws://或wss://）完全无感知——你往localhost:80发WebSocket连接，Apache会直接返回400或拒绝，根本不会交给Swoole。

常见错误现象：WebSocket connection to 'ws://localhost:80' failed: Error in connection establishment: net::ERR_CONNECTION_REFUSED，本质就是端口没开、服务没起、协议不匹配。

• Apache和Swoole是两个进程，不能共用同一个端口（比如都占80）
• Swoole必须用php命令行启动，不是靠浏览器访问PHP文件触发
• XAMPP的“重启Apache”按钮对Swoole无效，它只管httpd.exe

如何在XAMPP机器上同时运行Apache和Swoole多端口服务

关键不是“配置XAMPP支持Swoole”，而是让两者**并存不冲突**：Apache继续管80（或8080）做Web页面，Swoole单独监听另一个端口（如9501、9502）做长连接服务。

实操要点：

• 确认XAMPP中PHP已启用Swoole扩展：运行/xampp/php/php.exe -m | findstr swoole（Windows）或/Applications/XAMPP/xamppfiles/bin/php -m | grep swoole（macOS），必须看到swoole
• 选一个未被占用的端口，避开80、443、3306、8080等XAMPP常用端口，推荐9501、9502、1215
• 写好Swoole服务脚本（如ws_server.php），绑定0.0.0.0:9501而非127.0.0.1:9501，否则外部设备连不上
• 用XAMPP自带的PHP执行（不是系统PHP）：Windows下用C:\xampp\php\php.exe ws_server.php，macOS下用/Applications/XAMPP/xamppfiles/bin/php ws_server.php
• 防火墙要放行该端口；Windows Defender或Mac防火墙默认会拦截非HTTP端口的入站连接

多个Swoole服务怎么分端口、分协议共存

一个Swoole进程可通过addlistener()添加多个端口监听，每个端口可配不同协议（HTTP / WebSocket / TCP / UDP），无需启多个PHP进程。

例如一个文件同时提供WebSocket聊天 + HTTP API + 自定义TCP协议：

$server = new Swoole\Http\Server('0.0.0.0', 9501);
$server->addlistener('0.0.0.0', 9502, SWOOLE_SOCK_TCP); // 纯TCP
$server->addlistener('0.0.0.0', 9503, SWOOLE_SOCK_UDP); // UDP
$server->on('request', function ($req, $res) {
    $res->end('HTTP API OK');
});
$server->on('message', function ($server, $frame) {
    $server->push($frame->fd, 'WS echo: ' . $frame->data);
});
$server->start();

注意点：

• UDP监听不能用Swoole\WebSocket\Server，必须用Swoole\Server或Swoole\Http\Server再addlistener
• 所有监听端口必须在启动前注册，运行中不能动态增删
• 如果用Swoole\WebSocket\Server，它底层是Http\Server，所以addlistener加的TCP端口无法自动升级WebSocket握手，需手动处理
• 端口权限：Windows/macOS普通用户可绑>1024端口；Linux下若想绑80，得加sudo或改cap（不推荐）

为什么phpinfo()显示swoole但php -m不显示

这是XAMPP环境最典型的路径错位问题：你在浏览器里看phpinfo()，调用的是XAMPP Apache模块里的PHP；但终端敲php -m，很可能调用的是系统PATH里的PHP（比如macOS自带的/usr/bin/php或Homebrew装的PHP）。

验证方式：

• Windows：where php 看输出是不是C:\xampp\php\php.exe
• macOS：which php 和 /Applications/XAMPP/xamppfiles/bin/php -m | grep swoole 对比
• 统一用绝对路径调用XAMPP的PHP，避免混淆
• 修改系统PATH把XAMPP的bin目录置顶（Windows加到系统变量，macOS加到~/.zshrc的export PATH="/Applications/XAMPP/xamppfiles/bin:$PATH"）

真正容易被忽略的是：Swoole扩展.so文件路径、PHP版本ABI（如no-debug-non-zts-20200930）必须和XAMPP当前PHP严格匹配，差一个字符就加载失败，且无报错——只默默不生效。

理论要掌握，实操不能落！以上关于《XAMPP多端口部署Swoole教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！