0

0

在 Laravel 中安全高效地更新或添加数组值

DDD

DDD

发布时间:2025-09-27 09:56:01

|

1016人浏览过

|

来源于php中文网

原创

在 Laravel 中安全高效地更新或添加数组值

本文旨在解决 Laravel 应用中向模型数组字段添加新值时数据被覆盖的问题。我们将深入探讨 Laravel 的数组类型转换机制,并提供一种健壮的方法,确保在不丢失现有数据的情况下,向数据库中存储的数组字段追加新元素,同时考虑避免重复添加。

理解 Laravel 的数组类型转换

laravel 提供了强大的模型属性类型转换(casting)功能,允许我们将数据库中的某些字段(如 text 或 json 类型)自动转换为 php 数组。在 recruitment 模型中,protected $casts = ['applicants' => 'array']; 这一行代码至关重要。它告诉 laravel,每当从数据库中检索 applicants 字段时,应将其存储的 json 字符串(或可序列化的文本)解析为 php 数组;而在保存到数据库时,则将 php 数组自动序列化为 json 字符串。

原始的数据库迁移使用了 text 类型来存储 applicants 字段:

public function up()
{
    Schema::create('recruitments', function (Blueprint $table) {
        // ... 其他字段 ...
        $table->text('applicants')->nullable(); // 使用 text 类型存储数组数据
        // ...
    });
}

尽管使用了 text 类型而非 json 类型(可能由于旧版数据库兼容性),Laravel 的 array 类型转换依然能正常工作,因为它会在内部进行 JSON 编码和解码。

识别数据覆盖问题

在原始的控制器逻辑中,添加申请人的方法如下:

public function addApplicant($id, Request $reqst){
    $job = Recruitment::find($id);
    $user[] = $reqst->user_id; // 创建一个只包含当前 user_id 的新数组

    $job->applicants = $user; // 将 $job->applicants 属性直接赋值为这个新数组
    $job->save();

    return redirect()->back();
}

问题出在 $user[] = $reqst->user_id; 和 $job->applicants = $user; 这两行。

  1. $user[] = $reqst->user_id; 实际上创建了一个新的数组,例如 [123]。
  2. $job->applicants = $user; 这一步将 Recruitment 模型的 applicants 属性完全替换为这个新创建的数组 [123]。 这意味着,无论之前 applicants 字段中存储了多少申请人ID,都会被新的单个申请人ID组成的数组所覆盖。因此,每次有新用户申请时,旧的申请人数据就会丢失。

正确地向数组字段追加数据

要正确地向 applicants 字段追加新的用户ID,我们需要先获取现有的申请人列表,然后将新的ID添加到这个列表中,最后再将更新后的列表保存回模型。

以下是修正后的 addApplicant 控制器方法:

applicants ?? [];

        // 3. 获取要添加的新申请人ID
        // 假设 user_id 是从表单中提交的,或者直接使用 Auth::id()
        $newUserId = $request->user_id; // 或者 $newUserId = Auth::id();

        // 4. 检查申请人是否已存在,避免重复添加
        if (!in_array($newUserId, $applicants)) {
            $applicants[] = $newUserId; // 将新用户ID添加到数组中
        } else {
            // 可选:如果用户已经申请过,可以返回一个提示信息
            session()->flash('info', '您已申请过此职位。');
            return redirect()->back();
        }

        // 5. 将更新后的申请人数组重新赋值给模型属性
        // Laravel 的 array cast 会自动将此 PHP 数组序列化为 JSON 字符串并保存
        $job->applicants = $applicants;
        $job->save();

        session()->flash('success', '申请成功!'); // 添加成功提示
        return redirect()->back();
    }
}

代码解释:

  • Recruitment::findOrFail($id);:使用 findOrFail 代替 find,当找不到指定ID的记录时,会自动抛出 ModelNotFoundException,避免后续操作出现空指针错误。
  • $applicants = $job->applicants ?? [];:这是关键一步。由于 applicants 字段被模型 cast 为 array,当我们访问 $job->applicants 时,Laravel 会自动将其从数据库中的 JSON 字符串反序列化为 PHP 数组。如果该字段在数据库中为 NULL,则 $job->applicants 将为 null,此时 ?? [] 会将其初始化为空数组,确保后续操作不会出错。
  • $newUserId = $request->user_id;:获取从请求中提交的用户ID。在实际应用中,为了安全起见,通常会直接使用 Auth::id() 来获取当前登录用户的ID,而不是依赖前端传递。
  • if (!in_array($newUserId, $applicants)) { ... }:这是一个重要的优化。它检查 newUserId 是否已经存在于 applicants 数组中。这可以防止同一个用户多次申请同一个职位,导致数组中出现重复的ID。
  • $applicants[] = $newUserId;:将新的用户ID追加到现有申请人数组的末尾。
  • $job->applicants = $applicants;:将修改后的 applicants 数组重新赋值给模型的 applicants 属性。当调用 $job->save(); 时,Laravel 会自动将这个 PHP 数组再次序列化为 JSON 字符串并存储到数据库的 text 字段中。
  • session()->flash(...):添加了会话闪存消息,用于向用户提供操作反馈。

模型和视图的配置确认

Recruitment 模型:

万兴爱画
万兴爱画

万兴爱画AI绘画生成工具

下载
class Recruitment extends Model
{
    use HasFactory;

    protected $fillable = [
        'title', 'salary', 'term_start', 'term_end', 'deadline',
        'details', 'status', 'applicants', // 确保 'applicants' 在 fillable 数组中
    ];

    public function user(){
        return $this->belongsTo(User::class); // 修正命名空间,通常是 User::class
    }

    protected $casts = [
        'applicants' => 'array' // 保持此设置,它是核心
    ];
}

applicants 字段必须在 $fillable 数组中,或者 $guarded 数组中不包含它,以便模型可以批量赋值(如果适用)或直接赋值。protected $casts = ['applicants' => 'array']; 是确保 Laravel 自动处理 JSON 序列化和反序列化的关键。

Blade 模板:

{{ $job->title }}

Created at: {{ $job->created_at }}

Last updated at: {{ $job->updated_at }}

{{-- display job details here --}}
@csrf {{-- 确保 user_id 是当前登录用户的ID,而不是任意文本输入 --}}

Blade 模板中的表单提交的 user_id 应该是一个 hidden 类型的输入字段,并且其值应确认为当前登录用户的ID (Auth::user()->id)。这与控制器中获取 request->user_id 的逻辑相匹配。

总结与最佳实践

通过上述修改,我们成功解决了向 Laravel 模型中数组字段追加数据时数据被覆盖的问题。核心在于:

  1. 利用 Laravel 的 array 类型转换,自动处理 PHP 数组与数据库 JSON 字符串之间的转换。
  2. 在更新数据时,先获取现有数组,追加新元素,再将完整数组重新赋值并保存。
  3. 添加逻辑以避免重复数据。

进一步的最佳实践:

  • 数据库字段类型: 如果您的数据库支持 JSON 类型(如 MySQL 5.7+ 或 PostgreSQL),强烈建议在迁移中使用 $table->json('applicants')->nullable();。这提供了更好的性能和数据库层面的验证,并且 Laravel 的 array cast 也能完美兼容。
  • 多对多关系: 对于更复杂的场景,例如需要存储申请时间、申请状态等额外信息,或者需要查询某个用户申请了哪些职位,将申请人与职位之间的关系建模为多对多(Many-to-Many)关系会是更优的选择。这将涉及创建一个中间表(pivot table),例如 job_applicant,其中包含 job_id 和 user_id,以及其他任何相关字段。
  • 验证: 在控制器中,始终对传入的请求数据进行验证,以确保数据的完整性和安全性。
  • 错误处理: 增加更完善的错误处理机制,例如当职位不存在或用户未登录时。

遵循这些实践,可以构建出更健壮、可维护的 Laravel 应用程序。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

320

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

278

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

373

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

374

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

86

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

67

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

68

2025.08.05

mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

668

2023.06.20

C++ 设计模式与软件架构
C++ 设计模式与软件架构

本专题深入讲解 C++ 中的常见设计模式与架构优化,包括单例模式、工厂模式、观察者模式、策略模式、命令模式等,结合实际案例展示如何在 C++ 项目中应用这些模式提升代码可维护性与扩展性。通过案例分析,帮助开发者掌握 如何运用设计模式构建高质量的软件架构,提升系统的灵活性与可扩展性。

14

2026.01.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 2万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 815人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号