首先集成Swoole扩展实现WebSocket服务器，再通过Laravel WebSockets包或Ratchet库在框架中构建实时通信，最后配置Nginx反向代理支持协议升级，完成PHP的WebSocket全链路搭建。
如果您希望在PHP框架中实现实时通信功能，但传统的HTTP请求无法满足低延迟的双向数据交互需求，则可以考虑集成WebSocket协议。以下是实现PHP框架WebSocket通信的具体步骤：
本文运行环境：Dell XPS 13，Ubuntu 24.04
一、使用Swoole扩展搭建WebSocket服务器
Swoole是一个高性能的PHP扩展，支持异步编程和WebSocket协议，可以直接在PHP中创建WebSocket服务器。
1、通过PECL安装Swoole扩展：pecl install swoole。
立即学习“PHP免费学习笔记（深入）”；
2、在php.ini文件中启用Swoole扩展：extension=swoole。
3、创建一个WebSocket服务器脚本，例如server.php，代码如下：
实例化SwooleWebSocketServer对象，监听指定IP和端口。
4、为on('open')事件绑定回调函数，用于处理客户端连接。
5、为on('message')事件绑定回调函数，用于接收并响应客户端发送的数据。
6、为on('close')事件绑定回调函数，用于处理连接关闭逻辑。
7、调用start()方法启动服务器。
二、在Laravel框架中集成WebSockets
Laravel本身不原生支持WebSocket，但可通过Laravel WebSockets包实现兼容Pusher协议的WebSocket服务。
1、使用Composer安装laravel-websockets包：composer require beyondcode/laravel-websockets。
2、发布配置文件：php artisan vendor:publish --provider="BeyondCode\LaravelWebSockets\WebSocketsServiceProvider"。
3、执行迁移命令以生成必要的数据库表：php artisan migrate。
4、修改config/broadcasting.php中的default driver为pusher。
5、在config/websockets.php中配置监听主机、端口及SSL选项。
6、启动WebSocket服务：php artisan websockets:serve。
三、使用Ratchet库构建自定义WebSocket应用
Ratchet是纯PHP编写的WebSocket库，适合需要完全控制通信逻辑的场景。
1、使用Composer安装Ratchet：composer require cboden/ratchet。
2、定义一个类实现RatchetMessageComponentInterface接口。
3、实现onOpen、onMessage、onClose和onError四个方法以处理不同事件。
4、使用RatchetServerIoServer创建服务器实例。
5、结合HttpServer和WsServer包装WebSocket协议层。
6、运行PHP脚本启动服务：php websocket_server.php。
四、配置Nginx反向代理支持WebSocket
当WebSocket服务运行在特定端口上时，需配置Nginx正确转发Upgrade头以支持WebSocket握手。
1、打开Nginx站点配置文件，通常位于/etc/nginx/sites-available/default。
2、添加location块匹配WebSocket路径，例如/location /ws/ {}。
3、设置proxy_pass指向本地运行的WebSocket服务地址，如http://127.0.0.1:8080。
4、必须包含以下头部设置：proxy_set_header Upgrade $http_upgrade;。
5、添加proxy_set_header Connection "upgrade";以确保协议升级成功。
6、保存后重启Nginx服务：systemctl restart nginx。
