需手动加载第三方PHP扩展：先确认PHP版本及extension_dir路径，上传.so文件并设权限644、所有者www:www，配置文件末尾添加extension=绝对路径，重启PHP后用php -m验证；也可用bt命令行工具快速安装。
如果您在宝塔面板中需要为已安装的PHP版本添加第三方提供的PHP组件扩展（如非官方源编译的.so文件或自定义扩展），但面板未内置该扩展的一键安装选项，则需通过手动方式加载。以下是完成此操作的步骤：
一、确认PHP版本及扩展存放路径
在加载第三方扩展前，必须明确当前使用的PHP版本及其扩展目录位置，确保.so文件放置路径与PHP配置一致，避免因路径错误导致扩展无法加载。
1、登录宝塔面板，进入【软件商店】→【已安装】，找到对应PHP版本，点击【设置】。
2、在【配置文件】选项卡中，查找extension_dir参数值，例如：/www/server/php/80/lib/php/extensions/no-debug-non-zts-20220829/。
立即学习“PHP免费学习笔记（深入）”；
3、记录该路径，并确认PHP版本对应的Zend扩展API编号（可通过终端执行/www/server/php/80/bin/php -i | grep "Zend Extension"获取）。
二、上传并部署第三方扩展文件
第三方提供的扩展通常以预编译的.so文件形式交付，需将其复制至正确的扩展目录，并确保文件权限与所有者符合PHP运行要求。
1、使用FTP或宝塔【文件】管理器，进入上述extension_dir路径。
2、将第三方提供的xxx.so文件上传至该目录。
3、选中该文件，点击【权限】，设置权限为644，所有者设为www:www。
三、修改PHP配置启用扩展
扩展文件就位后，需在PHP配置中显式声明加载指令，否则PHP启动时不会识别该模块。
1、返回对应PHP版本的【设置】页面，点击【配置修改】。
2、在配置文件末尾新增一行：extension = /www/server/php/80/lib/php/extensions/no-debug-non-zts-20220829/xxx.so（路径需与实际一致）。
3、保存配置文件。
四、重启PHP服务并验证加载状态
配置变更后必须重启PHP服务，使新扩展被动态载入；随后需验证是否成功注册到PHP运行环境中。
1、在PHP版本设置页点击【服务】→【重启】。
2、重启完成后，在终端执行：/www/server/php/80/bin/php -m | grep xxx（xxx为扩展名，不含.so）。
3、若返回扩展名称，表示加载成功；若无输出，检查.so文件路径、权限、PHP版本兼容性及配置语法。
五、通过宝塔命令行工具快速加载（替代方案）
对于熟悉命令行操作的用户，可绕过面板界面，直接使用宝塔封装的PHP管理命令完成扩展注册，提升效率并减少界面误操作风险。
1、SSH登录服务器，执行：bt，进入宝塔命令行菜单。
2、选择【7】PHP管理，再选择对应PHP版本编号。
3、选择【5】安装扩展，在提示输入扩展路径时，输入/www/server/php/80/lib/php/extensions/no-debug-non-zts-20220829/xxx.so。
