PHP 8.2 安装 Swoole 扩展需三步：选对版本（推荐 Swoole 6.0.0）、配对配置（CLI 与 FPM 的 php.ini 均启用 extension=swoole.so 并设 swoole.use_shortname=Off）、验证协程就绪（php --ri swoole 显示 coroutine=enabled 且 test.php 实测输出 hello）。
PHP 8.2 安装 Swoole 扩展，核心是「装对版本 + 配对配置 + 启动协程就绪」。Swoole 6.0+ 是当前最稳的选择，它原生支持 PHP 8.2 的联合类型、只读类等特性，且默认关闭短函数名，避免命名冲突。协程环境不是装完就自动生效的——得确认扩展加载、配置启用、代码写法三者对齐。
选对版本：优先用 Swoole 6.x，别碰最新预编译包
宝塔面板或系统自带的软件商店往往没同步 PHP 8.2 的 Swoole 按钮，图形界面搜不到是正常现象。不要用 pecl install swoole 不加版本号——它可能拉取到未适配 PHP 8.2.11 或 8.2.12 的包。
稳妥做法是明确指定版本：
- 宝塔用户（PHP 8.2）：
/www/server/php/82/bin/pecl install swoole-6.0.0 - Ubuntu/Debian 用户：
sudo /usr/bin/php8.2 -d extension_dir=$(php8.2 -r "echo ini_get('extension_dir');") -d extension=sockets -d extension=openssl pecl install swoole-6.0.0 - AlmaLinux/CentOS 用户：先装依赖
yum install php-devel php-cli gcc make autoconf，再进对应 PHP bin 目录执行pecl install swoole-6.0.0
配对配置：CLI 和 FPM 的 php.ini 都要改
Swoole 是 C 扩展，必须通过 extension=swoole.so 加载。但宝塔、Nginx+PHP-FPM 等环境里，命令行（CLI）和网页请求（FPM）用的是两套 php.ini，只改一个会导致：
-
php -m | grep swoole显示有，但phpinfo()页面里找不到 - 命令行跑协程代码正常，Web 请求报
Class 'SwooleCoroutine' not found
操作步骤：
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
- 查 CLI 配置路径：
php --ini→ 改Loaded Configuration File对应的文件 - 查 FPM 配置路径：宝塔中是
/www/server/php/82/etc/php.ini；手动编译常见于/usr/local/php8.2/etc/php.ini - 两处都追加两行：
extension=swoole.soswoole.use_shortname=Off - 重启服务：
/etc/init.d/php-fpm-82 restart或宝塔面板点「重载配置」
验证协程是否真正就位
装完不等于能用协程。关键看三点：
-
扩展状态：运行
php --ri swoole，输出中必须含enabled、Version => 6.0.0、coroutine => enabled -
短名已关：检查
swoole.use_shortname的 Local Value 是Off，否则go()、chan()这类短函数会冲突 - 代码实测：新建 test.php，内容如下：
die("Swoole 扩展未加载 ");
}
if (!function_exists('Swoole\Coroutine\run')) {
die("协程函数不可用 ");
}
SwooleCoroutine un(function () {
$chan = new SwooleCoroutineChannel();
go(function () use ($chan) {
$chan->push('hello');
});
echo $chan->pop() . " "; // 应输出 hello
});
终端执行 php test.php，无报错且输出 hello 即表示协程环境完整就绪。
常见卡点与绕过方式
遇到问题别硬扛，多数是路径或权限细节没对齐：
-
“phpize not found”：说明没装
php-devel（CentOS/Alma）或php-dev（Ubuntu/Debian），补上即可 -
“Cannot find php-config”：configure 时必须指定路径，例如
./configure --with-php-config=/www/server/php/82/bin/php-config -
Windows 下死活不生效：确认 DLL 名是
php_swoole.dll（不是 swoole.dll），且 CLI 和 Apache/Nginx 加载的是同一份 php.ini -
Composer 不能装 Swoole：
composer require swoole/http-server只是 PHP 类库，不提供协程能力，装了也白装
