本文详细介绍了在PHP中如何程序化地区分对象的声明属性和动态属性。通过利用get_class_vars()获取类的默认声明属性和get_object_vars()获取对象的所有实例属性，再结合array_diff_key()函数，我们可以高效地识别出在运行时动态添加的属性，从而增强代码的健壮性和可维护性。
在PHP的面向对象编程中，对象可以拥有两种类型的属性：一种是在类定义中明确声明的属性，另一种是在对象实例化后动态添加的属性。理解并能够程序化地区分这两种属性对于调试、序列化或进行高级对象操作至关重要。
声明属性与动态属性的本质区别
- 声明属性（Declared Properties）：这些属性在类的定义中通过public, protected, private等关键字明确指定。它们是类蓝图的一部分，所有该类的实例都将拥有这些属性（尽管值可能不同）。
- 动态属性（Dynamic Properties）：这些属性不在类的定义中，而是在对象创建后，通过直接赋值的方式在运行时添加到特定的对象实例上。它们是该对象独有的，不影响其他同类实例。
例如：
class Foo {
public $bar; // 声明属性
}
$obj = new Foo;
$obj->baz = 1; // 动态属性在上述代码中，$bar是Foo类的一个声明属性，而$baz是$obj实例的一个动态属性。
立即学习“PHP免费学习笔记（深入）”；
识别动态属性的解决方案
PHP提供了一系列内置的反射函数，可以帮助我们检查类和对象的结构。结合这些函数，我们可以设计一个简单而有效的方法来区分声明属性和动态属性。
核心思路是：
- 获取类中所有声明的（公共）属性。
- 获取对象实例中所有当前的（可访问的）属性。
- 通过比较这两组属性的键，找出那些存在于对象实例中但未在类中声明的属性，它们就是动态属性。
步骤一：获取声明的类属性
使用get_class_vars()函数可以获取一个类的所有默认公共属性。为了使代码更具通用性，我们可以结合get_class()函数来动态获取对象的类名。
// 假设 $obj 是一个对象实例 $className = get_class($obj); $declaredProperties = get_class_vars($className); // $declaredProperties 将包含所有公共声明属性的名称及其默认值
步骤二：获取对象的所有实例属性
get_object_vars()函数可以获取一个对象实例的所有可访问属性。如果从外部作用域调用，它将返回所有公共属性。如果从对象内部调用，它将返回所有公共、受保护和私有属性。
// 假设 $obj 是一个对象实例 $allObjectProperties = get_object_vars($obj); // $allObjectProperties 将包含对象实例上所有可访问属性的名称和当前值
步骤三：识别动态属性
通过比较$allObjectProperties和$declaredProperties的键，我们可以找出动态属性。array_diff_key()函数正是为此目的而设计的，它返回第一个数组中存在但不在第二个数组中存在的键值对。
$dynamicProperties = array_diff_key($allObjectProperties, $declaredProperties); // $dynamicProperties 将只包含动态添加的属性及其当前值
完整示例代码
将上述步骤整合到一起，我们可以构建一个完整的示例：
<?php
class Foo {
public $bar; // 声明的公共属性
protected $protectedProp = 'protected_value'; // 声明的受保护属性
private $privateProp = 'private_value'; // 声明的私有属性
public function __construct() {
$this->bar = 'default_bar';
}
public function getAllInternalProperties() {
return get_object_vars($this);
}
}
// 实例化对象并添加动态属性
$obj = new Foo;
$obj->baz = 1; // 动态公共属性
$obj->qux = 'hello world'; // 另一个动态公共属性
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. 获取对象实例的所有可访问属性 (从外部作用域调用，仅返回公共属性)
$allObjectProperties = get_object_vars($obj);
echo "\n--- 对象所有可访问属性 (get_object_vars) ---\n";
print_r($allObjectProperties);
// 3. 识别动态属性
$dynamicProperties = array_diff_key($allObjectProperties, $declaredProperties);
echo "\n--- 识别出的动态属性 ---\n";
print_r($dynamicProperties);
echo "\n--- 从对象内部获取所有属性 (包括protected/private) ---\n";
// 为了演示 get_object_vars 在内部作用域的行为
$allInternalProperties = $obj->getAllInternalProperties();
print_r($allInternalProperties);
?>运行上述代码，你将得到类似如下的输出：
--- 原始对象结构 ---
Foo Object
(
[bar] => default_bar
[protectedProp:protected] => protected_value
[privateProp:private] => private_value
[baz] => 1
[qux] => hello world
)
--- 声明的公共属性 (get_class_vars) ---
Array
(
[bar] =>
)
--- 对象所有可访问属性 (get_object_vars) ---
Array
(
[bar] => default_bar
[baz] => 1
[qux] => hello world
)
--- 识别出的动态属性 ---
Array
(
[baz] => 1
[qux] => hello world
)
--- 从对象内部获取所有属性 (包括protected/private) ---
Array
(
[bar] => default_bar
[protectedProp] => protected_value
[privateProp] => private_value
[baz] => 1
[qux] => hello world
)从输出可以看出：
- get_class_vars()只返回了$bar，因为它是唯一的公共声明属性。
- get_object_vars()从外部作用域调用时，返回了$bar, $baz, $qux，即所有公共属性（无论是声明的还是动态的）。
- array_diff_key()成功地从$allObjectProperties中排除了$declaredProperties的键，从而准确识别出了$baz和$qux这两个动态属性。
- 从对象内部调用get_object_vars() (getAllInternalProperties方法) 可以获取到所有声明的属性，包括protected和private，以及动态属性。
注意事项与总结
-
可见性限制：
- get_class_vars()函数只会返回类的公共（public）声明属性。
- get_object_vars()函数在从类外部调用时，也只会返回对象的公共（public）属性（无论是声明的还是动态的）。
- 因此，本教程提供的方法主要用于识别公共动态属性，并将其与公共声明属性区分开来。
- 全面性：如果需要获取包括protected和private在内的所有声明属性，或者需要更深入的属性元数据（如是否为静态、默认值等），则应考虑使用PHP的Reflection API（例如ReflectionClass::getProperties()）。然而，对于大多数仅关注公共属性的场景，上述方法已经足够简洁高效。
- 性能：这些内置函数通常经过高度优化，在大多数应用中，其性能开销可以忽略不计。
通过上述方法，开发者可以清晰地识别出PHP对象中的动态属性，这在需要对对象进行精确控制、避免意外属性、或者在特定场景下（如魔术方法__get, __set的实现）区分属性来源时非常有用。
