宝塔面板php扩展页找不到swoole是因官方未预置，需通过pecl安装：先装编译工具，再用对应php版本的phpize和pecl install swoole，最后在php配置文件中添加extension=swoole.so并重启服务。
宝塔面板里 PHP 扩展页面找不到 Swoole 怎么办
宝塔面板的「PHP 扩展管理」页面默认只列出部分常用扩展，Swoole 不在其中——这不是你漏看了，是它压根没被集成进宝塔的图形化安装列表。直接点「安装」会失败或根本搜不到，强行刷新也没用。
原因很简单：Swoole 编译依赖较多（如 cmake、gcc、php-dev 或对应版本的 php-devel），且不同 PHP 版本需匹配对应 Swoole 版本（比如 PHP 8.2 推荐用 Swoole 5.0+，PHP 7.4 最好用 4.8.x），宝塔官方为避免兼容风险，选择不预置。
- 别在扩展页浪费时间反复搜索
swoole或Swoole - 确认当前 PHP 版本：
php -v，再查对应 Swoole 兼容表（官网 docs.swoole.com/#/zh-cn/start/install） - 如果用的是宝塔编译安装的 PHP（非 yum/apt 安装），
php-config路径通常在/www/server/php/{版本号}/bin/php-config
用 pecl 安装 Swoole 是最稳的方案
pecl 是 PHP 官方扩展分发渠道，宝塔环境下只要网络通、编译工具齐，成功率远高于手动下载源码。关键是它能自动适配当前 PHP 环境，包括头文件路径和配置参数。
操作前确保已安装基础编译工具：
yum install -y gcc gcc-c++ make cmake autoconf # 或 Debian/Ubuntu： apt update && apt install -y build-essential cmake autoconf
然后执行（以 PHP 8.1 为例，替换为你自己的版本号）：
/www/server/php/81/bin/phpize
/www/server/php/81/bin/php -r "print_r(get_cfg_var('extension_dir'));"
pecl install swoole
- 执行
pecl install swoole时会提示是否启用各项特性（如enable-http2、enable-openssl），按需输y或回车跳过 - 安装成功后，会输出类似
extension=swoole.so的行，复制这行 - 到宝塔 → PHP 设置 → 配置文件，找到
; extension=区域，在末尾新增该行（去掉开头的分号） - 重启 PHP 服务：
service php-fpm-81 restart（或在宝塔界面点「重启」）
手动编译源码只在 pecl 失败时才考虑
常见于服务器无法访问 pecl.php.net（比如某些内网或 DNS 受限环境），或者需要指定特定 commit 或 patch 版本。此时必须严格对齐 PHP 源码路径与编译器版本。
步骤本质是模拟 pecl 流程，但更易出错：
- 下载对应版本源码：
wget https://github.com/swoole/swoole-src/archive/refs/tags/v5.1.1.tar.gz - 解压后进入目录，运行
/www/server/php/81/bin/phpize（路径必须准确！） -
./configure --with-php-config=/www/server/php/81/bin/php-config，注意--with-php-config参数不能写成php-config或漏掉路径 -
make -j$(nproc)编译，make install安装生成swoole.so - 检查
swoole.so是否真在extension_dir下（用前面php -r命令确认路径）
漏掉 phpize 或错用其他 PHP 版本的 php-config，会导致扩展加载时报 undefined symbol: zend_object_std_dtor 这类符号错误，重启后 php -m | grep swoole 也看不到。
验证是否真正生效，别只看宝塔界面勾选了没
宝塔「PHP 扩展」页面勾选了 swoole 并不等于它在 CLI 或 FPM 下都可用。很多用户装完发现 php -m 有，但 Laravel Octane 或 Hyperf 启不动，就是这个原因。
- 分别测试三个上下文：
php -m | grep swoole（CLI）、php -i | grep "swoole"（查看详细配置）、在网站根目录放info.php（含<?php phpinfo(); ?>）用浏览器访问，搜Swoole - 如果 CLI 有、FPM 没有，大概率是 PHP-FPM 使用的配置文件不是你在宝塔里编辑的那个（检查
php-fpm.conf中php_admin_value[extension]是否覆盖了全局配置） -
php --ri swoole能看到编译参数和启用的特性，确认SWOOLE_USE_OPENSSL、SWOOLE_USE_HTTP2是否为enabled，避免后续用到 HTTPS 或 HTTP/2 时抛异常
最常被忽略的一点：宝塔更新 PHP 版本后，之前装的 swoole.so 会失效，因为 extension_dir 路径变了，且新 PHP 的 ABI 不兼容旧扩展。每次升级 PHP，必须重装 Swoole。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
