在php中，识别对象属性是预先在类中声明的还是在运行时动态添加的，是一个常见的需求。本文将介绍一种通过结合使用`get_class_vars()`和`get_object_vars()`函数的方法，来精确区分这两种属性，从而帮助开发者更好地理解和调试对象的内部结构。
在PHP面向对象编程中，我们经常会遇到两种类型的对象属性：一种是在类定义时显式声明的属性（Declared Properties），另一种是在对象实例化后，在运行时动态添加的属性（Dynamic Properties）。理解如何区分这两种属性对于代码审查、调试和实现更灵活的对象操作至关重要。
核心方法概述
区分声明属性和动态属性的核心思想是：
- 获取一个类所有声明的公共、保护和私有属性（不包括静态属性）。
- 获取一个对象实例当前所有可访问的属性（包括声明的属性和动态添加的属性）。
- 通过比较这两组属性的键名，其差异部分即为动态属性。
实现步骤
我们将通过以下步骤来识别动态属性：
1. 获取类中声明的属性
使用 get_class_vars() 函数可以获取指定类中所有已声明的（非静态）默认属性及其初始值。该函数返回一个关联数组，键是属性名，值是属性的默认值。为了使其更具通用性，我们可以结合 get_class() 函数来动态获取对象的类名。
立即学习“PHP免费学习笔记（深入）”；
class Foo {
public $bar; // 声明属性
}
$obj = new Foo;
$obj->baz = 1; // 动态属性
// 获取类中声明的属性
$declaredProperties = get_class_vars(get_class($obj));
echo "声明属性:\n";
print_r($declaredProperties);执行上述代码，$declaredProperties 将输出：
声明属性:
Array
(
[bar] =>
)这里 bar 是一个声明属性，其值为 null 因为没有显式初始化。
2. 获取对象实例的所有属性
使用 get_object_vars() 函数可以获取一个对象实例所有可访问的属性。这包括在类中声明的属性以及在运行时动态添加的属性。它也返回一个关联数组，键是属性名，值是属性的当前值。
// ... (接上文代码) // 获取对象实例的所有属性 (声明 + 动态) $allObjectProperties = get_object_vars($obj); echo "\n所有对象属性:\n"; print_r($allObjectProperties);
执行上述代码，$allObjectProperties 将输出：
所有对象属性:
Array
(
[bar] =>
[baz] => 1
)这里包含了声明属性 bar 和动态属性 baz。
3. 计算动态属性
现在我们有了两组属性：
- $declaredProperties: 仅包含类中声明的属性。
- $allObjectProperties: 包含所有当前对象实例的属性（声明的 + 动态的）。
通过比较 $allObjectProperties 和 $declaredProperties 的键名差异，我们就能找出那些在 $declaredProperties 中不存在，但在 $allObjectProperties 中存在的属性，这些就是动态属性。array_diff_key() 函数非常适合这个任务，它会返回在第一个数组中存在但在第二个数组中不存在的键值对。
// ... (接上文代码) // 计算动态属性 $dynamicProperties = array_diff_key($allObjectProperties, $declaredProperties); echo "\n动态属性:\n"; print_r($dynamicProperties);
执行上述代码，$dynamicProperties 将输出：
动态属性:
Array
(
[baz] => 1
)这正是我们期望的动态属性 baz。
完整示例代码
将上述步骤整合起来，形成一个完整的示例：
<?php
class Foo {
public $bar; // 声明属性
protected $protectedProp = 'protected';
private $privateProp = 'private';
}
$obj = new Foo;
$obj->baz = 1; // 动态属性
$obj->qux = 'dynamic value'; // 另一个动态属性
echo "--- 原始对象状态 ---\n";
print_r($obj);
// 1. 获取类中声明的属性
// 注意：get_class_vars() 仅返回类中声明的公共、保护和私有属性的默认值，
// 且不包括静态属性。对于私有和保护属性，在外部访问时可能不可见，
// 但它们的键名会出现在这里。
$declaredProperties = get_class_vars(get_class($obj));
echo "\n--- 类中声明的属性 (get_class_vars) ---\n";
print_r($declaredProperties);
// 2. 获取对象实例的所有属性
// get_object_vars() 返回所有可访问的实例属性，包括声明的和动态的。
// 对于私有和保护属性，只有在当前作用域内（例如在类内部）调用时才能获取到。
// 在本例的全局作用域下，它只会返回公共属性和动态属性。
$allObjectProperties = get_object_vars($obj);
echo "\n--- 对象实例的所有属性 (get_object_vars) ---\n";
print_r($allObjectProperties);
// 3. 计算动态属性
// array_diff_key() 比较两个数组的键名，返回在第一个数组中存在但在第二个数组中不存在的键值对。
$dynamicProperties = array_diff_key($allObjectProperties, $declaredProperties);
echo "\n--- 识别出的动态属性 ---\n";
print_r($dynamicProperties);
?>运行上述完整示例，您将看到清晰的输出，区分了声明属性和动态属性：
--- 原始对象状态 ---
Foo Object
(
[bar] =>
[protectedProp:protected] => protected
[privateProp:Foo:private] => private
[baz] => 1
[qux] => dynamic value
)
--- 类中声明的属性 (get_class_vars) ---
Array
(
[bar] =>
[protectedProp] => protected
[privateProp] => private
)
--- 对象实例的所有属性 (get_object_vars) ---
Array
(
[bar] =>
[baz] => 1
[qux] => dynamic value
)
--- 识别出的动态属性 ---
Array
(
[baz] => 1
[qux] => dynamic value
)请注意，get_object_vars() 在全局作用域下只会返回公共属性和动态属性。如果需要在类内部访问所有属性（包括私有和保护），则需要在类的方法中调用 get_object_vars($this)。然而，对于识别动态属性而言，这种外部调用方式通常足够，因为动态属性总是公共的。
相关函数解析
-
get_class_vars(string $class_name):
- 功能：获取一个类的默认属性。
- 参数：类的名称（字符串）。
- 返回值：一个关联数组，键是属性名，值是属性的默认值。
- 特点：不包括静态属性。对于私有和保护属性，其键名也会返回。
-
get_object_vars(object $object):
- 功能：获取一个对象实例的所有可访问属性。
- 参数：对象实例。
- 返回值：一个关联数组，键是属性名，值是属性的当前值。
- 特点：在当前作用域下，它只会返回可访问的属性（例如，在类外部调用时，只返回公共属性和动态属性）。
-
get_class(object $object = null):
- 功能：获取一个对象的类名。
- 参数：可选的对象实例。
- 返回值：如果提供了对象，返回其类名字符串；如果没有提供对象或在类内部调用，返回当前类的名称。
-
array_diff_key(array $array1, array $array2, ...):
- 功能：比较两个（或更多）数组的键名，并返回在第一个数组中存在但在其他任何数组中都不存在的键值对。
- 参数：至少两个数组。
- 返回值：一个新数组，包含差异部分。
应用场景与注意事项
- 调试与内省（Introspection）: 当需要检查一个对象在运行时有哪些意料之外的属性被添加时，此方法非常有用。
- API设计与验证: 在处理来自外部系统或用户输入的动态数据时，可以用来验证对象是否只包含预期属性，防止意外的属性注入。
- 魔术方法 __set() 和 __get(): 如果类使用了这些魔术方法来处理未声明的属性访问，此方法可以帮助理解哪些属性实际上是通过魔术方法处理的，哪些是真正被动态添加的。
- 性能考量: 对于大型对象或频繁的操作，这些反射函数可能会带来轻微的性能开销，但在大多数调试和内省场景下，这种开销可以忽略不计。
- PHP 8.2+ 弃用动态属性: 从PHP 8.2版本开始，不推荐在没有使用 #[AllowDynamicProperties] 属性的情况下动态创建类属性。在PHP 9.0中，这种行为将被彻底移除。这意味着未来识别动态属性的需求可能会减少，或者需要适配新的属性声明方式。对于旧版PHP项目，此方法仍然有效且重要。
总结
通过巧妙地结合使用 get_class_vars() 和 get_object_vars()，我们可以有效地在PHP中区分一个对象的声明属性和动态属性。这种方法为开发者提供了强大的工具，用于对象的内省、调试和更精细的属性管理，尤其是在处理复杂或不确定的对象结构时。然而，随着PHP语言的发展，动态属性的使用模式也在演变，开发者应关注新版本的PHP特性，以编写更健壮和符合未来标准的面向对象代码。
