AllowDynamicProperties 注解
(PHP 8 >= 8.2.0)
简介
此注解用于标记 class,允许动态属性。
注意:
虽然注解本身不会被继承,但
AllowDynamicProperties注解的效果会被继承。使用此注解标记的类,其子类即使没有显式声明该注解, 也同样允许动态属性。
注意:
此注解于 PHP 8.2.0 引入,是显式启用动态属性的方式。若类未使用此注解,且未实现 __get() 或 __set(), 则在该类上创建动态属性会被弃用。
类摘要
示例
示例 #1 AllowDynamicProperties 与动态属性
若要启用动态属性,请添加 #[\AllowDynamicProperties]。
<?php
#[\AllowDynamicProperties]
class ValidExample { }
$obj = new ValidExample();
$obj->myDynamicProp = 1234;
?>示例 #2 AllowDynamicProperties 与不存在的属性
自 PHP 8.2.0 起,除非类使用此注解,否则必须显式声明属性。在此类上创建未声明的属性会发出弃用通知。
<?php
class InvalidExample { }
$obj = new InvalidExample();
$obj->myUnknownProperty = 1234;
?>以上示例在 PHP 8.2 中的输出:
Deprecated: Creation of dynamic property InvalidExample::$myUnknownProperty is deprecated in file on line 5
示例 #3 继承类中的 AllowDynamicProperties 与不存在的属性
<?php
class DefaultBehaviour { }
#[\AllowDynamicProperties]
class ClassAllowsDynamicProperties { }
class InheritedClassAllowsDynamicProperties extends ClassAllowsDynamicProperties { }
$o1 = new DefaultBehaviour();
$o2 = new InheritedClassAllowsDynamicProperties();
$o1->nonExistingProp = true;
$o2->nonExistingProp = true;
?>以上示例在 PHP 8.2 中的输出:
Deprecated: Creation of dynamic property DefaultBehaviour::$nonExistingProp is deprecated in file on line 12
参见
目录
- AllowDynamicProperties::__construct — 构造新的 AllowDynamicProperties 注解实例
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
