当 PHP 方法在某些条件下不返回任何值时，直接使用 array 类型声明会触发 TypeError；应改用可空类型 ?array 并显式返回 null，确保类型安全与逻辑完整性。
当 php 方法在某些条件下不返回任何值时，直接使用 `array` 类型声明会触发 typeerror；应改用可空类型 `?array` 并显式返回 `null`，确保类型安全与逻辑完整性。
在 PHP 7.1+ 中，不存在“none”或“void 作为返回值类型”的语义等价于“不返回任何值”——但需注意：void 类型仅表示“不返回可被使用的值”，它不允许 return 后跟表达式（如 return $arr;），且不能用于需要返回数据的场景。
你遇到的错误：
TypeError: Return value must be of type array, none returned
根本原因在于：你的方法声明了 : array，即强制要求每次调用都必须返回一个数组，但实际代码中仅在 !$this->valid() 为真时才 return $this->arrayProperty；其余路径（如 valid() 为真时）未提供任何 return 语句，导致隐式返回 null，违反类型约束。
✅ 正确解法是明确承认“该方法可能返回数组，也可能不返回（即返回 null）”，使用可空数组类型（Nullable Array）：
立即学习“PHP免费学习笔记（深入）”；
public function returnArray(): ?array
{
// 模拟迭代器内部逻辑：追加元素、移动指针等
// $this->next();
// $this->current();
if (!$this->valid()) {
return $this->arrayProperty;
}
// 当迭代器仍有效时，不提供数组结果 → 显式返回 null
return null;
}? 关键要点：
-
?array是array|null的语法糖，自 PHP 7.1 起支持，需启用严格模式（declare(strict_types=1);）以获得完整类型保障； -
必须显式写出
return null;—— 不能省略，否则仍会报错（即使类型已改为?array，缺失return仍被视为“无返回”，而非null）； - 调用方需做好
null检查：
$result = $iterator->returnArray();
if ($result !== null) {
foreach ($result as $item) {
echo $item . PHP_EOL;
}
} else {
echo "Iterator is still valid; no final array available yet.\n";
}⚠️ 注意事项：
- 不要误用
void：public function returnArray(): void表示“该方法绝不返回任何值”，此时连return null;都非法； - 若业务逻辑中“不满足条件时必须返回空数组而非
null”，则应统一返回[]，并保持: array声明； - IDE 和静态分析工具（如 PHPStan、Psalm）能基于
?array自动推导空值风险，提升代码健壮性。
总之，PHP 没有 none 类型，但通过 ?T（可空类型）可精准建模“可能无值”的语义——这是现代 PHP 类型安全实践的核心习惯之一。
