必须使用PHP 7.4+内核编译扩展，通过phpize7.4配置并静态注册__serialize/__unserialize为public final方法，或动态绑定handlers->serialize/unserialize；__serialize须返回zend_array*，__unserialize须用zend_update_property安全写入属性。
要在PHP 7.4扩展开发中正确启用并使用__serialize和__unserialize这两个新魔术方法，必须确保扩展编译时链接的PHP内核版本不低于7.4.0，且不能依赖旧版序列化逻辑覆盖。
确认扩展构建环境为PHP 7.4+
执行php-config --version命令，输出结果必须为7.4.x或更高；若显示7.3.29或更低版本，后续所有魔术方法注册均无效——因为zend_class_entry结构体在7.4中才新增serialize与unserialize函数指针字段。
用phpize生成配置脚本前，先运行which phpize，确保指向/usr/bin/phpize7.4而非系统默认旧版；误用phpize7.3会导致zend_function_entry数组中无法识别__serialize符号，加载时直接报undefined symbol: zif___serialize错误。
在扩展中注册__serialize/__unserialize
方法一：通过zend_class_entry静态注册（推荐）
立即学习“PHP免费学习笔记（深入）”；
在扩展的MINIT阶段，定义类方法表时，在zend_function_entry数组末尾追加两项：
ZEND_FE_END之后插入：
ZEND_FENTRY(__serialize, php_myclass_serialize, NULL, ZEND_ACC_PUBLIC | ZEND_ACC_FINAL)
ZEND_FENTRY(__unserialize, php_myclass_unserialize, NULL, ZEND_ACC_PUBLIC | ZEND_ACC_FINAL)
【必须将两个方法都设为public且final】——否则PHP运行时会忽略它们，回退到__sleep/__wakeup逻辑，而7.4+已明确弃用对__sleep返回非数组值的容忍。
方法二：动态绑定（仅限对象实例化后）
在zend_object_handlers结构体中显式赋值：
handlers->serialize = php_myclass_serialize_handler;
handlers->unserialize = php_myclass_unserialize_handler;
注意：此方式要求handlers已通过zend_register_internal_class_ex注册，且serialize与unserialize字段在PHP 7.4头文件zend_types.h中才被定义，低版本编译会失败。
实现序列化逻辑的三步硬编码规范
第一步：__serialize函数必须返回zend_array *类型，内容为键值对数组，键为字符串（属性名），值为待序列化的zval；不能返回NULL或任意其他类型，否则触发E_ERROR。
第二步：在__unserialize中，接收的参数必须是单个zend_array *，遍历该数组并用zend_hash_get_current_key_zval提取属性名，再调用zend_update_property写入对应zval——【禁止直接操作对象zval的p->value.ht】，否则绕过属性类型检查，导致PHP 7.4新增的int/string等类型约束失效。
第三步：若类含私有属性，zend_update_property需传入完整限定名（如"MyClass\x00password"），否则写入失败且无报错；可复用zend_mangle_property_name生成该格式字符串。
