PHP中的通用stdClass是什么?std是否为Standard Class的缩写?
PHP中stdClass的核心定义
- 它是PHP内核原生内置的无任何预定义逻辑的通用空类:类结构里没有提前写好的属性、方法,也不会自动附带任何魔术方法,本质就是一个支持动态添加任意属性的通用对象容器。
- 大家日常遇到它最频繁的场景就是
json_decode():当第二个参数保持默认值false时,函数就会返回stdClass类型的实例,而非关联数组;除此之外mysqli_fetch_object()、各类对象属性读取的内置函数,也会默认用stdClass作为返回载体,省去开发者为了临时存几个字段专门写个空类的麻烦。 - 它和你自己手写一个空类的差异极小:你给它动态加属性、读属性的操作,和自定义空类实例的行为完全一致,唯一的区别是它是内核注册的原生类,可以直接通过
instanceof stdClass判断某个对象是不是这种通用容器类型。
"std" 缩写的含义与常见认知误区
- 大家最常猜测的*Standard Class(标准类)*就是这个缩写的本意,不存在其他被官方认可的全称(网上流传的“Stored Class”“Static Class”都是没有源码依据的误传)。
- 很多有Java开发经验的人刚接触这个类时,会下意识把它类比成Java中所有对象默认继承的
java.lang.Object根类——毕竟从字面看“Standard Class”很容易让人觉得它是整个语言类体系的标准基类,但这是完全的认知偏差:PHP的类体系没有强制的根类要求,你随便定义一个class Demo {},它的父类就是null,根本不会和stdClass产生任何继承关联。 - 这个命名里的“standard”指向的是它的定位:是PHP给内置功能准备的、无业务定制的通用标准空容器,不是整个语言继承体系的基类。当初设计它的唯一目的,就是让需要返回对象类型的内置函数不用每次临时创建类,拿这个提前注册好的空类当默认载体即可。
日常使用的注意事项
- 别把它和关联数组完全等价:stdClass是对象类型,不能用
[]的数组语法读写属性,也不能直接用array_map()这类数组函数处理,必须先做类型转换才能用数组语法操作。 - 它没有任何特殊的对象能力:哪怕你完全不用
new stdClass(),自己写个空类当通用容器,实际使用效果几乎没有区别,唯一的差异就是对象类型校验的判断结果不同。
内容的提问来源于stack exchange,提问作者frankhammer
相关产品推荐
相关产品推荐

