信息发布→ 登录 注册 退出

Laravel怎么实现模型属性的自动加密

发布时间:2025-12-22

点击量:
通过重写访问器和修改器可实现Laravel模型属性自动加密,使用encryptable数组定义需加密字段,结合encrypt/decrypt函数在存取时自动加解密,并可通过Trait封装复用逻辑,确保敏感数据安全。

在 Laravel 中实现模型属性的自动加密,可以通过重写模型的 setget 访问器来完成。这样可以确保敏感数据(如身份证号、手机号、邮箱等)在存入数据库时自动加密,读取时自动解密,整个过程对业务逻辑透明。

1. 使用访问器和修改器实现自动加密

在 Eloquent 模型中,通过定义访问器(accessor)和修改器(mutator),可以拦截属性的获取与设置操作。

以用户模型 User 为例,假设需要加密 phoneid_card 字段:

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // 定义需要加密的属性
    protected $encryptable = [
        'phone',
        'id_card',
    ];

    // 修改器:在设置属性时自动加密
    public function setAttribute($key, $value)
    {
        if (in_array($key, $this->encryptable)) {
            $value = encrypt($value);
        }

        return parent::setAttribute($key, $value);
    }

    // 访问器:在获取属性时自动解密
    public function getAttribute($key)
    {
        $value = parent::getAttribute($key);

        if (in_array($key, $this->encryptable) && $value) {
            $value = decrypt($value);
        }

        return $value;
    }
}

说明:

  • $encryptable 数组定义了需要加密的字段。
  • Laravel 自带的 encrypt()decrypt() 函数基于 OpenSSL 和 APP_KEY,安全性高。
  • 重写 setAttributegetAttribute 可统一处理所有字段,避免重复代码。

2. 注意事项与优化建议

虽然上述方法简单有效,但需注意以下几点:

  • 加密后的数据不可用于数据库查询(如 WHERE 条件),因为密文每次生成都不同(即使内容相同)。如果需要按加密字段查询,应使用哈希存储(如密码)或考虑其他方案。
  • 避免在加密字段上建立索引或做模糊搜索。
  • 确保 APP_KEY 安全且不泄露,否则加密形同虚设。
  • 可将加密逻辑封装为 Trait,便于多个模型复用:
// app/Traits/Encryptable.php
namespace App\Traits;

trait Encryptable
{
    public function setAttribute($key, $value)
    {
        if (property_exists($this, 'encryptable') && in_array($key, $this->encryptable)) {
            $value = encrypt($value);
        }

        return parent::setAttribute($key, $value);
    }

    public function getAttribute($key)
    {
        $value = parent::getAttribute($key);

        if (property_exists($this, 'encryptable') && in_array($key, $this->encryptable) && $value) {
            $value = decrypt($value);
        }

        return $value;
    }
}

在模型中使用 Trait:

```php class User extends Model { use Encryptable;
protected $encryptable = ['phone', 'id_card'];

}

3. 测试加密效果

你可以通过 Tinker 或单元测试验证加密是否生效:

```bash php artisan tinker
$user = new App\Models\User();
$user->phone = '13800138000';
$user->save();

// 查看数据库中的值(应为加密字符串)
echo $user->getOriginal('phone'); // 类似 "eyJpdiI6I..."

// 读取时自动解密
echo $user->phone; // 输出 "13800138000"

基本上就这些。只要合理使用访问器和修改器,再配合 Trait 封装,Laravel 实现模型属性自动加密并不复杂,但要特别注意加密字段的查询限制和安全性保障。

标签:# class  # 几点  # 可以通过  # 形同虚设  # 多个  # 你可以  # 都不  # 复用  # 重写  # 数据库  # 访问器  # php  # 封装  # 修改器  # 敏感数据  # 邮箱  # ai  # ssl  # access  # app  # laravel  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!