升级 PHP 8 后，如 Zend Guard Loader 因官方 2016 年停止维护且最后仅支持到 PHP 7.4，强行加载会报"Invalid library"错误，必须转向 ionCube Loader 13+ 等现代方案。
原因分析
PHP 8.0 及以上版本进行了架构级重构，导致旧扩展无法兼容。核心原因包括 ZTS/NTS 模型变更、OPcache 内部结构重写及扩展机制重构。例如，phpast 扩展在编译时会报错"error: 'zend_ast' has no member named 'attr'"，这是因为 PHP 8.0 彻底重构了 AST 内部结构，zend_ast 成员和内存布局全变了。此外，PEAR Mail 扩展在 PHP 8.0+ 升级后因路径解析机制变更，导致"include_once(Net/SMTP.php): Failed to open stream"错误，即使 pear list 确认 pear/Net_SMTP(v1.10.0) 已安装，传统裸字符串路径解析在 CGI/FPM 模式下也已失效。
解决方案
1. 加密代码迁移：从 Zend Guard 到 ionCube
目前没有官方"Zend Guard Loader for PHP 8"替代品。若目标是保护核心算法，需改用 ionCube Loader 13+，它已明确支持 PHP 8.0–8.3。注意加密后文件必须用 ioncube_loaders 运行，且需确保 opcache.enable=1 且 opcache.enable_cli=0，因为 CLI 模式下 ionCube 需接管编译。若已有大量 Zend Guard 加密文件，必须用原始未加密源码重新用 ionCube Encoder 处理，Zend Guard 的加密是单向编译，无公开逆向方案。
2. 代码分析工具：从 phpast 到 nikic/php-parser
phpast 扩展最后更新停留在 PHP 7.2，在 PHP 8.0+ 无法编译通过。推荐改用 nikic/php-parser 库，它是纯 PHP 实现，支持 PHP 5.6–8.3 全版本。安装命令为"composer require nikic/php-parser"。基础用法中，所有节点类型都定义在 PhpParser\Node\*命名空间下，比如 PhpParser\Node\Expr\BinaryOp\Plus。修改 AST 时要返回替换节点或 null 删除，生成 PHP 代码需用 PhpParser\PrettyPrinter\Standard。
3. 遗留功能修复：PEAR Mail 与数据库驱动
针对 PEAR Mail 报错，根本解决方法是将相对路径引用替换为基于__DIR__ 的绝对路径写法，需手动修改 PEAR 安装目录下相关.php 文件。针对数据库驱动，PHP 8.5 正式移除了 mysql_*() 系列函数，无法通过启用旧扩展恢复。检查项目中是否使用已被移除的函数，替换过时扩展为现代替代方案如 mysqli 或 PDO。ThinkPHP 旧项目需升级到 thinkphp5.1.40+，这是官方最低兼容 PHP 8 的版本，它修复了 Request::param() 对 null 返回值的处理逻辑。
4. 图片元数据解析：exif 扩展限制
PHP 8.5 的 exif 扩展完全不支持 HEIC/HEIF，调用 exif_read_data('photo.heic') 通常会静默返回 false 或触发"Warning: exif_read_data(): File not supported"。推荐生产用 ext-vips(vips PHP binding)，支持直接读 HEIC 并提取 EXIF/XMP。命令行兜底方案是使用 exiftool photo.heic，但需确保系统已安装 exiftool 且可执行。
注意事项
1. 类型严格校验：旧版 ThinkPHP(尤其是 5.0.x 和 5.1.x) 大量使用 func_get_args() 配合可变参数模拟重载，而 PHP 8 严格校验函数签名，当控制器方法声明了类型提示但实际传入 null 时，PHP 8 不再静默转为默认值，而是抛出 TypeError。
2. 扩展共存配置：ionCube Loader 和 opcache 可共存，但必须确保 opcache.enable_cli=0。若尝试用 PHP 7.4 编译的 ZendGuardLoader.so 强行加载到 PHP 8.0，php -m 显示 Segmentation fault。
3. 依赖锁死策略：第三方扩展包 (如 topthink/think-captcha) 大概率没更新，composer update 仍会装上。得手动在 composer.json 加"conflict": {"topthink/think-captcha": "*"} 锁死旧版，或找替代方案。
4. 兼容性检测：使用 PHPStan 或 Psalm 可有效检测代码中不兼容的语法结构。安装 PHPStan 后执行"./vendor/bin/phpstan analyse src/"，关注等级为 Level 7 及以上的报错信息。
参考来源
来源：知识库 - 如何在 PHP 8.0 中启用 Zend Guard Loader 替代方案_寻找兼容 PHP 8 的加密工具
来源：知识库 - phpast 扩展怎么用_抽象语法树操作指南【操作】
来源：知识库 - PHP 8 升级后 PEAR Mail SMTP 功能失效的修复指南
来源：知识库 - ThinkPHP 旧项目迁移 PHP8 指南_兼容性适配方案