[TOC]
## 常见问题
1. 报错：**"load file /www/wwwroot/some_file.php failed, Error: %s [%d]"**
>[info] 确认`some_file.php`的文件权限是否正确，或者查看文件是否有损坏的情况(加密之后很多FTP工具会导致文件损坏)。
2. 报错： **"the code encrypt by php 7.1 , but the loader version is 5.6"**
>[info] 加密时候的版本号要和解密端(运行加密的php代码的机器)的php版本号对应上。
3. 安装 loader 扩展后 运行一个非常简单逻辑的加了密的 php 代码 报"segment fault"或"Allowed memory size of xxxx"错误
>[info] 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"**
>[info] 添加授权信息后加密的代码包里面会包含一个 `license` 授权文件，`loader` 端需要在`php.ini`中添加以下配置：
`swoole_loader.license_files=/yourpath/swoole-compiler.license`
>[danger] `yourpath` 为存放 `license` 授权文件的路径
5. 访问提示："Swoole_loader ext not installed"
>[info] 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"**
>[info] 错误原因：加密器版本和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 "
>[info] 错误原因：license文件上传损坏，可使用md5sum或sha1sum查看对比
解决办法：更换上传文件的工具，推荐scp等
8. 多个 license 文件，配置正常却报错"Fatal error"
>[info] 错误原因：可能 `product_name` 存在相同，导致无法正常匹配`license`文件
解决办法：使用`swoole_get_license()`函数打印配置信息，查看是否相同，如果相同需要修改product_name后重新生成license
9. license 文件加载报错 **"the file xxxx.license can not access"**
>[info] 错误原因1：确保存在此license文件，并且PHP项目有权限读取
错误原因2：确保php.ini的open_basedir设置正确，能读取到这个license所在目录
10. 形如以下报错，找不到函数或者找不到类的属性，并且属性名或者函数名是乱码的
```php
Call to undefined method Drupal\user\Entity\User::PUF`BTBxUMD()
```
>[info] 请先确认源代码是否运行正常，即查看源代码中是否存在对应的函数名或属性名。如果存在并且是最新版本的loader扩展，请联系微信客服。
11. 加密时报错：
```bash
swoole_encrypt_file(): file /tmp/swoole_encrypt/services/gis/lib/Slim/Router.php have been encode, skip it
```
请查看相关目录中的文件是否存在已经被加密过的代码，可以在PHP源码目录使用`grep -R "SWOOLEC" ./`进行查找。
## FTP 工具
推荐使用 scp、winscp、宝塔，禁止使用 filezilla
>[danger] 使用winscp时需要将传输模式改为**二进制文件**
## loader 扩展兼容性
因为 `swoole_loader` 无法和 `xdebug`、`ioncube`、`zend guard loader`、`swoole_tracker` 扩展兼容，使用前需要先卸载。
在`mips`架构或`UOS`系统下，`swoole_loader`和`opcache`冲突，使用前需要先卸载。
## 使用 Swoole Compiler 是否会降低性能
Swoole Compiler 不存在运行时解密还原 PHP 源代码的逻辑，二进制目标文件只有经过处理的 opcode 二进制指令和内存数据，在第一次运行时将指令和数据载入内存，处理请求时没有任何性能消耗。
## 是否有绑定客户端机器 Mac 地址或域名功能
试用版本不支持此功能。正式版已经支持。
## Swoole Loader 与 Opcache
`Swoole Compiler` 软件本身就是将 PHP 代码编译为经过特殊处理的`opcode`，所以使用`Swoole Loader`加载程序时，不需要其他`OpCache`扩展，包括`opcache`、`apc`、`ZendGuardLoader`、`eAccelerator`等扩展。
如果你的应用程序中，同时有加密代码和非加密代码。当`swoole_loader`发现是非加密代码时，会将编译控制权转给`opcache`，由`opcache`实现代码的加载。
### `Opcache JIT` 引起的 `502` 问题
**请注意 `Opcache JIT` 与 `Swoole Loader` 存在不兼容，若要同时使用 `swoole_loader` 和 `opcache` 时必须要修改 `php.ini` 关闭 `opcache.jit`**
```ini
opcache.jit=0
```
## 加密器与 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
```
>[danger] 这里的`storage`就是个软链接，删除掉重新加密即可。
## 配置文件格式或PHP代码格式错误
1. 离线版在加密时指定了配置文件，但是却提示`出错了：未找到，请检查swoole-compiler的安装情况`，请确定改配置文件格式是否为 `unix` 格式；
2. 如果某个文件加密不了，请检查该文件的PHP语法是否正确以及文件格式是否为 `unix` 格式；
可能是在 Windows 下编辑上传到 Linux，导致文件格式为`DOS`格式
## 数据类型移植
如果`loader`是跑在`ARM`上的，那么在编译`PHP`的时候需要加上`-fsigned-char`选项。在`PHP`的`Makefile`里面，找到`CFLAGS`，然后追加一个`-fsigned-char`。
例如，原来的`CFLAGS`是这样的：
```Makefile
CFLAGS = $(CFLAGS_CLEAN) -prefer-non-pic -static
```
那么你需要改成：
```Makefile
CFLAGS = $(CFLAGS_CLEAN) -prefer-non-pic -static -fsigned-char
```
如果之前编译过`PHP`，你需要重新编译`PHP`：
```bash
make clean && make && make install
```
>[danger] 注意：一定要执行 make clean
## `CentOS 8` 安装时提示依赖检测失败，缺少 `libnsl.so.1`
执行以下命令即可。
```shell
dnf install libnsl
```
