php 8.1 要求实现 `arrayaccess` 接口的类必须严格匹配接口中各方法的签名（含参数与返回类型），否则触发弃用警告；正确做法是为 `offsetexists()`、`offsetget()` 等方法显式声明 `: bool`、`: mixed` 等返回类型，而非依赖 `#[\returntypewillchange]` 临时压制。
在 PHP 8.1 中，ArrayAccess 接口已更新为严格声明返回类型（RFC: Strict typing for internal interfaces）。这意味着：任何实现该接口的类，其 offsetExists()、offsetGet()、offsetSet() 和 offsetUnset() 方法，必须与接口定义完全一致——包括参数类型（如 mixed $offset）和返回类型（如 : bool 或 : void）。
原始代码中：
public function offsetExists($offset) {
return array_key_exists($offset, $this->fields);
}缺少返回类型声明，且参数未标注 mixed，导致与 PHP 8.1 的 ArrayAccess::offsetExists(mixed $offset): bool 不兼容，因此触发 Deprecated 警告。
✅ 正确修复方式是补全类型声明，而非仅添加 #[\ReturnTypeWillChange]（该属性仅为过渡方案，不解决根本问题，且未来版本可能移除）：
立即学习“PHP免费学习笔记（深入）”；
// ✅ 符合 PHP 8.1+ ArrayAccess 接口规范
public function offsetExists(mixed $offset): bool {
return array_key_exists($offset, $this->fields);
}
public function offsetGet(mixed $offset): mixed {
return $this->__get($offset);
}
public function offsetSet(mixed $offset, mixed $value): void {
throw new LogicException(sprintf('Can\'t modify an immutable object. You tried to set "%s".', $offset));
}
public function offsetUnset(mixed $offset): void {
throw new LogicException(sprintf('Can\'t modify an immutable object. You tried to unset "%s".', $offset));
}⚠️ 注意事项：
- offsetGet() 在 PHP 8.1+ 的 ArrayAccess 接口中返回类型为 mixed（非 void 或隐式），需明确标注 : mixed；
- offsetSet() 和 offsetUnset() 返回类型为 : void，不可省略（即使方法体为空或仅抛异常）；
- 若项目需兼容 PHP 不能直接使用 mixed 或 : bool（因低版本不支持联合类型/返回类型），此时应：
- 升级最低 PHP 版本要求至 8.0+，或
- 使用条件兼容方案（如版本检测 + @phpstan-ignore 注释），但长期仍推荐统一升级；
- #[\ReturnTypeWillChange] 仅用于无法立即修改签名的遗留场景（如第三方库未更新），不应作为长期解决方案。
? 总结：PHP 8.1 的核心变化是“接口契约更严格”。修复本质是让实现类真正遵守 ArrayAccess 的类型契约——补全 mixed 参数类型与 : bool / : mixed / : void 返回类型。此举不仅消除弃用警告，更提升代码健壮性与 IDE 支持度（如自动补全、静态分析）。
