PHP函数需封装多值为数组、对象等单一结构：一、索引数组配合解构；二、关联数组按键取值；三、stdClass轻量封装；四、DTO类强化类型安全；五、引用数组避免拷贝。
PHP函数本身不支持直接返回多个独立值，必须将多个值封装为单一复合结构；数组与对象是最常用、最符合语义的两种封装方式。以下是实现优雅返回的具体方法：
一、返回索引数组并安全解构
索引数组适用于返回顺序固定、含义由位置决定的一组值，如操作结果与提示消息；配合PHP 7.1+的短数组解构语法，可实现简洁赋值，但需确保返回值确为索引数组且长度匹配。
1、在函数中使用方括号语法创建索引数组并return：return [true, 'User updated successfully'];
2、调用时使用短解构语法接收：[$success, $message] = updateUser($id, $data);
立即学习“PHP免费学习笔记（深入）”；
3、若兼容旧版本PHP，改用list()结构：list($success, $message) = updateUser($id, $data);
4、在函数内部所有分支路径均返回同等结构的索引数组，避免部分路径返回null或布尔值导致解构失败。
二、返回关联数组并按键取值
关联数组通过语义化键名明确每个返回项的含义，提升代码可读性与维护性，适合返回字段名明确的数据结构，如用户信息、配置项等；调用方无需记忆顺序，直接通过键访问即可。
1、在函数中构建带描述性键名的数组：return ['user_id' => $id, 'name' => $name, 'email' => $email];
2、调用后立即通过键提取所需字段：$email = getUser($uid)['email'];
3、更安全的做法是先赋值再判断键是否存在：$user = getUser($uid); if (is_array($user) && isset($user['name'])) { $name = $user['name']; }
4、在函数头部添加返回类型声明以增强自文档性：function getUser(int $id): array { ... }
三、返回stdClass对象实现轻量封装
stdClass对象提供比数组更强的属性访问约束和IDE支持，适合临时封装逻辑上属于同一实体的多个字段；无需定义类，开销低，且错误访问会触发Notice而非静默失败。
1、在函数内实例化stdClass并设置属性：$obj = new stdClass(); $obj->code = 200; $obj->data = $result; return $obj;
2、调用方通过箭头语法访问属性：$status = getApiResponse()['code']; // 错误：stdClass不能用[]访问；正确写法：$resp = getApiResponse(); $code = $resp->code;
3、为避免属性拼写错误，可在函数中使用isset()校验关键属性：if (!isset($obj->code, $obj->data)) { throw new RuntimeException('Invalid response object'); }
4、若需类型提示，可配合PHP 8.0+的联合类型声明：function getApiResponse(): stdClass|array { ... }
四、返回自定义DTO类强化类型安全
当返回值构成稳定业务实体（如订单、用户档案），定义专用DTO类能提供完整类型提示、构造约束与方法封装；虽有轻微初始化成本，但显著提升大型项目可维护性与静态分析能力。
1、预先声明一个只含公共属性的DTO类：class UserDTO { public int $id; public string $name; public string $email; }
2、函数中实例化并填充后返回：$dto = new UserDTO(); $dto->id = $row['id']; $dto->name = $row['name']; $dto->email = $row['email']; return $dto;
3、调用时获得完整IDE补全与类型检查：$user = getUserDTO(123); echo $user->name; // IDE可识别该属性
4、配合PHP 8.0+的构造器属性语法进一步简化：class UserDTO { public function __construct(public int $id, public string $name, public string $email) {} }
五、返回引用数组避免大体积数据拷贝
当函数需暴露并允许外部修改一个长期存在的数组（如全局配置缓存、会话数据容器），返回引用可绕过复制开销，确保所有操作作用于同一内存地址；仅适用于明确需要双向同步的场景。
1、函数声明需在返回类型前加&符号：function &getConfigArray() { global $config; return $config; }
2、调用时必须使用引用赋值语法：$cfg = &getConfigArray();
3、后续对$cfg的修改将实时反映到原始$config变量：$cfg['debug'] = true;
4、禁止返回局部变量引用，否则PHP将自动转为副本，失去引用语义：function &bad() { $local = []; return $local; } // 危险！
