[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 ```