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

ReturnTypeWillChange 注解

· 52CE 我爱测

现在,大多数非 final 内部方法要求重写方法声明兼容的返回类型,否则会在继承验证期间发出弃用通知, 警告该签名违反协变规则。

ReturnTypeWillChange 注解

(PHP 8 >= 8.1.0)

简介

从 PHP 8.1.0 起,内部类方法开始进入向返回类型声明过渡的暂定阶段。

现在,大多数非 final 内部方法要求重写方法声明兼容的返回类型,否则会在继承验证期间发出弃用通知, 警告该签名违反协变规则。

在未来的 PHP 版本中,方法签名检查将变得严格,不匹配会导致致命错误。

如果由于 PHP 跨版本兼容性问题而无法为重写方法声明返回类型,或者重写方法声明了不兼容的返回类型, 可以添加 #[\ReturnTypeWillChange] 注解来消除弃用通知。

警告

重写用户定义类中的方法时,会严格检查返回类型。即使重写方法使用了该注解, 返回类型不匹配仍会导致致命错误。

ReturnTypeWillChange 注解仅在暂定返回类型阶段抑制弃用警告。 强制执行严格类型检查后,该注解将不再生效,内部类的重写方法签名不匹配会导致致命错误。

类摘要

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

参见

注解概览

目录

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

资料来源与适用范围

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

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

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