PHP函数不能直接返回多个值，需通过数组或对象打包返回；推荐用关联/索引数组，PHP 7.1+支持解构赋值；对象适用于逻辑实体但有开销；避免全局变量、引用参数等反模式。
PHP 函数怎么真正返回多个值
PHP 函数本身不能“直接”返回多个值，return 只能有一个表达式结果。所谓“多值返回”，本质是把多个值打包成一个复合类型再返回——最常用、最自然的方式是返回数组或对象。
用数组返回多个值最稳妥
这是绝大多数场景下的首选。PHP 数组轻量、灵活，支持键名（关联）和索引两种形式，调用方解包也直观。
- 关联数组适合语义明确的返回项，比如
['user_id' => 123, 'status' => 'active']，调用时可直接用键取值 - 索引数组适合顺序固定、含义靠位置约定的场景，比如
[true, 'User created']表示「是否成功 + 消息」 - 注意：PHP 7.1+ 支持“解构赋值”语法，但仅限于数组字面量或
list()/ 短数组解构（[$ok, $msg] = my_func();），前提是函数确实返回了索引数组 - 别在函数里返回
null或布尔值“假装”是多值——这会让调用方无法安全解包，容易触发Notice: Undefined offset
$result = getUserInfo(42);
// 安全写法：先检查
if (is_array($result) && isset($result['name'], $result['email'])) {
$name = $result['name'];
$email = $result['email'];
}
返回对象比数组更清晰但有成本
当多个返回值构成一个逻辑实体（比如数据库查询结果、API 响应结构），定义一个简单类或使用 stdClass 更利于维护和 IDE 提示。
- 自定义类需提前声明，适合长期复用；
stdClass可临时用，但无类型提示、无方法封装 - 对象属性访问比数组键更严格：
$obj->name不会静默失败，错写属性名直接报Notice: Undefined property - 性能上对象略重于数组，但对绝大多数业务逻辑可忽略；若函数被高频调用（如循环内），建议压测对比
- 别为了“看起来高级”而强行用对象包装两个松散值（如
['count' => 5, 'page' => 2]），这时数组更直白
别踩这些坑
很多看似“多值返回”的写法实际埋了雷。
立即学习“PHP免费学习笔记（深入）”；
- 用全局变量或静态变量“返回”额外值——破坏函数纯度，测试困难，多线程/协程下可能错乱
- 依赖引用参数（
&$out）传回值——调用时必须显式传变量，不能传表达式，且语义模糊，易被忽略 - 返回
list()或array_map()等函数结果却没确认结构——比如explode(',', $str)在空字符串时返回['']，不是空数组 - 在 PHP 8+ 中误以为命名参数能用于返回值——命名参数只影响调用，不影响
return行为
真正的难点不在“怎么写”，而在“怎么让调用方安全、无歧义地拿到你要给的那几个值”。数组键名、对象属性名、文档注释，三者对齐才不算完。
