XAMPP环境下多端口部署Swoole应用-php教程-PHP中文网

xampp的apache无法直接运行swoole websocket，因为swoole是独立常驻进程、自行监听tcp端口（如9501），不依赖apache/nginx转发；apache仅处理http/https请求，对websocket协议（ws://）无感知，且两者不能共用同一端口，必须分端口并存（如apache用80，swoole用9501）。

xampp环境下多端口部署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进程。

Swoole 6.1.1

Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 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"）