SourceGuardian扩展支持的PHP版本_5.x到8.x兼容性
很多站长在安装使用sg11加密的PHP程序时遇到「请安装SourceGuardian扩展」的提示，不知道这个扩展是什么、怎么安装。SourceGuardian Loader和ionCube Loader类似，是用于解密运行加密PHP代码的扩展，它本身不加密，只负责在运行时解密被SourceGuardian加密的文件。安装sg11需要根据PHP版本（5.6/7.0/7.1/7.2/7.3/7.4/8.0/8.1）、线程安全类型（TS/NTS）、系统架构（32位/64位）选择对应版本，下载.so文件放到扩展目录，在php.ini中添加加载配置，重启PHP后验证。本文把这些步骤讲清楚。
宝塔面板安装SourceGuardian。登录宝塔面板，进入「软件商店」，找到已安装的PHP版本（如PHP-7.4），点击「设置」，进入「安装扩展」选项卡，在扩展列表中找到「SourceGuardian」或「sg11」，点击「安装」，宝塔会自动下载对应版本并配置php.ini，安装完成后状态显示「已安装」。如果列表中没有SourceGuardian，用手动方式：在「配置文件」选项卡查看php.ini路径，把ixed.X.X.lin文件上传到extension_dir目录，在php.ini中添加extension配置，保存后在「服务」选项卡重启PHP。宝塔的PHP扩展列表会随面板更新增加新扩展，如果当前版本没有，更新宝塔面板后再查看。
虚拟主机不支持sg11的处理。如果面板中没有SourceGuardian扩展且联系主机商后确认不支持，有几个选择：一是更换支持sg11的虚拟主机，购买前先确认是否支持SourceGuardian（现在主流主机商都预装了sg11）；二是如果程序有未加密版本或其他加密方式（如ionCube），换用对应版本；三是升级到VPS或独立服务器，自己安装sg11扩展，VPS环境完全可控，安装扩展很简单。购买虚拟主机前，先在主机商官网查看支持的PHP扩展列表，或联系售前确认是否支持sg11、ionCube、Swoole Loader等加密扩展，避免买了之后程序跑不起来。
配置php.ini加载sg11扩展。打开phpinfo中显示的Loaded Configuration File对应的php.ini文件，在文件末尾添加一行：extension=ixed.7.4.lin（根据你的PHP版本修改文件名，扩展在系统目录时用文件名）或extension=/绝对路径/ixed.7.4.lin（扩展在自定义目录时用绝对路径）。注意SourceGuardian用extension加载，不是zend_extension。有些旧版本说明可能写zend_extension，以官方当前说明为准，现在版本用extension。保存php.ini后重启PHP服务：独立服务器用systemctl restart php-fpm或service php-fpm restart，虚拟主机在面板中重启PHP或切换PHP版本触发重启。重启后访问phpinfo，搜索「sourceguardian」或「ixed」，能看到版本信息说明安装成功。
安装SourceGuardian前先确认PHP环境。创建phpinfo.php文件（内容<?php phpinfo(); ?>）上传到网站根目录，浏览器访问查看。记录三个关键信息：PHP Version（版本号）、Thread Safety（enabled为TS，disabled为NTS）、Architecture（x86为32位，x64为64位）。同时记录Loaded Configuration File（php.ini路径）和extension_dir（扩展目录路径）。更准确的方法是用SourceGuardian官方检测脚本：访问sourceguardian.com下载loader.php，上传到网站根目录，浏览器访问http://域名/loader.php，脚本会自动检测PHP环境并显示需要下载的sg11版本文件名和下载链接，按推荐下载即可。检测完删除loader.php。
sg11安装后不生效的排查流程。第一步确认php.ini路径：phpinfo中看Loaded Configuration File，确认修改的是这个文件而不是其他php.ini（CLI和FPM可能用不同配置）。第二步确认扩展文件位置：extension_dir目录中是否有ixed.X.X.lin文件，文件名和php.ini中配置的一致，文件权限644。第三步查看PHP错误日志：重启PHP后查看error_log（通常在/var/log/php-fpm/或网站目录下），是否有「Unable to load dynamic library」「undefined symbol」等报错，有报错说明版本不匹配或文件损坏。第四步确认PHP重启成功：phpinfo中的PHP Build Time是否是重启后的时间，或在面板确认PHP服务运行状态。第五步确认CLI和Web都加载：命令行执行php -m查看是否有sourceguardian，如果CLI没有但Web有，说明CLI的php.ini没配置。
常见报错「Unable to load dynamic library 'ixed.7.4.lin'」的原因。一是文件不存在或路径错误：确认extension_dir目录中有这个文件，文件名拼写正确（大小写敏感，Linux区分大小写）。二是文件权限不足：设置chmod 644 ixed.7.4.lin，确保PHP进程能读取。三是PHP版本不匹配：PHP7.4用了ixed.7.3.lin，版本不对无法加载，重新下载对应版本。四是架构不匹配：64位系统用了32位扩展，或反之，下载对应架构版本。五是文件损坏：下载过程中文件损坏，重新下载并校验MD5。根据报错信息中的具体描述（如「file not found」「wrong ELF class」「undefined symbol」）可以判断具体原因。
SourceGuardian与ionCube Loader的区别。两者都是PHP加密代码的加载器，用于运行加密后的PHP程序，功能类似但加密算法不同，互不兼容——用SourceGuardian加密的程序必须装sg11，用ionCube加密的必须装ionCube Loader。一台服务器可以同时安装两个扩展，各自处理对应加密的文件，互不冲突。SourceGuardian的优势是加密强度高、支持PHP版本广（从PHP4到PHP8都有对应版本）、官方更新积极；ionCube的优势是市场占有率高、很多商业程序用ionCube加密、文档丰富。选择哪个加密是程序开发者决定的，用户只需要根据程序要求安装对应的加载器。
SourceGuardian扩展的版本更新。sg11 Loader会随SourceGuardian加密软件更新，加密程序用新版本加密后，可能需要更新Loader才能运行。更新方法：下载新版本ixed.X.X.lin，替换旧文件，重启PHP。更新前确认加密程序要求的最低Loader版本，在程序的安装说明或报错提示中会有说明。SourceGuardian Loader通常向后兼容，新版Loader能运行旧版加密的文件，但旧版Loader可能无法运行新版加密的文件。建议保持Loader为最新稳定版，避免兼容性问题。更新后验证程序是否正常运行，出现问题换回旧版本。
运维评价：「PHP加密扩展安装的关键是版本匹配，用官方loader.php检测最准确，不用自己猜版本。sg11和ionCube可以共存，php.ini里分别加配置就行，给客户部署加密程序一直这么弄」「虚拟主机环境装扩展受限，推荐宝塔和cPanel面板，常用扩展都能一键开启，手动装容易出路径和权限问题。买主机前确认扩展支持是基本操作」。
操作提示：安装sg11前用官方loader.php检测脚本确认需要的版本，比自己看phpinfo更准确。下载对应版本的ixed.X.X.lin文件，上传到extension_dir目录，在正确的php.ini中添加extension配置，重启PHP后用phpinfo和测试脚本双重验证。CLI和Web环境都要确认加载，有定时任务的程序特别注意。更新扩展前备份旧.so文件，新版本有问题可以换回。
更新时间：2026-08-27 13:19:49