PHP正确执行WebSocket服务器的方法 解决shell_exec执行脚本挂起问题

• 原写法的&后台标记没有实现真正的进程脱离：PHP通过shell派生的Web进程，会持续等待子进程的标准输入、输出、错误流全部关闭才会返回。原命令只重定向了标准输出，没有处理标准错误和标准输入的关联，就算加了&，shell_exec/exec也会一直挂起等待流断开，出现卡死。
• 相对路径的路径解析偏差：Web运行环境的工作目录和手动CLI执行的目录不一致，../bin/server.php很容易定位错误，但因为进程没脱离，错误信息也没法返回给调用方，表现也是调用行卡住无响应。
• 权限不匹配：Web进程的运行用户（如www-data、apache）对服务端脚本、日志文件目录没有足够的读、写、执行权限，进程启动失败但连接没断开，同样表现为卡壳。

核心逻辑是从三个层面切断WebSocket服务进程和当前Web调用进程的关联：完全脱离父进程会话、重定向全部三类流到独立文件、使用绝对路径避免解析错误。
可直接复用的代码示例：

// 全部替换为实际的绝对路径，禁止使用相对路径
$absoluteScriptPath = '/your/project/path/bin/server.php';
$absoluteLogPath = '/your/project/path/runtime/chat_logs.txt';
$phpBinaryPath = '/usr/bin/php'; // 可通过which php命令拿到绝对路径，避免找不到php命令

// 构建安全的执行命令
$command = sprintf(
    'setsid %s %s > %s 2>&1 < /dev/null &',
    escapeshellarg($phpBinaryPath),
    escapeshellarg($absoluteScriptPath),
    escapeshellarg($absoluteLogPath)
);

// 执行后会立刻返回，不会出现卡壳
shell_exec($command);

关键配置说明：

• 用setsid替代单纯的&：让WebSocket进程创建独立的新会话，彻底脱离当前Web进程的进程组管控，就算后续Web服务重启、进程退出，WebSocket服务也不会被连带终止。
• 全量重定向流：把标准输入指向/dev/null，标准输出和标准错误统一重定向到日志文件，彻底断开进程和当前调用shell的管道连接，从根源上避免调用方等待流关闭的卡壳问题。
• 用escapeshellarg包裹所有路径参数：避免路径中的空格、特殊字符导致命令解析错误，同时杜绝shell注入风险。

• 不要把Web接口启动的方式作为长期运行方案：该方式仅适合临时调试启动，生产环境建议用systemd、supervisor等进程管理工具托管WebSocket服务，实现进程异常退出自动拉起、开机自启的能力，避免Web服务重启连带中断WebSocket服务。
• 提前校验函数权限：确认当前PHP环境没有在disable_functions配置中禁用shell_exec、exec等相关函数，否则会出现无权限调用的问题。
• 不要在启动命令中附加额外的输出逻辑：比如附带echo $!获取进程ID的操作，会额外增加shell交互的环节，反而可能重新触发等待卡壳的问题。
• Windows环境适配：如果运行环境是Windows，上述Linux命令不适用，可改用start /B "" "C:\php\php.exe" "C:\project\bin\server.php" > "C:\project\chat_logs.txt"的语法启动后台进程。

内容的提问来源于stack exchange，提问作者halocedark