大网数据广告活动
PHP 语言与运行手册

AllowDynamicProperties 注解

· 52CE 我爱测

注意: 虽然注解本身不会被继承,但 AllowDynamicProperties 注解的效果会被继承。使用此注解标记的类,其子类即使没有显式声明该注解, 也同样允许动态属性。

AllowDynamicProperties 注解

(PHP 8 >= 8.2.0)

简介

此注解用于标记 class,允许动态属性。

注意:

虽然注解本身不会被继承,但 AllowDynamicProperties 注解的效果会被继承。使用此注解标记的类,其子类即使没有显式声明该注解, 也同样允许动态属性。

注意:

此注解于 PHP 8.2.0 引入,是显式启用动态属性的方式。若类未使用此注解,且未实现 __get() 或 __set(), 则在该类上创建动态属性会被弃用。

类摘要

#[\Attribute(\Attribute::TARGET_CLASS)]
final class AllowDynamicProperties {
/* 方法 */
public function __construct()
}

示例

示例 #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

参见

注解概览

目录

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。