PHP8.1类属性默认访问属性和动态属性区分-php教程-PHP中文网

php 8.1 中未声明访问修饰符的类属性默认为 public，仅适用于类体内显式定义的属性；动态添加的属性无访问控制、性能差且不被静态分析工具识别，php 8.2 起将逐步弃用。

php8.1类属性默认访问属性和动态属性区分

PHP 8.1 中，类属性如果没有显式声明访问修饰符（public、protected 或 private），其默认访问级别是 public。这一点从 PHP 5.0 起就已确立，8.1 并未改变该规则。但需特别注意：这个“默认 public”仅适用于**显式定义在类体内的属性**，不包括运行时动态添加的属性——后者根本不受访问控制修饰符约束，也不参与类的结构声明。

类属性的默认访问控制

当你这样写：

class User {
    $name; // 没写 public/protected/private
    $email;
}

PHP 8.1 会自动将其视为 public 属性，等价于：

class User {
    public $name;
    public $email;
}

这类属性可被外部直接读写，也可被子类继承和访问。它属于类的正式结构，在编译期就确定了内存布局（如 properties_table 中的 slot），性能高效、IDE 可识别、静态分析工具能校验。

动态属性不是“默认 public 属性”

所谓“动态属性”，是指在对象实例化后，通过赋值语句向对象强行添加的、类中**未声明**的属性，例如：

PHP 8.5.12 RC 1

PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

$user = new User();
$user->age = 28; // age 在 User 类中从未定义

这种写法在 PHP 8.1 及更早版本中被允许，但要注意：

它不享受任何访问修饰符保护，也不受 public/protected/private 约束——因为根本没在类定义里出现；
它不会进入 properties_table 的预分配槽位，而是存入独立的 HashTable（俗称“杂物袋”），每次读写都要哈希查找，性能较差；
它绕过类型声明、无法被 PHPStan/ Psalm 等工具检测，极易因拼写错误引入静默 bug。

PHP 8.1 是动态属性宽松期的尾声

PHP 8.1 对动态属性仍完全允许，无警告、无限制。但它已是“宽松模式”的最后稳定版本之一：

PHP 8.2 开始对未声明属性赋值触发 Deprecation Warning；
PHP 8.3 起默认禁止，必须用 #[AllowDynamicProperties] 显式启用；
PHP 9.0 将彻底移除该能力。

因此，在 PHP 8.1 项目中继续使用动态属性虽可行，但已属技术债——建议新代码一律显式声明属性，旧代码逐步收敛。

如何判断一个属性是“默认 public”还是“动态添加”

关键看它是否出现在 class 定义块内：

出现在 class X { ... } 大括号内 → 是正式属性，哪怕没写 public，也按默认 public 处理；
只出现在 $obj->xxx = ... 这类运行时赋值中 → 是动态属性，与访问修饰符无关，纯属运行时行为。

可用反射快速验证：

$ref = new ReflectionClass(User::class);
var_dump($ref->getProperties()); // 只列出类中声明的属性（含默认 public）
var_dump($user); // 输出对象时，动态属性会显示在 stdPropertyArray 下，但不在 getProperties() 结果中

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！