PHP函数无return时默认返回NULL；void类型表示不返回值但不可返回任意值；返回数组需结构一致；类型声明须与实际返回值严格匹配。
函数没 return 时返回什么
PHP 函数体末尾没写 return，默认返回 NULL——不是空字符串、不是 false、也不是未定义，就是字面量 NULL。这个值在松散比较（==）里容易“消失”，比如 if ($res == '') 或 if (!$res) 可能误判，但严格比较（===）下立刻暴露问题。
常见错误现象：json_encode(get_user_data()) 返回 null，前端解析失败；或调用后直接 echo $result['name'] 触发 Notice: Trying to access array offset on value of type null。
- 所有分支路径都必须有明确的
return，尤其含if/else或异常提前退出的函数 - 如果逻辑上确实“无返回值”，显式写
return null;，比留空更可控 - 用 PHPStan 或 Psalm 静态分析时，未声明返回类型的函数会被推断为
mixed，后续类型检查失效
void 类型和空返回值的语义区别
PHP 7.1+ 支持 void 返回类型声明，但它不等于“不返回”——而是表示“不关心返回值”，且函数体内禁止使用 return $value;，只允许 return; 或隐式结束。
使用场景：纯副作用函数，如日志记录、缓存写入、数据库更新。一旦声明 void，调用时再拿返回值就报 Fatal error: A void function must not return a value。
立即学习“PHP免费学习笔记（深入）”；
-
function save_log(string $msg): void { file_put_contents('log.txt', $msg); }—— 合法 -
function save_log(string $msg): void { return 'ok'; }—— 致命错误 - 不要用
void去“掩盖”本该返回状态的函数，比如delete_user(int $id): void就不如delete_user(int $id): bool清晰
返回数组时键名和结构要稳定
PHP 函数返回数组，常被当作“轻量级对象”用，但键名拼写错误、条件分支导致键缺失、或混用数字索引与关联键，会直接让调用方崩溃。
典型错误：get_user_info($id) 在用户不存在时返回空数组 []，而存在时返回 ['user_id' => 123, 'name' => 'Alice']，调用方 $info['name'] 直接 Notice。
- 统一用关联数组，避免混合索引；键名全部小写 + 下划线，不随环境变化
- 空/失败情况也返回结构一致的数组，比如
['user_id' => null, 'name' => '']或抛出异常，而不是[]或false - 若需多态返回（如成功返回数组、失败返回
false），必须在文档和类型注解中明确，并强制调用方先判断is_array($res)
类型声明与实际返回值不一致的坑
写了 function count_items(): int，但函数里可能抛异常、或某些分支漏了 return，最终返回 NULL，PHP 8+ 会触发 TypeError；PHP 7.x 则静默转成 0，埋下逻辑错乱隐患。
性能影响：启用严格类型（declare(strict_types=1)）后，类型校验在运行时发生，开销极小，但能拦住绝大多数低级错误。
- 开启
strict_types=1是底线，别依赖“自动转换” - 返回联合类型（如
string|int|null）要谨慎——它代表你接受多种结果，调用方就必须处理每种可能 - 用
@returnPHPDoc 注释补充说明（比如 “@return array{status: string, data: mixed}”），IDE 和静态分析工具才看得懂结构
最麻烦的不是写错 return，而是不同开发者对“失败怎么返回”没共识：有人 throw，有人 return false，有人 return []，有人静默 NULL。接口边界一旦模糊，后面所有人都是在填坑。
