PHP 8 搭建 Swoole 服务核心是装对版本（推荐 Swoole 6.0+ 配 PHP 8.1）、配对配置（extension=swoole.so + swoole.use_shortname=Off）并启动稳得住（用 think-swoole 一键启 HTTP/WebSocket，配合端口开放、进程守护与禁用 Xdebug）。
PHP 8 搭建 Swoole 服务，核心是「装对版本 + 配对配置 + 启动稳得住」。重点不是堆参数，而是让 PHP 8 和 Swoole 协同不报错、能常驻、可通信。
确认 PHP 8 和 Swoole 版本兼容
Swoole 6.x 是目前与 PHP 8 最匹配的选择。Swoole 4/5 虽能跑，但协程稳定性、内存回收和异常处理在 PHP 8.1+ 下有明显短板；Swoole 6.0+ 原生支持 PHP 8 的 JIT、属性类型、联合类型等特性，且默认禁用短函数名（swoole.use_shortname=Off），避免命名冲突。
- 宝塔面板中推荐选 PHP 8.1（非 8.2/8.3），因部分生产环境扩展（如 redis、mongodb）在 8.2+ 上仍有兼容性反馈
- 不建议用
pecl install swoole直接装最新版——它可能拉取到未适配当前 PHP minor 版本的预编译包 - 稳妥做法：进入对应 PHP 的 bin 目录，用 PECL 指定版本安装
cd /www/server/php/81/bin<br>./pecl install swoole-6.0.0
启用扩展并验证是否生效
安装完成后，必须手动激活扩展并重启 PHP 进程：
- 编辑
/www/server/php/81/etc/php.ini，末尾追加两行：extension=swoole.so<br>swoole.use_shortname=Off
- 执行
/etc/init.d/php-fpm-81 restart或在宝塔面板点击「重载配置」 - 验证命令：
php --ri swoole—— 应显示版本号、编译选项及 loaded 成功；
再运行php -m | grep swoole确认模块已列在扩展列表中
用 ThinkPHP 8 快速启动 HTTP 或 WebSocket 服务
无需从零写 Server 类，ThinkPHP 8 配合 topthink/think-swoole 扩展可一键拉起服务：
立即学习“PHP免费学习笔记（深入）”；
- 项目内执行：
composer require topthink/think-swoole - 发布配置：
php think swoole:publish→ 自动生成config/swoole.php - 修改配置关键项：
•http.enable设为true启 HTTP 服务
•websocket.enable设为true启 WebSocket 服务
•host建议填0.0.0.0（监听所有网卡）
•port推荐9501（避开常用端口，便于防火墙放行） - 启动命令：
php think swoole:start，看到Swoole http server started: http://0.0.0.0:9501即成功
生产环境必须做的三件事
本地跑通不等于线上可用，以下三项漏一不可：
-
开放服务器端口：在云厂商控制台（阿里云/腾讯云）安全组 + 宝塔「安全」页面，同时放行你设的端口（如 9501），协议选 TCP；禁止直接开放
0.0.0.0/0，应限制为可信 IP 段 -
配置进程守护：Swoole 默认前台运行，关终端就退出。用 Supervisor 或 systemd 管理：
Supervisor 示例配置中需指定command=php /path/to/your/project/think swoole:start并开启autostart=true -
禁用 Xdebug：Xdebug 与 Swoole 协程严重冲突，会导致连接假死、内存暴涨甚至崩溃；检查 php.ini 中已注释或删除
zend_extension=xdebug.so
