Laravel带外键对象转数组：调用$customer->toArray()能否序列化关联Country对象？

当然可以实现！Laravel提供了多种实用方案，让你在调用toArray()时把关联的Country对象也包含进去，下面是几种常用的方法：

方法1：预加载关联后调用toArray() #

这是最直接的单次场景解决方案，在获取Customer模型时，用with()方法预加载关联的Country，这样toArray()就会自动把关联模型转为数组并嵌套进去：

// 预加载country关联，避免N+1查询
$customer = Customer::with('country')->find($customerId);
// 此时toArray()会包含country的完整数据
$customerArray = $customer->toArray();

方法2：通过模型$appends全局附加关联 #

如果你希望每次调用toArray()都自动带上Country数据，可以在Customer模型中定义$appends属性，配合访问器实现全局生效：

class Customer extends Model
{
    // 指定要附加到序列化结果的字段
    protected $appends = ['country'];

    // 定义与Country的关联关系
    public function country()
    {
        return $this->belongsTo(Country::class);
    }

    // 自定义访问器，返回关联的Country数组
    public function getCountryAttribute()
    {
        // 可按需处理关联不存在的情况
        return $this->country ? $this->country->toArray() : null;
    }
}

⚠️ 注意：这种方式如果没有提前预加载关联，可能会触发N+1查询问题，建议结合with('country')一起使用，或者在访问器里用$this->country()->first()主动控制加载时机。

方法3：使用API资源类（推荐用于API开发） #

如果是做API接口开发，Laravel的API资源类是更规范、灵活的方案，能精准控制序列化的字段、关联和嵌套逻辑：

1. 先创建Customer和Country的资源类：

php artisan make:resource CustomerResource
php artisan make:resource CountryResource

2. 在CustomerResource中定义序列化结构：

class CustomerResource extends JsonResource
{
    public function toArray($request)
    {
        return [
            'id' => $this->id,
            'name' => $this->name,
            'country_id' => $this->country_id,
            // 使用whenLoaded避免未加载关联时返回null或触发不必要的查询
            'country' => new CountryResource($this->whenLoaded('country')),
        ];
    }
}

3. 使用资源类返回数据：

$customer = Customer::with('country')->find($customerId);
return new CustomerResource($customer);

这种方式不仅能灵活控制返回字段，还能处理多层嵌套关联、条件加载等复杂场景，是Laravel API开发的最佳实践。

内容的提问来源于stack exchange，提问作者SexyMF