phpEnv需为每个PHP版本单独安装匹配的IonCube Loader：先确认版本、架构（x86-64/i386）与线程安全（TS/NTS），再从官网下载对应ioncube_loader_lin_.so或ioncube_loader_win_.dll，放入该版本extension_dir并配置zend_extension绝对路径，最后分别验证CLI和Web SAPI生效。
phpEnv 本身不内置 IonCube 支持，必须手动为每个 PHP 版本单独安装对应版本的 ioncube_loader_lin_*.so（Linux）或 ioncube_loader_win_*.dll（Windows），否则运行加密文件会直接报 Fatal error: The encoded file has expired 或 Parse error: syntax error, unexpected '' —— 这不是代码问题，是 Loader 缺失或版本错配。
确认 phpEnv 中目标 PHP 版本与架构
phpEnv 允许共存多个 PHP 版本（如 7.4、8.1、8.2），但每个版本需独立配置 Loader。错误常源于「以为装了一个就全通」。
- 在终端执行：
/path/to/phpenv/versions/8.2/bin/php -v（路径依实际调整），确认你要用的 PHP 版本号 - 再执行：
/path/to/phpenv/versions/8.2/bin/php -i | grep "Architecture\|Thread Safety"，明确是x86-64还是i386，以及Thread Safety => disabled（NTS）还是enabled（TS） - IonCube 官方下载页（
https://www.ioncube.com/loaders.php）按「PHP version + OS + Architecture + TS/NTS」四要素筛选，缺一不可
将 ioncube_loader 放入正确扩展目录并修改 php.ini
phpEnv 的每个 PHP 版本有独立的 php.ini 和扩展目录，不能复用系统级路径。
- 查扩展目录：
/path/to/phpenv/versions/8.2/bin/php -i | grep "extension_dir"，典型路径如/path/to/phpenv/versions/8.2/lib/php/extensions/no-debug-non-zts-20210902/ - 把下载好的
ioncube_loader_lin_8.2.so（Linux）或ioncube_loader_win_8.2.dll（Windows）复制进去 - 编辑该版本专用的
php.ini（路径通常为/path/to/phpenv/versions/8.2/etc/php.ini），在末尾添加：zend_extension = /path/to/phpenv/versions/8.2/lib/php/extensions/no-debug-non-zts-20210902/ioncube_loader_lin_8.2.so - 注意：必须用
zend_extension，不是extension；路径必须绝对且可读；Windows 下后缀是.dll，不是.so
验证是否真正生效（CLI 和 Web 必须分别测）
phpEnv 常见陷阱是 CLI 能跑、Web 不能跑，或反之——因为 Apache/Nginx 和 CLI 可能加载了不同 php.ini。
立即学习“PHP免费学习笔记（深入）”；
- CLI 测试：
/path/to/phpenv/versions/8.2/bin/php -m | grep ioncube，有输出才说明 CLI 加载成功 - Web 测试：建一个
info.php，内容为<?php phpinfo(); ?>，浏览器访问，搜索ionCube Loader区块，并确认Loaded Configuration File路径和你改的那个一致 - 终极实测：写一段检测代码，放在 Web 目录下访问：
<?php if (!extension_loaded('ionCube Loader')) { die('ionCube Loader not loaded in web SAPI'); } if (!function_exists('ioncube_license_info')) { die('Loader loaded but no license interface'); } print_r(ioncube_license_info()); ?>
最易被忽略的是：phpEnv 切换 PHP 版本后，Web 服务器（如 Apache）不会自动重载对应 PHP 模块，需手动重启 Apache 或确保使用的是 php-fpm 模式并重启对应 fpm pool。另外，加密文件若绑定了 PHP 8.2 的 Zend API（20210902），放到 8.1 环境里哪怕 Loader 已装，也会硬性拒绝执行——没有降级兼容机制。
