PHP 8.1 中 get_class_vars() 对静态属性行为的重大修正-php教程-PHP中文网

PHP 8.1 中 get_class_vars() 对静态属性行为的重大修正

PHP 8.1 修复了 get_class_vars() 函数错误返回静态属性当前值的长期 Bug，使其严格回归文档定义：仅返回类声明时的默认值（而非运行时值），静态属性的实时值需改用 ReflectionClass::getStaticProperties() 或手动反射获取。

php 8.1 修复了 `get_class_vars()` 函数错误返回静态属性当前值的长期 bug，使其严格回归文档定义：仅返回类声明时的默认值（而非运行时值），静态属性的实时值需改用 `reflectionclass::getstaticproperties()` 或手动反射获取。

在 PHP 8.1 之前，get_class_vars() 的行为存在一个未被明确记录但广泛依赖的“隐式特性”：它对静态属性会返回当前运行时值，而对实例属性则始终返回声明时的默认值。这种不一致本质上是实现缺陷——根据 PHP 官方文档，get_class_vars() 的设计目标始终是“返回类中声明的默认属性值”，与运行状态无关。

PHP 8.1 正式修正了这一偏差，使函数行为完全符合规范：无论静态或实例属性，get_class_vars() 现在统一只返回类定义中显式初始化的默认值（即 public static $x = 42; 中的 42），不再反映运行时修改后的状态。这正是你示例中输出从 ["var" => 2] / ["var" => 3] 变为 ["var" => null] 的根本原因——private static int $var; 未提供默认值，故 get_class_vars() 返回 null（PHP 8.1+ 合规行为），而此前版本错误地返回了最后赋值的结果。

✅ 正确获取静态属性当前值的方法

方法 1：使用 `ReflectionClass::getStaticProperties()`

这是最标准、最可靠的方案，专为读取运行时静态属性值设计：

class Test {
    public static int $var = 0;
    private static string $name = 'default';
}

// 设置值
Test::$var = 42;
Test::$name = 'updated';

$reflection = new ReflectionClass(Test::class);
$currentStatics = $reflection->getStaticProperties();

print_r($currentStatics);
// 输出：
// Array (
//     [var] => 42
//     [name] => updated
// )

⚠️ 注意：getStaticProperties() 默认仅返回 public 静态属性。如需访问 private 或 protected 属性，需先调用 $reflection->setAccessible(true)（适用于 ReflectionProperty），但 getStaticProperties() 本身不支持直接获取非 public 属性。若需私有静态值，应改用 ReflectionProperty 单独处理：

PHP
编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

$prop = $reflection->getProperty('name');
$prop->setAccessible(true); // 允许访问 private 属性
echo $prop->getValue(); // 'updated'

方法 2：动态变量语法（谨慎使用）

适用于简单场景，但需自行处理可见性与存在性检查：

function get_current_static_vars(string $className): array {
    $defaults = get_class_vars($className);
    $result = [];
    foreach (array_keys($defaults) as $name) {
        // 检查静态属性是否已定义（且可访问）
        if (isset($className::$$name)) {
            $result[$name] = $className::$$name;
        }
    }
    return $result;
}

// 使用
Test::$var = 99;
print_r(get_current_static_vars(Test::class)); // ['var' => 99]

⚠️ 风险提示：此方法无法绕过访问控制（如 private 属性在非上下文中会触发 fatal error），且依赖 isset() 的宽松判断，不推荐用于生产环境的关键逻辑。

? 总结与迁移建议

不要依赖 get_class_vars() 获取静态属性实时值：PHP 8.1+ 已彻底移除该“副作用”，继续使用将导致逻辑错误。
优先选用 ReflectionClass::getStaticProperties()：它是语义明确、官方支持的标准方式，兼容性好（自 PHP 5.1+），并可通过 ReflectionProperty 精确控制私有/受保护成员访问。
审查现有代码：搜索项目中所有 get_class_vars() 调用，确认其是否误用于读取静态属性状态；若有，立即替换为反射方案。
单元测试覆盖：针对涉及静态状态读取的逻辑，增加 PHP 8.1+ 环境下的测试用例，避免因行为变更引发线上问题。