必须额外部署Swoole Tracker客户端并启用链路追踪功能，仅装swoole.so无法触发链路采集；需确认Swoole版本≥4.8.0且enable=1，否则不支持协程上下文透传；安装Tracker后须同时配置CLI与FPM的php.ini，关闭xdebug等冲突扩展，并重启PHP服务验证Trace数据上报。
宝塔面板安装Swoole扩展后，想让PHP应用自动上报调用链数据、实现接口级性能分析和慢请求定位，必须额外部署Swoole Tracker客户端并启用链路追踪功能，仅装swoole.so无法触发任何链路采集。
确认Swoole已正确安装且版本兼容
执行命令：/www/server/php/82/bin/php --ri swoole，输出中必须同时包含【enable=1】和【version >= 4.8.0】。低于4.8.0的Swoole不支持Tracker的协程上下文透传，强行启用会导致trace断裂或数据丢失。
若未显示swoole模块，先回退检查Swoole扩展是否已同时写入CLI与FPM的php.ini；若版本过低，需卸载旧版后重新安装swoole-5.1.6或更高版本。
下载并运行Swoole Tracker安装脚本
访问识沃科技官网注册账号→提交Swoole Tracker申请→联系客服获取专属下载链接。收到后执行：
chmod +x swoole-tracker-install.sh → ./swoole-tracker-install.sh
脚本执行完毕会在当前目录生成swoole-tracker文件夹，其中包含各PHP版本对应的.so文件（如swoole_tracker70.so至swoole_tracker74.so）。
注意：不要用wget直接下载脚本到/root目录再执行，部分宝塔环境会因权限限制导致inst.sh内部复制失败。
复制对应PHP版本的Tracker扩展到扩展目录
第一步：查清你的PHP实际版本和扩展目录路径
执行/www/server/php/82/bin/php -r "echo @ini_get('extension_dir').PHP_EOL;"，得到类似/www/server/php/82/lib/php/extensions/no-debug-non-zts-20230831/的路径
第二步：从swoole-tracker目录中选择匹配文件
PHP 8.2对应的是swoole_tracker74.so → 执行cp swoole_tracker74.so /www/server/php/82/lib/php/extensions/no-debug-non-zts-20230831/swoole_tracker.so
第三步：验证文件权限
确保swoole_tracker.so属主为root:root，且权限为644，否则PHP加载时会静默失败。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
配置php.ini启用链路追踪
方法一：直接追加配置（推荐）
在CLI和FPM两套php.ini末尾都添加以下四行：
zend_extension = swoole_tracker.so
tracker.enable = 1
tracker.sampling_rate = 100
tracker.enable_memcheck = 0
方法二：使用inst.sh自动注入（仅当手动编辑失败时启用）
进入swoole-tracker目录 → 执行./inst.sh /www/server/php/82，脚本会自动识别php.ini位置并写入配置。
必须关闭xdebug、ioncube_loader等同类调试扩展，它们会劫持函数调用栈，导致Tracker无法捕获完整调用链。
重启服务并验证链路数据上报
第一步：停止所有PHP-FPM进程
执行bt restart php82（宝塔命令）或systemctl restart php-fpm-82
第二步：触发一次真实HTTP请求
用curl或浏览器访问你站点任意一个PHP接口，例如curl http://your-domain.com/api/test.php
第三步：等待30秒后查看Tracker控制台
登录识沃科技提供的Swoole Tracker Web后台，在「实时Trace」页应能看到一条带完整SQL、Redis、HTTP子调用的链路图。若只看到入口Span无子Span，说明采样率被限或扩展未生效。
