当 PHP 方法在某些条件下不返回任何值时，直接使用 array 类型声明会导致 TypeError；应改用可空类型 ?array 并显式返回 null，确保类型安全与逻辑完整性。
当 php 方法在某些条件下不返回任何值时，直接使用 `array` 类型声明会导致 typeerror；应改用可空类型 `?array` 并显式返回 `null`，确保类型安全与逻辑完整性。
在 PHP 7.1+ 中，严格类型声明下，函数若声明了非可空返回类型（如 array），则必须在所有执行路径中返回该类型值。你遇到的 TypeError: Return value must be of type array, none returned 正是因为 if (! $this->valid()) 分支之后缺少 return 语句——PHP 将其视为隐式返回 null，而 null 不属于 array 类型，触发致命错误。
✅ 正确做法是：
- 将返回类型声明为 可空数组
?array（即array|null）； - 显式补全所有分支的返回值，包括非条件路径。
以下是修正后的完整示例：
class MyIterator implements Iterator
{
private array $arrayProperty = [];
// ✅ 正确：声明 ?array，并确保所有路径都有返回值
public function returnArray(): ?array
{
// 模拟迭代逻辑：追加元素、移动指针等
// $this->next();
// $this->current();
if (!$this->valid()) {
return $this->arrayProperty; // 返回数组
}
// 当迭代器有效时，你可能需要返回其他结果
// 或者按业务逻辑选择不返回（即返回 null）
return null; // 显式返回 null，符合 ?array 类型约束
}
// 示例实现 valid() 供参考（实际需根据你的迭代逻辑调整）
public function valid(): bool
{
// 假设此处判断迭代是否仍在有效范围内
return !empty($this->arrayProperty);
}
// 其他 Iterator 方法（required but omitted for brevity）
public function current(): mixed { return null; }
public function next(): void {}
public function key(): mixed { return null; }
public function rewind(): void {}
}⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
-
?array是 PHP 7.1 引入的语法糖，等价于array|null，但更简洁且推荐使用； - 即使逻辑上“不会走到 else 分支”，也必须显式返回，否则静态分析工具（如 PHPStan）和运行时都会报错；
- 若该方法本意是「仅在无效时返回数组，否则无意义」，请考虑是否更适合设计为
getArrayIfInvalid(): ?array等语义更清晰的命名，提升可维护性； - 启用
declare(strict_types=1);时，类型检查更严格，务必保证类型声明与实际返回完全一致。
总结：PHP 没有 none 类型，但通过可空类型 ?T + 显式 return null，即可安全、清晰地表达「可能无返回值」的契约，这是现代 PHP 类型安全实践的标准方式。
