本文介绍使用 laravel 模型访问器（accessors）和修改器（mutators）实现敏感字段（如 email、phone、password）的自动加解密，使 select 返回明文、insert/update 自动加密，零侵入现有业务代码。
本文介绍使用 laravel 模型访问器（accessors）和修改器（mutators）实现敏感字段（如 email、phone、password）的自动加解密，使 select 返回明文、insert/update 自动加密，零侵入现有业务代码。
在 Laravel 应用中，当已有大量业务逻辑直接操作数据库字段（如 SELECT * FROM users 或 INSERT INTO users (...)），又需对敏感字段（如 email、phone、password）实施透明加解密时，最佳实践是利用 Eloquent 的 访问器（Accessor）与修改器（Mutator） 机制，配合 Laravel 内置的 encrypt() / decrypt() 辅助函数。该方案无需修改 SQL 查询、不依赖数据库层加密、也不需要重写控制器或服务层代码，真正实现“自动”加解密。
✅ 核心实现原理
- 写入时（INSERT/UPDATE）：通过 set{Column}Attribute 修改器，在数据存入模型属性前自动加密，并赋值给底层 $attributes 数组；
- 读取时（SELECT/toArray）：通过 get{Column}Attribute 访问器，在获取属性值时自动解密并返回明文；
- 所有 Eloquent 操作（包括 Model::create()、$user->email = '...'、$user->save()、User::find()、$user->email 等）均自动生效。
? 示例：为 users 表配置自动加解密
假设 User 模型对应 users 表，需对 email、phone、password 字段启用自动加解密：
<?php namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
// 可选：显式声明加密字段不被批量赋值（增强安全性）
protected $guarded = [];
// —— 加密写入逻辑 ——
public function setEmailAttribute($value)
{
$this->attributes['email'] = $value === null ? null : encrypt($value);
}
public function setPhoneAttribute($value)
{
$this->attributes['phone'] = $value === null ? null : encrypt($value);
}
public function setPasswordAttribute($value)
{
// 注意：password 字段通常应使用 Hash::make() 而非 encrypt()
// 此处仅作演示；生产环境密码请始终用 bcrypt
$this->attributes['password'] = $value === null ? null : encrypt($value);
}
// —— 解密读取逻辑 ——
public function getEmailAttribute($value)
{
return $value === null ? null : decrypt($value);
}
public function getPhoneAttribute($value)
{
return $value === null ? null : decrypt($value);
}
public function getPasswordAttribute($value)
{
return $value === null ? null : decrypt($value);
}
}
✅ 效果验证：
// INSERT 自动加密
User::create([
'user_name' => 'test',
'email' => 'test@example.com',
'phone' => '123-456-7890',
'password' => 'plain-pass'
]);
// → 数据库中 email/phone/password 均为加密字符串
// SELECT 自动解密
$user = User::first();
echo $user->email; // 输出: test@example.com（明文）
echo $user->phone; // 输出: 123-456-7890（明文）
$user->toArray(); // 所有加密字段均以明文形式序列化
⚠️ 重要注意事项
- 不可搜索性：加密后字段在数据库中为密文，WHERE email = ? 等原生查询将失效。如需模糊搜索，需额外设计（如添加哈希索引列或使用可搜索加密方案）；
- 密钥安全：Laravel 的 encrypt() 依赖 APP_KEY，务必确保其强随机性且严格保密（切勿提交至 Git）；
- 密码字段特殊处理：password 字段绝不应使用 encrypt()——它不是密码哈希！请始终使用 Hash::make($password) 并配合 Auth::attempt() 验证；
- NULL 安全：访问器/修改器中显式判断 null，避免 decrypt(null) 抛出异常；
- 性能考量：加解密发生在 PHP 层，对高频读写场景建议结合缓存优化。
✅ 总结
通过 Eloquent 访问器与修改器，你能在不触碰任何已有 SQL、API 或前端代码的前提下，为指定字段无缝集成透明加解密能力。这是 Laravel 生态中兼顾安全性、开发效率与向后兼容性的标准解决方案。只需在模型中定义几行方法，即可让 SELECT 返回明文、INSERT/UPDATE 自动加密——真正的“零改造升级”。
