对象转数组可用(array)、json_encode/json_decode或get_object_vars，分别处理不同属性可见性；数组转对象可用(object)或json_encode/json_decode，自定义类需构造函数或工厂方法。
PHP中将对象转换为数组，或将数组转换为对象，这在数据处理和不同系统间数据交换时非常常见。核心观点是，你可以通过类型强制转换、
json_encode与
json_decode的组合，以及手动遍历等多种方式实现。每种方法都有其独特的行为模式、适用场景和潜在的“坑”，理解它们能帮助你更灵活、更安全地处理数据结构。
解决方案
PHP对象与数组之间的类型转换方法，说白了就是把数据从一种容器形态挪到另一种容器里。这听起来简单，但实际操作起来，根据你的需求和数据的复杂程度，选择哪种方式就变得很重要了。
对象转换为数组：
-
类型强制转换
(array)
: 这是最直接粗暴的方式。当你有一个对象$obj
，直接写(array) $obj
就能把它变成数组。 它的行为有点意思：- 对象的公共（public）属性会直接变成数组的键值对。
- 受保护（protected）属性会变成以
\0*\0
开头的键（比如\0*\0protectedProp
）。 - 私有（private）属性会变成以
\0ClassName\0
开头的键（比如\0MyClass\0privateProp
）。 这种方式转换出来的数组，虽然包含了所有属性，但那些带\0
的键名在日常操作中往往很不方便，甚至会带来一些意想不到的问题。我个人觉得，除非你明确知道自己在做什么，并且需要访问所有属性（包括非公共的），否则慎用。
class MyClass { public $publicProp = 'public'; protected $protectedProp = 'protected'; private $privateProp = 'private'; } $obj = new MyClass(); $arr = (array) $obj; print_r($arr); /* 输出可能类似： Array ( [publicProp] => public [*protectedProp] => protected // 注意这里，实际是 \0*\0protectedProp [MyClassprivateProp] => private // 实际是 \0MyClass\0privateProp ) */ -
json_encode
和json_decode
组合: 这是一种非常流行且“干净”的转换方式，尤其适用于处理复杂或嵌套的对象。 基本思路是：先用json_encode($obj)
把对象序列化成JSON字符串，然后用json_decode($jsonString, true)
把JSON字符串反序列化成关联数组。true
参数很重要，它确保反序列化结果是关联数组而不是对象。 这种方法的特点是：- 只转换公共（public）属性。 私有和受保护属性会被完全忽略。这在很多场景下是优点，因为它只暴露你希望暴露的数据。
- 能很好地处理嵌套对象和数组。
- 数据类型可能会有微调（比如数字字符串可能会被转换为数字类型）。
- 性能开销相对较大，因为涉及到字符串的序列化和反序列化。对于非常大的数据集，需要考虑其效率。
class MyClass { public $publicProp = 'public'; protected $protectedProp = 'protected'; private $privateProp = 'private'; public $nested = ['key' => 'value']; } $obj = new MyClass(); $arr = json_decode(json_encode($obj), true); print_r($arr); /* 输出： Array ( [publicProp] => public [nested] => Array ( [key] => value ) ) */ -
手动遍历或
get_object_vars()
: 如果你只想获取对象的公共属性，并且希望对转换过程有更多控制，get_object_vars($obj)
是一个不错的选择。它会返回一个包含所有公共属性的关联数组。 或者，你也可以自己写一个循环来遍历对象的属性，并根据需要进行筛选或转换。这给了你最大的灵活性，但代码量也会相对多一些。class MyClass { public $publicProp = 'public'; protected $protectedProp = 'protected'; private $privateProp = 'private'; } $obj = new MyClass(); $arr = get_object_vars($obj); print_r($arr); /* 输出： Array ( [publicProp] => public ) */ // 手动遍历 $manualArr = []; foreach ($obj as $key => $value) { $manualArr[$key] = $value; } print_r($manualArr); /* 输出同上，因为foreach默认也只遍历公共属性。 */
数组转换为对象：
立即学习“PHP免费学习笔记（深入）”；
-
类型强制转换
(object)
: 将数组转换为对象，最简单的方法也是类型强制转换。$obj = (object) $array
会将数组的键作为对象的属性名，数组的值作为属性值。 这种方式的优点是简单直接，但缺点是它会创建一个stdClass
对象，而不是你自定义的类实例。这意味着你无法直接调用自定义类中的方法。$arr = ['name' => 'Alice', 'age' => 30]; $obj = (object) $arr; print_r($obj); /* 输出： stdClass Object ( [name] => Alice [age] => 30 ) */ echo $obj->name; // 输出 Alice -
json_encode
和json_decode
组合: 和对象转数组类似，你也可以用json_encode($array)
将数组序列化，然后用json_decode($jsonString)
（不带true
参数）将其反序列化为stdClass
对象。 这种方法同样适用于处理嵌套的数组结构，能将多维数组转换为嵌套的stdClass
对象。$arr = ['name' => 'Bob', 'details' => ['city' => 'New York']]; $obj = json_decode(json_encode($arr)); print_r($obj); /* 输出： stdClass Object ( [name] => Bob [details] => stdClass Object ( [city] => New York ) ) */ echo $obj->details->city; // 输出 New York -
自定义类构造函数或方法: 如果你想将数组转换为特定类的实例，那么最可靠的方式是在你的类中定义一个构造函数或者一个静态工厂方法来处理。 这允许你在转换过程中进行数据验证、类型转换或执行其他业务逻辑。这是我个人最推荐的方式，因为它能保证数据的完整性和类的行为。
class User { public $name; public $age; public function __construct(array $data) { $this->name = $data['name'] ?? 'Unknown'; $this->age = $data['age'] ?? 0; } public static function fromArray(array $data): self { return new self($data); } } $arr = ['name' => 'Charlie', 'age' => 25]; $user = User::fromArray($arr); print_r($user); /* 输出： User Object ( [name] => Charlie [age] => 25 ) */
PHP对象转数组时，私有（private）和保护（protected）属性如何处理？
这是一个非常关键的问题，也是新手经常踩坑的地方。处理私有和保护属性，不同方法表现截然不同，这直接影响你转换后数据的可用性和安全性。
当你使用最简单的
(array) $object进行类型强制转换时，PHP会把这些非公共属性也塞进数组里，但它们的键名会变得很“奇葩”。私有属性会变成
\0ClassName\0propertyName这样的形式，而保护属性则会变成
\0*\0propertyName。这种带
\0的键名在PHP中是合法的，但你直接用
$arr['propertyName']是访问不到的，你必须用完整的、带
\0的键名去访问，这显然很不方便，而且容易出错。更重要的是，这暴露了类的内部实现细节，从封装性角度看并不理想。有时候，你可能会在调试时看到这些，但如果真要用，我建议你重新考虑一下你的设计。
而如果使用
json_encode($object)这种方式，它会非常“识趣”地只处理公共（public）属性。私有和保护属性会被完全忽略，根本不会出现在生成的JSON字符串中。这意味着，如果你依赖
json_encode来转换数据，那么这些内部状态是不会被外部看到的。这通常是好事，因为它尊重了类的封装性。但反过来，如果你确实需要把所有属性，包括私有和保护的，都转换出来，那么
json_encode就帮不了你了，你可能需要采取更高级的手段，比如使用反射（Reflection API）。
反射API（
ReflectionClass,
ReflectionProperty）允许你“窥探”类的内部，包括访问和修改私有和保护属性。通过反射，你可以遍历所有属性，无论它们的可见性如何，然后手动将它们添加到数组中。这提供了极致的控制力，但代码也会更复杂。例如，你可以获取
ReflectionProperty对象，然后调用
setAccessible(true)来临时绕过访问限制，从而获取私有或保护属性的值。这种方法通常用于框架、ORM或需要深度自省的工具中，日常开发中不常直接使用，但了解它的存在很重要。
使用json_encode
和json_decode
进行类型转换有哪些潜在问题或性能考量？
json_encode和
json_decode这对组合在PHP中进行数据结构转换确实非常方便，尤其是在处理复杂嵌套数据时。但就像任何工具一样，它也有自己的“脾气”和需要注意的地方。
首先，数据类型转换问题是比较常见的。JSON标准对数据类型有明确的定义，但它并不完全对应PHP的所有类型。例如：
- PHP中的空数组
[]
在json_encode
后会变成[]
，但如果json_decode
默认不带true
参数，[]
会被解析成stdClass
对象。如果你用true
参数，它会保持为数组。 - PHP的整数和浮点数通常能很好地转换，但如果你的PHP整数超出了JavaScript安全整数范围（
2^53 - 1
），在某些JSON解析器中可能会出现精度问题。 - PHP的
null
会被转换为JSON的null
。 - PHP的资源类型（如文件句柄、数据库连接）或闭包（Closure）是无法被
json_encode
序列化的，它们会被直接忽略或导致错误。 - 如果你的PHP对象实现了
JsonSerializable
接口，那么json_encode
会调用它的jsonSerialize()
方法来获取要序列化的数据，这给了你很大的控制权。
其次，性能考量不容忽视。
json_encode和
json_decode涉及到字符串的序列化和反序列化过程。对于小对象或小数组，这点开销几乎可以忽略不计。但如果你的对象非常庞大，或者你需要频繁地对大量数据进行这种转换，那么性能瓶颈就可能出现。每次转换都需要PHP引擎构建一个JSON字符串，然后再解析这个字符串，这比直接的内存操作要慢得多。在高性能要求的场景下，你可能需要考虑其他更底层的序列化方法，或者重新审视你的数据结构设计，看是否真的需要频繁进行这种转换。
再者，上下文丢失是另一个需要关注的点。
json_encode只关心对象的公共属性值，它不会保留对象的类信息、方法、静态属性或者任何运行时上下文。换句话说，你把一个
MyClass的实例转换成JSON再转回对象，得到的是一个
stdClass的实例，而不是
MyClass的实例。这意味着你无法调用
MyClass中定义的方法。如果你需要保留类信息和方法，那么JSON转换就不适合，你需要考虑PHP原生的
serialize()/
unserialize()函数，或者更高级的序列化库。不过，
serialize()也有自己的安全风险，尤其是在处理不可信数据时。
最后，错误处理也需要注意。
json_encode和
json_decode在遇到无法处理的数据时，可能会返回
false或
null，并且设置一个JSON错误码。在生产环境中，你最好通过
json_last_error()和
json_last_error_msg()来检查是否有错误发生，或者在PHP 7.3+版本中，使用
JSON_THROW_ON_ERROR选项让它们抛出异常，这样可以更优雅地处理错误。
除了简单的类型转换，如何实现更灵活或深度定制的对象与数组互转？
当简单的类型强制转换或
json_encode/
json_decode无法满足你的复杂需求时，你可能就需要更灵活、更深度定制的转换方案了。这通常意味着你需要更多地介入转换过程，或者利用PHP提供的一些高级特性。
一个非常强大的工具是 PHP的反射（Reflection）API。前面提到过，反射允许你在运行时检查和操作类、方法和属性，包括私有和保护成员。通过
ReflectionClass和
ReflectionProperty，你可以：
- 遍历所有属性：无论它们的可见性如何，你都可以获取到。
-
获取/设置属性值：即使是私有属性，你也可以通过
ReflectionProperty::setAccessible(true)
临时修改其访问权限，然后获取或设置其值。 -
实例化对象：
ReflectionClass::newInstanceWithoutConstructor()
甚至可以在不调用构造函数的情况下创建对象实例，这在某些特殊场景下很有用。
使用反射进行对象到数组的转换，你可以构建一个包含所有属性（包括私有和保护的）的完整数组，并且可以自定义键名。反之，从数组到对象，你可以根据数组的键值来填充对象的属性。这种方式虽然代码量会多一些，但提供了无与伦比的控制力。
// 示例：使用反射将对象完整转换为数组
function objectToArrayDeep(object $obj): array {
$arr = [];
$reflection = new ReflectionClass($obj);
foreach ($reflection->getProperties() as $prop) {
$prop->setAccessible(true); // 允许访问私有和保护属性
$value = $prop->getValue($obj);
if (is_object($value)) { // 递归处理嵌套对象
$arr[$prop->getName()] = objectToArrayDeep($value);
} else {
$arr[$prop->getName()] = $value;
}
}
return $arr;
}
class DeepClass {
public $a = 1;
protected $b = 2;
private $c = 3;
public $nestedObj;
public function __construct() {
$this->nestedObj = new class { public $x = 10; private $y = 20; };
}
}
$deepObj = new DeepClass();
$deepArr = objectToArrayDeep($deepObj);
print_r($deepArr);
/*
输出会包含所有属性，包括嵌套对象的私有/保护属性。
*/另一个常见的定制方案是在类中定义专门的转换方法或实现接口。
-
__toArray()
/fromArray()
方法：你可以在你的类中定义一个toArray()
方法，专门负责将当前对象转换为数组，并在其中处理好所有属性的可见性、嵌套对象递归转换等逻辑。同样，可以定义一个静态的fromArray()
方法来从数组创建对象实例。这种方式让转换逻辑内聚在类本身，易于维护。 -
JsonSerializable
接口：如果你的主要目的是将对象转换为JSON（进而转换为数组），实现JsonSerializable
接口是一个优雅的选择。你只需要实现jsonSerialize()
方法，返回你希望被序列化的数据结构。当json_encode()
遇到你的对象时，它会自动调用这个方法。
最后，对于更大型的项目或需要处理复杂数据映射的场景，可以考虑使用专业的序列化/反序列化库。例如：
- Symfony Serializer Component：这是一个功能强大的库，支持多种格式（JSON, XML, YAML等）和多种序列化器（PropertyNormalizer, ObjectNormalizer等）。它允许你定义复杂的映射规则，处理循环引用，甚至在序列化/反序列化过程中执行回调函数。
- JMS Serializer：另一个流行的库，通过注解或YAML/XML配置来定义对象的序列化和反序列化规则，提供了极大的灵活性和可配置性。
这些库通常会提供更高级的功能，比如对象图的深度遍历、类型提示、数据验证等，能大大简化复杂数据结构的转换工作，并确保转换的正确性和一致性。当然，引入这些库会增加项目的依赖，但对于复杂的业务场景来说，这种投入是值得的。选择哪种方式，最终还是取决于你的具体需求、项目的规模以及你对代码的控制程度。
