php 8.3扩展中需为含public readonly属性的类显式实现__serialize和__unserialize魔术方法，否则序列化会触发致命错误；必须在minit阶段注册方法、手动读写只读属性，并通过构造函数重放或谨慎反射恢复状态。
PHP 8.3扩展开发中需为自定义对象添加序列化支持，否则调用serialize()时会触发致命错误或丢失只读属性值，尤其当对象含public readonly字段时，原生序列化机制直接报错。
确认扩展类是否含只读属性
打开扩展源码中的类定义文件（如php_myext.h或myext.c），搜索readonly关键字。若存在public readonly string $id;这类声明，必须显式实现序列化钩子——PHP 8.3 不再允许绕过__serialize()直接序列化只读字段。
检查zend_class_entry结构体注册时是否调用了zend_declare_property_*系列函数初始化只读属性。未在MINIT阶段完成初始化的只读属性，在反序列化时无法恢复，会抛出Fatal error: Uncaught Error: Cannot initialize readonly property。
在扩展中注册序列化魔术方法
在扩展的MINIT函数中，为类注册__serialize和__unserialize方法：
使用zend_hash_str_add_ptr(&ce->function_table, "__serialize", sizeof("__serialize")-1, &serialize_handler);将C函数zif_myext___serialize挂载到类方法表；同理注册__unserialize指向zif_myext___unserialize。
【关键前提】这两个函数必须声明为ZEND_METHOD(MyExt_Class, __serialize)而非普通PHP_FUNCTION，否则ZEND引擎无法识别其魔术行为，仍走默认序列化路径导致崩溃。
实现__serialize返回可序列化数组
编写zif_myext___serialize函数体：
第一步：从execute_data获取当前对象zval *object = ZEND_CALL_ARG(execute_data, 1);；
第二步：调用zend_std_read_property(object, "id", BP_VAR_R, NULL)逐个读取只读属性值，注意传入BP_VAR_R避免触发写保护异常；
第三步：用array_init(return_value)初始化返回数组，再用add_assoc_string(return_value, "id", Z_STRVAL(id_zv))填入键值对——这一步必须手动映射，不可调用zend_get_properties_for，因其会跳过只读属性。
实现__unserialize安全重建只读状态
方法一：构造函数重放（推荐）
在zif_myext___unserialize中解析传入的zval *data数组，提取"id"值后，调用zend_call_method_with_2_params(NULL, ce, &ce->constructor, "__construct", NULL, &id_zv, &name_zv)重新执行构造逻辑。此方式严格复用初始化路径，确保只读属性仅被赋值一次。
方法二：反射绕过（慎用）
若构造函数含复杂依赖无法重放，可用zend_update_property强制写入：zend_update_property(ce, object, "id", sizeof("id")-1, &id_zv);。但该操作仅在属性尚未初始化时生效，【必须前置检查】用zend_get_property(&id_zv, object, "id", sizeof("id")-1, 0, NULL)确认返回IS_UNDEF，否则会触发Fatal error。
编译并验证序列化行为
执行make clean && make && sudo make install重新编译扩展；
在PHP脚本中创建实例：$obj = new MyExt_Class("abc");；
运行var_dump(unserialize(serialize($obj))); ——若输出包含id且无报错，则序列化支持已生效；
尝试$obj->id = "def";应仍抛出Cannot modify readonly property，证明只读语义未被破坏。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
