宝塔面板中PHP程序报“ionCube Loader not installed”或500错误，需安装ionCube加载器；可通过面板一键安装、官方脚本或手动编译三种方式实现，并用phpinfo()和函数检测验证生效。
如果您在宝塔面板中部署了使用ionCube加密的PHP程序，但页面报错提示“ionCube Loader not installed”或直接显示空白、500错误，则说明当前PHP环境缺少ionCube加载器。以下是多种可行的安装方法，适用于不同场景和PHP版本。
一、通过宝塔面板“安装扩展”界面一键安装
该方法适用于宝塔面板6.0及以上版本，操作最简捷，且自动匹配PHP版本与对应ionCube Loader二进制文件。
1、使用浏览器登录宝塔面板后台，进入左侧菜单栏的软件商店。
2、在搜索框中输入当前站点所用的PHP版本号（如PHP 7.4、PHP 8.1），点击对应PHP版本右侧的设置按钮。
立即学习“PHP免费学习笔记（深入）”；
3、在弹出页面中切换至安装扩展选项卡。
4、在扩展列表中查找ionCube，确认其状态为未安装后，点击右侧的安装按钮。
5、等待进度条完成，面板将自动重启对应PHP服务；安装成功后状态栏显示已安装。
二、使用官方一键脚本安装
该方法适用于宝塔面板无法在扩展列表中显示ionCube选项的情况，或需手动指定PHP版本时。脚本由宝塔生态常用镜像提供，兼容主流PHP版本（5.6–8.2）。
1、通过SSH工具（如FinalShell）连接服务器，确保当前用户具有root权限。
2、执行下载并运行ionCube专用安装脚本：wget https://soft.itbulu.com/bt/ioncube.sh && sh ioncube.sh。
3、脚本运行后会列出已安装的PHP版本编号（如74、80、81），输入对应数字并回车确认安装目标版本。
4、脚本自动完成下载、解压、路径配置及php.ini写入操作。
5、执行bt 16（或进入宝塔面板→软件管理→PHP→设置→服务→重启）以重启PHP进程。
三、手动编译安装（适用于定制化环境）
该方法适用于需精确控制加载路径、多PHP共存或面板扩展功能异常时。需根据PHP实际版本号匹配ionCube Loader动态库文件。
1、通过SSH执行命令获取当前PHP版本：/www/server/php/74/bin/php -v（示例中74代表PHP 7.4，依实际路径调整）。
2、下载对应架构的ionCube Loader压缩包：wget http://downloads3.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz。
3、解压并进入目录：tar zxvf ioncube_loaders_lin_x86-64.tar.gz && cd ioncube。
4、将对应PHP版本的so文件复制到PHP扩展目录（以PHP 7.4为例）：cp ioncube_loader_lin_7.4.so /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/。
5、编辑PHP配置文件：vi /www/server/php/74/etc/php.ini，在文件末尾新增两行：
[ionCube Loader]
zend_extension=/www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/ioncube_loader_lin_7.4.so
6、保存退出后，执行/etc/init.d/php-fpm-74 restart（或使用bt命令重启）。
四、验证ionCube是否生效
该步骤用于确认加载器已正确载入，避免因路径错误、版本不匹配或未重启导致的假性安装成功。
1、在网站根目录新建一个名为info.php的文件，内容为：<?php phpinfo(); ?>。
2、通过浏览器访问http://您的域名/info.php。
3、在页面中按Ctrl+F搜索关键词ionCube，若出现ionCube PHP Loader及相关版本信息，则表示加载成功。
4、可进一步创建测试文件test-ioncube.php，内容为：<?php if(function_exists('ioncube_loader_version')){echo 'ionCube loaded: '.ioncube_loader_version();}else{echo 'ionCube not loaded';} ?>，访问该文件确认函数可用性。
