Laravel模型隐藏属性？属性如何隐藏排除？-Laravel-PHP中文网

Laravel模型隐藏属性？属性如何隐藏排除？

小老鼠

发布： 2025-09-11 09:38:01

原创

1037人浏览过

最直接的方法是使用模型中的$hidden数组来隐藏敏感属性，如password和remember_token，防止序列化时泄露；还可通过$visible指定仅显示的字段，结合makeVisible()和makeHidden()实现动态控制，兼顾灵活性与安全性，有效保护敏感数据并满足最小权限原则。

laravel模型隐藏属性？属性如何隐藏排除？

Laravel模型中隐藏属性，最直接也最常用的方法，就是通过在模型类里定义一个

$hidden

登录后复制

数组。你把不希望被序列化（比如转换成JSON或数组）的属性名放进去，Laravel在处理模型实例的时候就会自动把它们排除掉，这对于保护敏感数据或者简化API响应非常有用。

解决方案

说实话，我个人觉得Laravel处理模型属性隐藏的方式，既直接又优雅。当你有一个

User

登录后复制

模型，里面可能存着

password

登录后复制

或者

remember_token

登录后复制

这种不应该随便暴露出去的字段，你只需要在模型里这么写：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * The attributes that should be hidden for serialization.
     *
     * @var array
     */
    protected $hidden = [
        'password',
        'remember_token',
        // 任何你不想在序列化时出现的字段
        'email_verified_at', // 比如这个字段，可能在某些场景下也不需要
    ];

    // ... 其他模型定义
}

登录后复制

这样一来，无论你什么时候把

User

登录后复制

模型转换成数组 (

toArray()

登录后复制

) 或者JSON (

toJson()

登录后复制

)，

password

登录后复制

和

remember_token

登录后复制

这些字段都不会出现在结果里。这就像给你的模型数据加了一层“隐私模式”，默认情况下，这些字段就是隐形的。

当然，除了

$hidden

登录后复制

，还有一个

$visible

登录后复制

属性，它的作用是相反的。如果你想默认只显示模型中的少数几个属性，其他全部隐藏，那么使用

$visible

登录后复制

会更方便。比如，你只想显示

id

登录后复制

和

name

登录后复制

，其他一概不显示，你可以这么做：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Product extends Model
{
    /**
     * The attributes that should be visible in serialization.
     *
     * @var array
     */
    protected $visible = [
        'id',
        'name',
        // 只有这些字段会被序列化
    ];

    // ...
}

登录后复制

我个人经验是，对于大多数应用，使用

$hidden

登录后复制

更常见，因为我们通常是想隐藏少数几个敏感或不必要的字段，而不是只暴露少数几个。但是，如果你的模型字段非常多，而你又只需要在API响应中提供极简的数据，那么

$visible

登录后复制

确实能省不少事。

如何在Laravel模型中动态控制属性的可见性？

有时候，我们不能一概而论地隐藏某个属性。业务场景总是多变的，比如，一个管理员查看用户详情时可能需要看到

email_verified_at

登录后复制

，而普通用户查看时就不需要。这种动态控制的需求，Laravel也考虑到了。

我们可以利用模型实例上的

makeVisible()

登录后复制

和

makeHidden()

登录后复制

方法。这两个方法允许你在模型实例被序列化之前，临时改变其属性的可见性。

举个例子，你有一个

User

登录后复制

模型，

email_verified_at

登录后复制

默认是隐藏的：

class User extends Model
{
    protected $hidden = [
        'password',
        'remember_token',
        'email_verified_at',
    ];
    // ...
}

登录后复制

但在某个特定控制器方法里，你希望管理员能看到

email_verified_at

登录后复制

：

public function showAdminUser(User $user)
{
    // 临时显示 email_verified_at
    $user->makeVisible(['email_verified_at']);

    return response()->json($user); // 此时JSON中会包含 email_verified_at
}

public function showPublicUser(User $user)
{
    // 保持默认隐藏，或者明确隐藏一些通常可见的字段
    $user->makeHidden(['created_at', 'updated_at']); // 假设这些是默认可见的

    return response()->json($user); // 此时JSON中不包含 created_at, updated_at
}

登录后复制

makeVisible()

登录后复制

和

makeHidden()

登录后复制

方法会返回模型实例本身，所以你可以链式调用它们。这给了我们极大的灵活性，特别是在构建API时，可以根据不同的用户角色或请求上下文，动态调整返回数据的结构。我发现这个特性在处理一些复杂权限系统时特别好用，避免了为不同权限等级写多套数据转换逻辑。

Laravel模型序列化时如何临时显示或隐藏属性？

除了

makeVisible()

登录后复制

和

makeHidden()

登录后复制

之外，还有一些场景，比如你可能想在序列化时“追加”一些模型本身没有，但通过访问器 (

Accessor

登录后复制

) 计算出来的属性，或者在特定情况下，你真的需要强制包含某个通常被隐藏的属性。

Laravel的

append

登录后复制

属性和

setAppends()

登录后复制

方法就是为此而生。

盘古大模型

华为云推出的一系列高性能人工智能大模型

查看详情

首先是

append

登录后复制

属性。如果你有一些访问器（getFooAttribute）生成的属性，你希望它们在模型被序列化时自动包含进去，可以在模型里定义

$appends

登录后复制

数组：

class User extends Model
{
    protected $hidden = [
        'password',
        'remember_token',
    ];

    // 定义一个访问器
    public function getIsAdminAttribute()
    {
        return $this->attributes['role'] === 'admin';
    }

    /**
     * The accessors to append to the model's array form.
     *
     * @var array
     */
    protected $appends = [
        'is_admin', // 这个访问器会在序列化时自动加入
    ];
    // ...
}

登录后复制

这样，当你获取

User

登录后复制

模型并将其转换为数组或JSON时，

is_admin

登录后复制

字段就会自动出现。

而

setAppends()

登录后复制

方法则允许你在模型实例层面动态地添加或移除这些“追加”的属性。

$user = User::find(1);

// 临时追加一个属性
$user->setAppends(['full_name']); // 假设你有一个 getFullNameAttribute() 访问器
return $user->toJson();

// 移除所有追加的属性
$user->setAppends([]);
return $user->toJson();

登录后复制

更进一步，如果你只是想在一次性的序列化操作中，强制显示某个通常被隐藏的属性，但又不想修改模型的