phpstorm点运行就退出是因为其默认run configuration采用单次脚本执行模型，而swoole websocket服务需常驻内存并进入事件循环；必须禁用daemonize、确保$server->start()为末尾语句、配置正确xdebug/yasd参数，并在回调中用yasd_breakpoint()手动触发断点。
为什么PhpStorm点运行就退出，WebSocket连不上
因为 PhpStorm 默认的 Run Configuration 是单次脚本执行模型，而 swoole_websocket_server 启动后必须进入事件循环并常驻。IDE 不会维持进程、不捕获 SIGUSR2 等信号，更不会等你前端连上来才“算执行完”——它一看到 PHP 脚本主流程结束（其实还没真结束，只是主线程交出控制权），就判定任务完成，立刻回收进程。
典型现象包括：ps aux | grep php 查不到进程、telnet 127.0.0.1 9501 直接拒绝连接、浏览器报 Connection closed before receiving a handshake response。
根本解法不是改 IDE 设置，而是让 PHP 进程真正在前台跑起来，并让 Xdebug/yasd 能稳定附着：
- 禁用守护进程：
php -d daemonize=0 server.php（Swoole 默认daemonize=1，fork 后父进程退出，IDE 更抓不住） - 确保入口文件末尾是
$server->start()，且后面**没有exit()、die()或其他终止逻辑** - 不要用
PHP Built-in Web Server类型配置——它只处理 HTTP，对 WebSocket 握手完全无效
调试配置必须设对的三个关键参数
Xdebug 或 yasd 要连上 Swoole 主进程，端口、模式、触发时机三者缺一不可。错一个，断点就永远不弹。
以 yasd（推荐，协程兼容性更好）为例，php.ini 中必须有：
-
yasd.enable=1（启用扩展） -
yasd.debug_mode=remote（远程调试模式） -
yasd.remote_host=127.0.0.1且yasd.remote_port=19000（与 PhpStorm 的Settings > PHP > Debug > DBGp Proxy端口严格一致）
在 PhpStorm 的 Run Configuration 中：
- “Script path” 指向你的
server.php - “Environment variables” 加
XDEBUG_CONFIG="idekey=PHPSTORM"（Xdebug）或留空（yasd 不依赖 idekey） - “Interpreter options” 填
-dyasd.enable=1（强制每次启动都加载 yasd） - 勾选 “Run with PHP Console”，否则输出被吞，连日志都看不到
Worker 进程里断点不生效？手动触发才是关键
Swoole 启动后分 Master、Manager、Worker 多个进程，yasd/Xdebug 默认只挂载在 Master 进程。而 onOpen、onMessage 这类回调实际运行在 Worker 进程里——所以你在这些函数里打的断点，99% 不会命中。
解决办法不是等 IDE 自动识别，而是主动干预：
- 在回调函数开头加
yasd_breakpoint();（yasd 提供的硬触发函数） - 或者用条件断点：在 PhpStorm 里右键断点 → “More” → 设置条件为
getmypid() === posix_getpid()（仅当前 Worker 进程触发） - 避免在
onStart或onWorkerStart里下断点——它们在 Manager 进程执行，和 Worker 无关
注意：yasd_breakpoint() 必须在 yasd 已加载的前提下才有效；如果提示未定义，说明 -dyasd.enable=1 没传进去，或 php.ini 配置没重载。
Ctrl+C 停不了服务？信号没透传到子进程
在 PhpStorm 终端里用 php server.php 启动后按 Ctrl+C，经常发现进程还在，lsof -i :9501 仍显示占用。这是因为 Swoole 的多进程模型中，Master 进程收到 SIGINT 后，需显式转发给 Worker，而默认不处理。
必须在代码里注册信号处理器：
$server->on('start', function ($server) {
// 拦截 Ctrl+C，优雅关闭
pcntl_signal(SIGINT, function () use ($server) {
echo "Received SIGINT, stopping...\n";
$server->shutdown();
exit(0);
});
pcntl_async_signals(true); // PHP 7.1+ 必须开启异步信号
});
同时确保 PhpStorm 的终端设置里启用了“Emulate terminal in output console”——否则信号根本进不到 PHP 进程。
这个环节最容易被忽略：没写信号处理，就只能靠 kill -9 强杀，但下次启动前还得手动 lsof -ti:9501 | xargs kill 清端口，开发节奏直接卡住。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
