如何在Laravel中访问表字段metadata内的对象数组

API 探路者

2026-5-9

在Laravel/PHP中访问数据库metadata字段的JSON数组对象

嘿，这个场景我日常开发里经常碰到，给你分享两种最实用的处理方式，上手很简单~

方法一：用Laravel模型的`$casts`自动转换（强烈推荐）

Laravel的模型自带字段类型转换功能，能自动把数据库里的JSON字符串转成PHP数组，省去手动解码的麻烦。

只需要在对应的模型（比如你的模型叫Product）里添加$casts属性：

class Product extends Model
{
    protected $casts = [
        'metadata' => 'array', // 告诉Laravel自动将该字段转为数组
    ];
}

之后获取模型实例后，直接通过->metadata就能拿到数组，想怎么操作都可以：

// 获取目标模型实例
$product = Product::find(1);

// 遍历数组里的每一项数据
foreach ($product->metadata as $item) {
    echo "{$item['title']}: {$item['value']}";
    // 会依次输出：Type: Hard Drive (HDD)、Condition: Used
}

// 如果想快速定位某个特定title的value，用Laravel集合更高效
$metadataCollection = collect($product->metadata);
$conditionValue = $metadataCollection->firstWhere('title', 'Condition')['value'];
echo $conditionValue; // 输出 Used

方法二：手动解码JSON字符串（适合临时场景）

如果不想修改模型，或者只是临时处理单次查询结果，可以用json_decode手动把JSON字符串转成数组：

$product = Product::find(1);
// 第二个参数传true，将JSON对象转为PHP关联数组（不传的话会得到stdClass对象）
$metadata = json_decode($product->metadata, true);

// 后续访问逻辑和上面一致
if (!empty($metadata)) {
    foreach ($metadata as $item) {
        echo "{$item['title']}: {$item['value']}";
    }
}