PHP函数返回多个值的简单方法

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]），这时数组更直白

别踩这些坑

很多看似“多值返回”的写法实际埋了雷。

• 用全局变量或静态变量“返回”额外值——破坏函数纯度，测试困难，多线程/协程下可能错乱
• 依赖引用参数（&$out）传回值——调用时必须显式传变量，不能传表达式，且语义模糊，易被忽略
• 返回 list() 或 array_map() 等函数结果却没确认结构——比如 explode(',', $str) 在空字符串时返回 ['']，不是空数组
• 在 PHP 8+ 中误以为命名参数能用于返回值——命名参数只影响调用，不影响 return 行为

真正的难点不在“怎么写”，而在“怎么让调用方安全、无歧义地拿到你要给的那几个值”。数组键名、对象属性名、文档注释，三者对齐才不算完。

以上就是《PHP函数返回多个值的简单方法》的详细内容，更多关于的资料请关注golang学习网公众号！