如何在类中通过方法累积字符串与数组值到单个属性数组

本文介绍如何设计一个 php 类方法，将传入的字符串或数组统一追加到类的数组属性中，避免每次调用都生成独立数组，最终实现所有用户数据汇聚为一个扁平化数组。

在面向对象开发中，常需构建可累积数据的类（如用户管理器）。原始代码中，add() 方法每次都在局部创建新数组 $arr 并 print_r 输出，导致无法跨调用持久化数据——这是核心问题：缺少类级别的状态存储。

正确做法是将用户列表声明为类的公共（或受保护）属性，并在 add() 中直接向该属性追加内容。php 提供了简洁高效的解决方案：

• 使用 (Array) 强制类型转换：无论输入是字符串（如 ‘Alice’）还是数组（如 [‘Bob’, ‘Charlie’]），(array)$stringorArray 均能安全转为数组（字符串 → [‘Alice’]，原数组保持不变）；
• 利用 …（展开运算符）配合 array_push()，将转换后的数组“解包”为参数列表，一次性追加多个元素。

以下是优化后的完整实现：

class Users {     public $listOfUsers = [];      public function add($stringOrArray): void     {         array_push($this->listOfUsers, ...(array)$stringOrArray);     } }

使用示例：

$users = new Users(); $users->add('Terrell Irving'); $users->add('Magdalen Sara Tanner'); $users->add('Chad Niles'); $users->add(['Mervin Spearing', 'Dean Willoughby', 'David Prescott']);  // 查看最终合并结果 var_export($users->listOfUsers);

输出为单一扁平数组：

array (   0 => 'Terrell Irving',   1 => 'Magdalen Sara Tanner',   2 => 'Chad Niles',   3 => 'Mervin Spearing',   4 => 'Dean Willoughby',   5 => 'David Prescott', )

✅ 关键优势：

• 无冗余条件判断，逻辑更健壮；
• 自动兼容混合调用（单字符串、多字符串数组、嵌套调用）；
• 时间复杂度为 O(n)，array_push(…) 内部高效处理批量追加。

⚠️ 注意事项：

• 若需严格类型控制，可将属性设为 private 并提供 getUsers(): array 访问器；
• …(array)$x 对 NULL 或对象会触发警告，如需更强容错，可先用 is_scalar() 或 is_iterable() 做预检；
• PHP 版本需 ≥ 5.6（支持展开运算符）或 ≥ 7.4（推荐使用严格类型声明）。

通过这一设计，Users 类真正实现了数据的累积式收集，为后续去重、过滤、序列化等操作奠定了清晰的数据基础。