常见问题

1. 报错:"load file /www/wwwroot/some_file.php failed, Error: %s [%d]"

确认some_file.php的文件权限是否正确,或者查看文件是否有损坏的情况(加密之后很多FTP工具会导致文件损坏)。

2. 报错: "the code encrypt by php 7.1 , but the loader version is 5.6"

加密时候的版本号要和解密端(运行加密的php代码的机器)的php版本号对应上。

3. 安装 loader 扩展后 运行一个非常简单逻辑的加了密的 php 代码 报"segment fault"或"Allowed memory size of xxxx"错误

1. 确保你的php没有安装incube loader、xdebug、zend guard loader扩展。 2. 确保swoole_loader的版本和加密器的版本对应上,例如1.9版本的加密器对应1.9版本的loader。 3. 确保你的php是非Debug版本,使用 php -i | grep "Debug Build"查看是否有Debug Build => yes,Swoole Compiler不支持Debug版本,请安装非Debug版本的PHP

4. 报错:**"PHP Fatal error: Unknown: product xxxxxxx can not find in license file in Unknown on line 0

Fatal error: Unknown: product xxxxxxx can not find in license file in Unknown on line 0"**

添加授权信息后加密的代码包里面会包含一个 license 授权文件,loader 端需要在php.ini中添加以下配置: swoole_loader.license_files=/yourpath/swoole-compiler.license

yourpath 为存放 license 授权文件的路径

5. 访问提示:"Swoole_loader ext not installed"

1.确认你的 swoole_loader 扩展是否安装成功 2.确认你的PHP版本、加密器版本以及 swoole_loader 的版本是否一致

6. 报错:"Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 18446744072850426110 bytes) in Unknown on line 0"

错误原因:加密器版本和loader版本不一致 解决办法:加密器版本和loader版本对应上即可

7. 报错:"Fatal error: Unknown: the license config file format error , use ini format and do not modify it in Unknown on line 0 "

错误原因:license文件上传损坏,可使用md5sum或sha1sum查看对比 解决办法:更换上传文件的工具,推荐scp等

8. 多个 license 文件,配置正常却报错"Fatal error"

错误原因:可能 product_name 存在相同,导致无法正常匹配license文件 解决办法:使用swoole_get_license()函数打印配置信息,查看是否相同,如果相同需要修改product_name后重新生成license

9. license 文件加载报错 "the file xxxx.license can not access"

错误原因1:确保存在此license文件,并且PHP项目有权限读取 错误原因2:确保php.ini的open_basedir设置正确,能读取到这个license所在目录

10. 形如以下报错,找不到函数或者找不到类的属性,并且属性名或者函数名是乱码的

Call to undefined method Drupal\user\Entity\User::PUF`BTBxUMD()

请先确认源代码是否运行正常,即查看源代码中是否存在对应的函数名或属性名。如果存在并且是最新版本的loader扩展,请联系微信客服。

11. 加密时报错:

swoole_encrypt_file(): file /tmp/swoole_encrypt/services/gis/lib/Slim/Router.php have been encode, skip it

请查看相关目录中的文件是否存在已经被加密过的代码,可以在PHP源码目录使用grep -R "SWOOLEC" ./进行查找。

12. 出现 “未找到,请检查swoole-compiler的安装情况”

加密配置文件必须为 Unix 风格换行符,可使用dos2unix工具进行转换。

13. CentOS 8 安装时提示依赖检测失败,缺少 libnsl.so.1

执行以下命令即可。

dnf install libnsl

FTP 工具

推荐使用 scp、winscp、宝塔,禁止使用 filezilla

使用winscp时需要将传输模式改为二进制文件

loader 扩展兼容性

因为 swoole_loader 无法和 xdebug、ioncube、zend guard loader、swoole_tracker 扩展兼容,使用前需要先卸载。

在mips架构或UOS系统下,swoole_loader和opcache冲突,使用前需要先卸载。

加密器与 Composer

现代的 php 项目大部分都用 composer 做依赖管理,需要注意的是如果你的项目加密后执行composer install有可能出现问题,因为 composer 会分析你的项目所有的类并生成 autoload_classmap.php。如果加密的代码 composer 是无法分析的,会导致无法加载类。 解决方案:先 composer install 拉下来 vender 目录 再进行加密,加密的时候可以通过白名单来排除 vendor 目录,或者连着 vendor 一起加密也可以(vendor 非常大的话会比较慢)

关于文件软链接

不要在项目中有软链接,否则在线加密会丢失文件,本地加密也会丢失软链(直接把软链接的文件当做了真实的文件)

如报错:

swoole_encrypt_file(): open file error (in /tmp/compiler/xxxx/public/storage) (out /tmp/swoole_encrypt/public/storage): No such file or directory

这里的storage就是个软链接,删除掉重新加密即可。

配置文件格式或PHP代码格式错误

  1. 离线版在加密时指定了配置文件,但是却提示出错了:未找到,请检查swoole-compiler的安装情况,请确定改配置文件格式是否为 unix 格式;

  2. 如果某个文件加密不了,请检查该文件的PHP语法是否正确以及文件格式是否为 unix 格式;

可能是在 Windows 下编辑上传到 Linux,导致文件格式为DOS格式

数据类型移植

如果loader是跑在ARM上的,那么在编译PHP的时候需要加上-fsigned-char选项。在PHP的Makefile里面,找到CFLAGS,然后追加一个-fsigned-char。

例如,原来的CFLAGS是这样的:

CFLAGS = $(CFLAGS_CLEAN) -prefer-non-pic -static

那么你需要改成:

CFLAGS = $(CFLAGS_CLEAN) -prefer-non-pic -static -fsigned-char

如果之前编译过PHP,你需要重新编译PHP:

make clean && make && make install

注意:一定要执行 make clean

最后更新:2026-09-15