SourceGuardian安装后程序仍提示未安装_路径权限排查
SourceGuardian（简称sg11）是一款PHP代码加密保护工具，很多商业PHP程序（如某些授权CMS、商城系统、SaaS平台）使用SourceGuardian加密源码，运行这些程序必须在服务器上安装SourceGuardian Loader扩展，否则会提示「SourceGuardian loader is not installed」或页面空白。Linux虚拟主机安装sg11扩展需要确认PHP版本、下载对应扩展文件、配置php.ini、重启PHP，几个环节都要正确。本文详细讲解Linux虚拟主机安装SourceGuardian扩展的完整步骤、版本选择方法、面板配置方式和常见问题排查，帮助站长顺利运行加密PHP程序。
sg11与其他加密扩展共存配置。一台服务器上可以同时安装SourceGuardian、ionCube Loader、Swoole Loader、Zend Guard Loader等多个加密扩展，在php.ini中分别添加各自的extension配置即可。注意加载顺序：ionCube和Zend Guard通常要求放在php.ini最前面（在其他extension之前），SourceGuardian和Swoole Loader位置不敏感。如果出现冲突，可以调整顺序测试。多个加密扩展会增加PHP启动时间，但影响很小（几毫秒），内存占用也很低。安装多个扩展时，每个扩展都要匹配PHP版本和线程安全类型，任何一个版本不对都会导致PHP启动失败，出现500错误。
SourceGuardian扩展的版本更新。sg11 Loader会随SourceGuardian加密软件更新，加密程序用新版本加密后，可能需要更新Loader才能运行。更新方法：下载新版本ixed.X.X.lin，替换旧文件，重启PHP。更新前确认加密程序要求的最低Loader版本，在程序的安装说明或报错提示中会有说明。SourceGuardian Loader通常向后兼容，新版Loader能运行旧版加密的文件，但旧版Loader可能无法运行新版加密的文件。建议保持Loader为最新稳定版，避免兼容性问题。更新后验证程序是否正常运行，出现问题换回旧版本。
常见报错「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是否安装成功。方法一：phpinfo页面搜索「sourceguardian」或「SourceGuardian Loader」，能看到扩展版本号、作者、编译时间、支持的加密版本等信息，说明已加载。方法二：创建测试脚本test.php，内容<?php var_dump(extension_loaded('sourceguardian')); ?>，访问后输出bool(true)说明已加载，输出bool(false)说明未加载。注意有些版本的扩展名称是ixed而不是sourceguardian，可以用get_loaded_extensions()查看所有已加载扩展，搜索是否有sourceguardian或ixed。方法三：直接运行需要sg11的加密程序，如果不再提示「SourceGuardian loader is not installed」且页面正常显示，说明安装成功。
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没配置。
安装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。
配置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」，能看到版本信息说明安装成功。
运维评价：「PHP加密扩展安装的关键是版本匹配，用官方loader.php检测最准确，不用自己猜版本。sg11和ionCube可以共存，php.ini里分别加配置就行，给客户部署加密程序一直这么弄」「虚拟主机环境装扩展受限，推荐宝塔和cPanel面板，常用扩展都能一键开启，手动装容易出路径和权限问题。买主机前确认扩展支持是基本操作」。
经验总结：sg11安装的核心是「版本匹配+正确配置+重启验证」。版本匹配用loader.php检测最靠谱；正确配置看php.ini路径和extension_dir；重启验证看phpinfo和程序运行。常见问题：版本不匹配报Unable to load、php.ini改错路径不生效、CLI和FPM不一致、文件权限不足。按排查流程逐项检查都能解决。购买虚拟主机前确认是否支持sg11等加密扩展，主流主机商都预装了，不支持的建议更换。
更新时间：2026-08-27 11:21:43