PhpStorm 无法直接运行 Swoole 常驻服务，因其默认 CLI 模式执行即退出；需禁用 daemonize、配置 Xdebug/yasd、设置信号处理器并严格对齐本地与远程路径映射，方可支持调试与热重载。
PhpStorm 本身不能直接“运行” Swoole 常驻服务（比如 swoole_http_server 或 Coroutine\Http\Server），它只是 IDE，不接管进程生命周期；真正要做的，是让 PhpStorm 正确调用你本地或远程的 PHP 解释器，并让它以 CLI 模式启动、保持常驻，同时支持调试和热重载——这需要绕过 Web Server 模式，走纯命令行 + 进程管理路径。
为什么直接 Run Configuration 启动会闪退？
常见错误现象：php app/swoole.php 在终端能跑，在 PhpStorm 的 Run Configuration 里点运行却秒退、没报错、也没监听端口。
根本原因：PhpStorm 默认的 Run Configuration 是“执行完即退出”的 CLI 模式，而 Swoole 服务必须长期驻留。IDE 不会主动维持进程，也不会捕获 SIGINT/SIGTERM 之外的信号，导致主进程一启动就判定为“执行完毕”，立刻回收。
解决思路不是改 PhpStorm，而是改启动方式：
立即学习“PHP免费学习笔记（深入）”；
- 用
php -d daemonize=0 app/swoole.php显式禁用守护进程（Swoole 默认daemonize=1会 fork 后退出父进程，IDE 更抓不住） - 确保脚本末尾没有
exit()或提前终止逻辑 - 在 PhpStorm 中使用 “PHP Script” 类型的 Run Configuration，而非 “PHP Built-in Web Server”
- 勾选 “Run with PHP Console”（让输出可滚动、可中断）
如何配置 PhpStorm 调试常驻 Swoole 服务？
关键点：调试 ≠ 运行，调试必须让 PHP 进程挂起等待 Xdebug/yasd 连接，且不能被 IDE 自动杀掉。
实操建议：
- 确认已安装并启用
yasd（推荐）或Xdebug 3.0+，且配置了remote_enable=1、remote_host=127.0.0.1、remote_port=9003（yasd 默认是19000） - 在 Run Configuration 的 “Before launch” 里，添加 “Run External Tool”，执行
killall -9 php（仅开发机，避免端口占用冲突） - 启动参数加
-dxdebug.start_with_request=yes（Xdebug）或-dyasd.enable=1（yasd），确保协程上下文也能触发断点 - 设置 “Script path” 为你的入口文件（如
app/swoole.php），Working directory 设为项目根目录 - 不要勾选 “Single instance only”，否则改代码后无法热重启
注意：Swoole 的 Worker 进程是多进程模型，yasd/Xdebug 默认只调试主进程；若需调试 Worker 内部逻辑（如 onRequest），要在回调里手动触发 yasd_breakpoint() 或用条件断点。
怎么让 PhpStorm 支持 Ctrl+C 停止服务？
默认情况下，PhpStorm 的 Terminal 或 Run 窗口发送 Ctrl+C 并不会传给 Swoole 子进程，导致 server->shutdown() 不触发，连接未优雅关闭，端口还占着。
解决方法分两层：
- 在 Swoole 启动脚本里注册信号处理器：
swoole_process::signal(SIGINT, fn() => $server->shutdown()); - 在 PhpStorm Run Configuration 的 “Execution” 标签页中，勾选 “Allow parallel run” 并取消 “Terminate process tree”（防止 IDE 强杀子进程）
- 如果用的是宝塔或 systemd 管理的服务，别在 PhpStorm 里启停——那是生产环境的事，开发阶段就用 CLI + Ctrl+C
验证是否生效：启动后在终端敲 lsof -i :9501（假设端口 9501），Ctrl+C 后再查，应无残留。
远程服务器上调试 Swoole，路径映射必须对齐
当你用 SSH 配置远程 PHP 解释器时，PhpStorm 的断点只会打在本地代码上，但实际执行的是远程服务器上的文件。如果路径不一致，断点永远不命中。
关键操作只有两个：
- 在 “PHP → CLI Interpreter → Path mappings” 中，把本地项目路径（如
/Users/you/project）映射到远程绝对路径（如/www/wwwroot/myapp） - 确保远程服务器上
php.ini中的opcache.file_cache关闭，否则修改代码后仍执行旧 opcode
容易忽略的一点：Swoole 的 onWorkerStart 回调只在 Worker 进程启动时执行一次，改了初始化逻辑（比如数据库连接）必须彻底 kill 进程再重启，光 Ctrl+C 不够——因为 Worker 进程可能还在内存里缓存着旧对象。
