官方使用指南

适用产品：代码卫士

欢迎使用代码卫士

代码卫士是一款企业级 PHP 代码安全解决方案，基于先进的 SG16 加密算法与 Deck 混淆技术，为 PHP 代码提供多层防护机制，帮助开发者和企业有效保护源代码资产，防止代码泄露、篡改和逆向工程。

代码卫士将持续优化加密算法、拓展兼容环境并提升加密体验。由于加密方式、支持版本、处理能力、价格和页面功能会随产品版本更新调整，本文档中涉及的加密类型、参数、价格、额度和功能说明均以产品内最新显示为准。

代码卫士入口：https://php.x5.chat/

一、功能概览

代码卫士主要提供以下能力：

• 在线加密：上传 PHP 文件或项目，选择加密方式，一键完成代码加密处理。
• 多种加密算法：支持 SG16 加密、Deck 混淆、Ioncube 加密等多种加密方式，满足不同安全等级需求。
• 批量处理：支持单文件加密与整项目批量加密，提升大规模代码保护效率。
• 一键部署：加密后的代码可直接部署至服务器运行，无需额外适配。
• 兼容性广泛：适配主流 PHP 版本、操作系统与 Web 服务器环境。
• 免费加密：提供免费加密额度，开发者可零成本体验核心功能。

您无需自行研究复杂的加密算法或搭建加密工具链，只需通过代码卫士平台，即可在最短时间内完成 PHP 代码的安全保护。

二、加密方式与适用场景

代码卫士提供多种加密方式，以满足不同安全等级和部署需求：

2.1 SG16 加密

• 技术特点：基于 SG16 加密扩展的自研加密算法，代码经加密后无法被常规工具还原。
• 运行方式：服务器需安装 SG 加密扩展方可运行加密后的代码。
• 安全等级：高
• 适用场景：商业软件授权分发、核心业务逻辑保护、SaaS 产品代码防护。
• 优势：加密强度高，性能损耗低，支持多平台运行。

2.2 Deck 混淆

• 技术特点：通过代码混淆技术，对 PHP 源码进行变量名替换、控制流扁平化、逻辑重组等处理，使代码难以阅读和逆向。
• 运行方式：混淆后的代码无需额外扩展，可直接在任何 PHP 环境中运行。
• 安全等级：中
• 适用场景：快速代码保护、兼容性要求高的部署环境、无需安装扩展的场景。
• 优势：零依赖，即加即用，兼容性最强。

2.3 Ioncube 加密

• 技术特点：基于 Ioncube Loader 的行业标准加密方案，广泛应用于 PHP 商业软件保护领域。
• 运行方式：服务器需安装 Ioncube Loader 扩展。
• 安全等级：高
• 适用场景：需要与国际标准加密方案对接的项目、已有 Ioncube 运行环境的服务器。
• 优势：行业认可度高，生态成熟，社区资源丰富。

加密方式选择建议

三、加密流程

代码卫士的加密流程简单高效，您只需按照以下步骤操作即可完成代码加密：

1. 注册并登录：访问 https://php.x5.chat/ ，注册代码卫士账号并登录。
2. 上传代码：在加密页面上传需要加密的 PHP 文件或项目压缩包。
3. 选择加密方式：根据安全需求和部署环境，选择 SG16 加密、Deck 混淆或 Ioncube 加密。
4. 配置加密参数：根据需要设置加密强度、保留文件、排除目录等参数。
5. 开始加密：点击「开始加密」按钮，等待系统完成加密处理。
6. 下载加密代码：加密完成后，下载加密后的代码包。
7. 部署运行：将加密代码部署至服务器，安装对应运行扩展（如需要），即可正常运行。

四、加密前准备

在加密前，建议您做好以下准备工作，以确保加密过程顺利、加密结果符合预期：

4.1 代码检查

• 确认代码功能完整、运行正常，加密前先完成所有测试。
• 移除调试代码、注释中的敏感信息和不必要的文件。
• 检查代码中是否包含动态拼接待加密文件路径的逻辑，避免加密后路径异常。

4.2 环境确认

• 确认服务器 PHP 版本，选择与之匹配的加密方式和扩展版本。
• SG16 加密需安装 SG 加密扩展，Ioncube 加密需安装 Ioncube Loader。
• Deck 混淆无需额外扩展，可直接运行。
• 确认服务器操作系统（Linux/Windows）和架构（x86/ARM），下载对应版本的运行扩展。

4.3 备份代码

• 加密是不可逆操作，请务必在加密前备份原始代码。
• 建议使用版本控制系统（如 Git）管理代码，加密后的代码单独存放。

五、SG 加密扩展安装

使用 SG16 加密方式时，服务器需安装 SG 加密扩展。以下是安装步骤：

5.1 Linux 环境

1. 确认 PHP 版本和系统架构。
2. 从代码卫士平台下载对应版本的 SG 扩展文件（.so 文件）。
3. 将扩展文件上传至服务器的 PHP 扩展目录（通常为 /usr/lib/php/modules/ 或通过 php -i | grep extension_dir 查看）。
4. 编辑 php.ini 文件，添加以下内容：

extension=sg16.so

5. 重启 PHP-FPM 或 Web 服务器：

systemctl restart php-fpm
# 或
systemctl restart apache2
# 或
systemctl restart nginx

6. 验证扩展是否安装成功：

php -m | grep sg16

5.2 Windows 环境

1. 确认 PHP 版本和系统架构（x86 / x64）。
2. 从代码卫士平台下载对应版本的 SG 扩展文件（.dll 文件）。
3. 将扩展文件放入 PHP 扩展目录（通常为 php\ext\）。
4. 编辑 php.ini 文件，添加以下内容：

extension=sg16

5. 重启 Web 服务器。
6. 通过 php -m 命令验证扩展是否加载成功。

六、Ioncube Loader 安装

使用 Ioncube 加密方式时，服务器需安装 Ioncube Loader。以下是安装步骤：

6.1 Linux 环境

1. 从 Ioncube 官网或代码卫士平台下载对应版本的 Loader。
2. 解压并将 .so 文件放入 PHP 扩展目录。
3. 编辑 php.ini，在所有其他 extension 配置之前添加：

zend_extension=/path/to/ioncube_loader_lin_X.X.so

注意：Ioncube Loader 必须作为 zend_extension 加载，且需在其他扩展之前加载。

4. 重启 PHP-FPM 或 Web 服务器。
5. 通过 php -v 命令确认 Ioncube Loader 是否加载成功。

6.2 Windows 环境

1. 下载对应版本的 .dll 文件。
2. 放入 PHP 扩展目录。
3. 编辑 php.ini，添加：

zend_extension=php\ext\ioncube_loader_win_X.X.dll

4. 重启 Web 服务器并验证。

七、加密参数说明

不同加密方式支持的参数可能不同，以下为常见参数说明。具体可调项、默认值和可选范围请以产品内实际显示为准。

参数填写建议

• 商业分发建议开启域名绑定或 IP 绑定，防止代码被未授权部署。
• 包含配置文件的项目建议使用「保留文件」功能，避免加密后配置无法修改。
• 测试阶段建议先使用默认参数加密单个文件验证，确认运行正常后再批量处理。

八、加密效果展示

加密后的 PHP 代码将无法被文本编辑器正常阅读，以下为加密前后对比示例：

加密前（原始代码）

<?php
function calculateTotal($items) {
    $total = 0;
    foreach ($items as $item) {
        $total += $item['price'] * $item['quantity'];
    }
    return $total;
}
?>

加密后（SG16 加密示例）

<?php
if(!function_exists('sg16_decrypt')){die('SG16 Extension Required');}
sg16_decrypt('base64_encoded_encrypted_content_here...');
?>

加密后（Deck 混淆示例）

<?php
$_0x4f2a=function($_0x1b3c){$_0x5d6e=0;foreach($_0x1b3c as $_0x7e8f){$_0x5d6e+=$_0x7e8f['_0xa1b2']*$_0x7e8f['_0xc3d4'];}return $_0x5d6e;};
?>

实际加密结果以平台处理为准，以上仅为示意。

九、兼容性说明

代码卫士致力于覆盖主流 PHP 运行环境，以下为当前兼容性概况：

9.1 PHP 版本兼容

具体支持的 PHP 版本以平台加密时提供的选项为准。

9.2 操作系统兼容

9.3 Web 服务器兼容

• Apache：完全兼容
• Nginx + PHP-FPM：完全兼容
• OpenLiteSpeed：完全兼容
• IIS (Windows)：兼容

十、常见问题

Q1：加密后的代码能被破解吗？

代码卫士采用业界领先的加密算法和混淆技术，大幅提高了逆向工程的成本和难度。SG16 加密和 Ioncube 加密属于强加密方案，在扩展未被绕过的前提下，代码无法被还原。Deck 混淆虽不依赖扩展，但混淆后的代码可读性极低，已能满足大多数防护需求。建议核心业务逻辑使用 SG16 或 Ioncube 加密，配合域名绑定和 IP 绑定等授权机制，进一步提升安全性。

Q2：加密后代码运行变慢怎么办？

SG16 加密和 Ioncube 加密的运行时性能损耗通常低于 5%，对绝大多数 Web 应用影响可忽略。Deck 混淆的性能影响取决于混淆深度，建议在性能敏感场景下适当降低混淆深度。如果加密后出现明显性能下降，请检查扩展版本是否与 PHP 版本匹配，或联系技术支持排查。

Q3：加密后的代码能在虚拟主机上运行吗？

Deck 混淆加密后的代码无需安装扩展，可在任何支持 PHP 的虚拟主机上运行。SG16 加密和 Ioncube 加密需要安装对应扩展，需确认虚拟主机是否支持自定义 PHP 扩展。如不支持，建议选择 Deck 混淆方式或更换支持扩展安装的主机环境。

Q4：忘记备份原始代码怎么办？

加密是不可逆操作，代码卫士平台不保存用户上传的原始代码。如未备份原始代码且已加密覆盖，将无法恢复。强烈建议每次加密前务必做好备份。

Q5：加密后代码报错怎么排查？

1. 确认服务器已正确安装对应的运行扩展（SG16 或 Ioncube Loader）。
2. 确认扩展版本与 PHP 版本匹配。
3. 检查加密时是否误排除了必要的文件。
4. 使用未加密的原始代码在相同环境下运行，排除代码本身的问题。
5. 如问题持续，联系技术支持并提供错误信息和环境信息。

Q6：免费加密有什么限制？

代码卫士提供免费加密额度，具体限制（文件大小、加密次数、可用方式等）以平台内最新说明为准。免费额度适合个人开发者和小型项目体验核心功能。如需更大处理量或高级功能，可查看平台提供的付费方案。

Q7：支持加密非 PHP 文件吗？

当前代码卫士专注于 PHP 代码加密保护。上传的项目压缩包中可包含非 PHP 文件（如图片、CSS、JS 等），加密时这些文件默认不会被处理，将原样保留在加密后的代码包中。

十一、使用建议

为了获得更好的代码加密效果和部署体验，我们建议您：

• 加密前务必完成功能测试，确认代码运行正常。
• 每次加密前备份原始代码，加密操作不可逆。
• 根据部署环境选择合适的加密方式：需要最高安全性选 SG16，追求零依赖兼容性选 Deck，已有 Ioncube 环境选 Ioncube。
• 商业分发项目建议开启域名绑定或 IP 绑定，防止未授权部署。
• 包含配置文件的项目使用「保留文件」功能，确保配置可正常修改。
• 先加密单个文件验证运行正常，再进行整项目批量加密。
• 安装运行扩展时注意 PHP 版本和系统架构匹配。
• 关注代码卫士平台更新，及时体验新加密算法和功能。

十二、帮助与支持

• 代码卫士入口：https://php.x5.chat/
• 技术支持 QQ：3775455540
• 技术支持邮箱：[email protected]
• 问题反馈：请登录平台后通过页面反馈入口或直接联系 QQ/邮箱提交。

模型、参数、价格、加密方式和功能说明：请以产品内最新显示为准。

感谢您选择代码卫士。我们致力于为企业与开发者提供专业、可靠的 PHP 代码安全保护，守护您的每一行代码。