宝塔面板PHP 8.2无Swoole选项时，应跳过图形界面，优先用/www/server/php/82/bin/pecl install swoole命令安装；成功后复制extension=swoole.so行，分别写入CLI和FPM的php.ini，并重启PHP服务验证。
宝塔面板里 PHP 8.2 没有 Swoole 选项？别硬刷扩展页
PHP 8.2 是较新版本，宝塔软件商店目前（2026年4月）尚未上架对应 swoole 扩展按钮，强行在「安装扩展」页搜索只会看到空列表或兼容警告。这不是你操作错，是面板还没同步支持——此时必须跳过图形界面，走命令行路径。
用 pecl install swoole 是最省事的启动方案
只要服务器能连外网、基础编译工具齐全，pecl 就能自动匹配 PHP 8.2 的头文件、php-config 路径和 ABI 版本，比手动下载源码更稳。
- 先确认编译环境：执行
yum install -y gcc gcc-c++ make autoconf（CentOS/RHEL）或apt install -y build-essential autoconf（Ubuntu/Debian） - 切换到 PHP 8.2 环境：运行
/www/server/php/82/bin/php -v验证版本，再执行/www/server/php/82/bin/pecl install swoole - 安装过程中会交互询问是否启用
http2、openssl、sockets等特性，按需输y或直接回车跳过默认项 - 成功后终端会输出类似
extension=swoole.so的加载行，**必须复制这一整行**，后续要粘贴进配置文件
手动编译只在 pecl 失败时才动手
常见于内网服务器、DNS 被污染、或需要指定某个 commit（比如修复了 PHP 8.2.11 的协程内存泄漏）。此时不能随便下 GitHub 源码，PECL 官方包更可靠：
- 下载稳定版（如
swoole-5.1.6.tgz）：wget https://pecl.php.net/get/swoole-5.1.6.tgz - 解压后进入目录，严格使用 PHP 8.2 的工具链：
/www/server/php/82/bin/phpize→./configure --with-php-config=/www/server/php/82/bin/php-config -
make && make install后注意看终端最后一行提示的Installing shared extensions:路径，它指向swoole.so实际位置 - 如果该路径下没生成
swoole.so，大概率是phpize或php-config路径写错了——PHP 8.2 的路径一定是/www/server/php/82/，不是81或80
必须同时改 CLI 和 FPM 的 php.ini，否则 Web 请求不生效
宝塔中 PHP-FPM 和命令行（CLI）用的是两套 php.ini，只改一个会导致 php -m | grep swoole 显示正常，但 phpinfo() 页面里找不到 Swoole。
立即学习“PHP免费学习笔记（深入）”；
- 编辑 CLI 配置：
vi /www/server/php/82/etc/php.ini - 编辑 FPM 配置：
vi /www/server/php/82/etc/php-fpm.d/www.conf，找到php_admin_value[extension]行，或直接在对应php.ini底部加extension=swoole.so - 加完保存，**必须点宝塔面板里的「重启 PHP」按钮，不是「重载配置」**；重载不会重新加载扩展
- 验证方式要分场景：
/www/server/php/82/bin/php --ri swoole（CLI），新建info.php访问（Web），两者都得显示 enabled
最容易被忽略的是 PHP 版本路径一致性——从 phpize 到 php-config 再到 php.ini，所有路径里的 82 必须完全一致，错一位就白忙活。
