PHP 中 stdClass 与数组的选择指南

基础概念

stdClass

stdClass 是 PHP 的一个内置类，用于创建通用对象。它是 PHP 的"空"类，没有预定义的属性和方法，但可以动态添加属性。

$obj = new stdClass();
$obj->property = 'value';

数组

PHP 数组是键值对的集合，可以是索引数组或关联数组。

$array = ['key' => 'value'];

使用场景对比

使用 stdClass 的情况

1. 需要对象语义时 - 当代码需要面向对象特性时
2. JSON 解码为对象时 - json_decode() 默认返回 stdClass 对象
3. 与面向对象代码交互时 - 需要与期望对象的方法或函数配合
4. 需要动态属性时 - 可以方便地添加新属性
5. IDE 支持更好 - 大多数 IDE 对对象属性的自动完成支持更好

使用数组的情况

1. 需要简单数据结构时 - 快速创建和操作
2. 需要数组函数时 - 如 array_map(), array_filter() 等
3. 性能敏感场景 - 数组通常比对象稍快
4. 需要数字索引时 - 特别是顺序数据
5. 需要复杂嵌套结构时 - 数组更容易构建多维结构

性能考虑

• 内存使用：数组通常比对象占用更少内存
• 访问速度：数组访问通常比对象属性访问稍快
• 灵活性：对象可以添加方法，数组不行

代码示例

stdClass 示例

$user = new stdClass();
$user->name = 'John';
$user->age = 30;
$user->email = 'john@example.com';

function greet(stdClass $user) {
    return "Hello, {$user->name}!";
}

数组示例

$user = [
    'name' => 'John',
    'age' => 30,
    'email' => 'john@example.com'
];

function processUser(array $user) {
    return array_map('strtoupper', $user);
}

最佳实践建议

1. 一致性：在项目中保持统一风格
2. 类型提示：如果函数需要特定结构，使用类型提示
3. JSON 处理：考虑使用 json_decode($json, true) 获取数组
4. ORM/数据库结果：许多数据库库返回对象
5. API 设计：对外API更常使用对象/类

转换方法

// 数组转对象
$obj = (object)$array;

// 对象转数组
$array = (array)$obj;

选择使用 stdClass 还是数组主要取决于你的具体需求、代码上下文和个人/团队偏好。