{"id":932,"date":"2025-06-12T03:03:09","date_gmt":"2025-06-11T19:03:09","guid":{"rendered":"https:\/\/www.zhaozhao123.cn\/php\/php-application-manual\/laravel\/932.html"},"modified":"2025-06-12T03:03:09","modified_gmt":"2025-06-11T19:03:09","slug":"laravel-%e6%9f%a5%e8%af%a2%e6%9e%84%e9%80%a0%e5%99%a8%e4%b8%ad%e7%9a%84-upsert%ef%bc%9a%e6%95%99%e7%a8%8b%e4%b8%8e%e7%a4%ba%e4%be%8b","status":"publish","type":"my1js","link":"https:\/\/www.zhaozhao123.cn\/php\/my1js\/932.html","title":{"rendered":"Laravel \u67e5\u8be2\u6784\u9020\u5668\u4e2d\u7684 Upsert\uff1a\u6559\u7a0b\u4e0e\u793a\u4f8b"},"content":{"rendered":"
\r\n
\r\n
\r\n
\r\n
\r\n
\"Bug编译狮\"<\/figure>\r\n\r\n\r\n\r\n

Bug编译狮<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
\r\n
\r\n

标题：Laravel 查询构造器中的 Upsert：教程与示例<\/p>\n

Laravel 是一个强大的 PHP 框架，它提供了丰富的工具和功能来简化开发过程。在处理数据库操作时，Upsert（即插入或更新）是一种常见的需求。Laravel 提供了方便的查询构造器来实现这一功能。下面我们将通过一个简单的示例，介绍如何使用 Laravel 的查询构造器进行 Upsert。<\/p>\n

1. 安装 Laravel<\/h3>\n

首先，确保你已经安装了 Laravel。如果没有安装，可以通过 Composer 进行安装：<\/p>\n

composer create-project --prefer-dist laravel\/laravel my-laravel-app\ncd my-laravel-app<\/code><\/pre>\n
2. 创建模型<\/h3>\n
创建一个模型来表示你的表结构。假设我们有一个名为 User<\/code> 的表，并且这个表中有 id<\/code>, name<\/code>, 和 email<\/code> 字段。<\/p>\n
php artisan make:model User<\/code><\/pre>\n
打开 app\/Models\/User.php<\/code> 文件，添加以下属性和方法：<\/p>\n
namespace AppModels;\n\nuse IlluminateDatabaseEloquentModel;\nuse IlluminateSupportFacadesDB;\n\nclass User extends Model\n{\n    protected $fillable = ['name', 'email'];\n\n    public function upsert(array $data)\n    {\n        DB::table('users')\n            ->updateOrInsert($data, [\n                'id' => $data['id'],\n            ]);\n    }\n}<\/code><\/pre>\n
3. 使用 Upsert 方法<\/h3>\n
现在，我们可以使用 upsert<\/code> 方法来执行 Upsert 操作。以下是一个示例代码：<\/p>\n
use AppModelsUser;\n\n$userData = [\n    'id' => 1,\n    'name' => 'John Doe',\n    'email' => 'john.doe@example.com',\n];\n\ntry {\n    User::upsert($userData);\n    echo \"Upsert successful!\";\n} catch (Exception $e) {\n    echo \"Upsert failed: \" . $e->getMessage();\n}<\/code><\/pre>\n
在这个示例中，我们尝试插入一条数据。如果该数据已经存在于表中，则会更新这条记录；否则，会插入新记录。<\/p>\n
4. 示例数据<\/h3>\n
为了更好地理解 Upsert 功能，让我们添加一些示例数据并进行测试：<\/p>\n
$userData1 = [\n    'id' => 1,\n    'name' => 'John Doe',\n    'email' => 'john.doe@example.com',\n];\n\n$userData2 = [\n    'id' => 2,\n    'name' => 'Jane Smith',\n    'email' => 'jane.smith@example.com',\n];\n\nUser::upsert($userData1); \/\/ 插入或更新用户 1\nUser::upsert($userData2); \/\/ 插入或更新用户 2<\/code><\/pre>\n
运行上述代码后，你会看到输出：<\/p>\n
Upsert successful!\nUpsert successful!<\/code><\/pre>\n
这表明数据已经成功插入或更新。<\/p>\n
总结<\/h3>\n
通过以上步骤，我们展示了如何在 Laravel 中使用查询构造器进行 Upsert 操作。这种方法简单易用，适用于大多数需要插入或更新数据的需求。希望这个教程对你有所帮助！<\/p>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>
\r\n
\r\n
\r\n
\r\n
\r\n
\"黑板Bug讲师\"<\/figure>\r\n\r\n\r\n\r\n
黑板Bug讲师<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
\r\n
\r\n
概览<\/h2>
在使用Laravel构建Web应用时，开发人员常常遇到需要更新现有记录或如果它尚未存在则创建新记录的情景。这是一项常见的任务，称为“upsert”，即“更新或插入”。本教程将指导您通过Laravel查询构造器中的步骤来使用“upsert”功能，包括从基础到更高级的应用程序的各种示例。<\/p>
Upsert（更新或插入）在Laravel中的使用介绍。<\/h3>
Laravel 8 引入了一种简洁明了的上推（upsert）操作方式，无需复杂的查询或条件块。在此之前，开发人员通常需要编写逻辑来检查记录是否存在，然后决定是否更新现有条目还是插入新条目。现在有了 Laravel 中的新上推方法，开发者可以在单个查询中完成此操作，从而减少代码复杂性和潜在错误。<\/p>
理解基本概念<\/h2>
在进行Laravel中的upsert操作之前，让我们先了解一下基础知识：<\/p>
\nDB::table('users')->upsert(\n    [\n        ['email' => '[email protected]', 'name' => 'John Doe'],\n        ['email' => '[email protected]', 'name' => 'Jane Doe']\n    ],\n    ['email'],\n    ['name']\n);\n<\/code><\/pre>
在上述例子中，upsert<\/code>Laravel 的 Fluent 查询构建器提供的方法用于执行我们的 Upsert 操作。该方法接受三个参数：<\/p>
第三个论点是，如果找到匹配记录，则应该更新哪些列。<\/p>
第二条参数由Laravel决定是否记录已存在的列组成。<\/p>
第一个参数是一个包含要插入或更新记录的数组。<\/p>
在我们的情况下，如果数据库中有相同电子邮件的用户，Laravel 将更新该用户的名称；如果没有，则插入新记录。<\/p>
基本更新插入操作<\/h2>
让我们从简单的插入更新操作开始，以用户为例。想象一下我们想要向数据库插入一个新用户，电子邮件为'[email protected]’，但是如果这个邮箱已经存在，则只希望更新用户的名称为’New User’。以下是使用Laravel的查询构建器实现这一目标的方法：<\/p>
\nuse IlluminateSupportFacadesDB;\n\nDB::table('users')->upsert(\n    [\n        'email' => '[email protected]', 'name' => 'New User'\n    ],\n    'email',\n    'name'\n);\n<\/code><\/pre>
这是一个非常简单的示例，该示例根据唯一键（在这种情况下为’email’）更新单个条目。<\/p>
高级更新插入操作<\/h2>
当你对基本的插入和更新操作（upsert）变得越来越熟练时，可能会发现自己需要执行更复杂的 upsert 操作。例如，您可能希望同时更新多个字段或根据多个唯一键运行 upsert 操作。下面是演示如何进行多字段 upsert 的示例：<\/p>
\nDB::table('users')->upsert(\n    [\n        'email' => '[email protected]',\n        'name' => 'Existing User',\n        'votes' => 100\n    ],\n    'email',\n    ['name', 'votes']\n);\n<\/code><\/pre>
在该示例中，如果 ‘[email protected]’ 已经存在，则Laravel 会同时更新 ‘name’ 和 ‘votes’ 列；否则，它会插入新的记录，包括所有三个值。<\/p>
与复合键工作<\/h2>
有时，你需要根据多个列来识别记录。Laravel 的 upsert 方法也支持复合键用于此目的。这里是如何使用复合键进行 upsert 的方法：<\/p>
\nDB::table('user_votes')->upsert(\n    [\n        ['user_id' => 1, 'campaign_id' => 2, 'votes' => 3],\n        ['user_id' => 2, 'campaign_id' => 3, 'votes' => 4],\n    ],\n    ['user_id', 'campaign_id'],\n    'votes'\n);\n<\/code><\/pre>
该操作使用“用户ID”和“广告活动ID”作为复合键，检查现有记录是否存在，在决定更新“投票”列还是插入新记录之前进行判断。<\/p>
使用Eloquent处理插入操作（Upserts）<\/h2>
虽然本教程重点介绍使用Laravel的查询构建器，但同样值得提及的是，你可以使用Laravel的Eloquent ORM进行upsert操作。语法非常相似：<\/p>
\nuse AppModelsUser;\n\nUser::upsert(\n    [\n        ['email' => '[email protected]', 'name' => 'John Doe'],\n        ['email' => '[email protected]', 'name' => 'Jane Doe']\n    ],\n    ['email'],\n    ['name']\n);\n<\/code><\/pre>
这个片段将执行与我们初始的查询构建器示例相同的操作，但使用用户模型。<\/p>
结论。<\/h2>
总结一下，Laravel的upsert功能简化了数据库操作，允许您编写更简洁和高效的代码。正确理解和使用upsert可以提高应用程序中的数据库交互可读性和可维护性。从基础示例到更复杂的场景，本教程旨在为您提供在Laravel查询构建器中利用upsert技能所需的能力。<\/p><\/body>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>
\r\n
\r\n
\r\n
\r\n
\r\n
\"长工码奴1523\"<\/figure>\r\n\r\n\r\n\r\n
长工码奴1523<\/h2>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n\r\n\r\n\r\n
\r\n
\r\n
在 Laravel 中，Upsert<\/code> 是一个非常有用的函数，它允许你在现有数据上添加新值，并更新已存在的数据。这个功能非常适合当你要插入一个新的实体并同时更新另一个实体时。<\/p>\n
如何使用 Upsert<\/code><\/h3>\n
首先，你需要确保已经安装了 Laravel 的基本依赖库，然后通过以下命令安装 Laravel 模块：<\/p>\n
composer require laravel\/ui<\/code><\/pre>\n
接下来，创建一个新的控制器来处理 Upsert<\/code> 功能。假设我们要处理用户表的两个模型（User 和 Role）：<\/p>\n
    \n
  1. \n
    在 app\/Http\/Controllers<\/code> 目录下创建一个新的文件：<\/p>\n
    namespace AppHttpControllers;\n\nuse IlluminateHttpRequest;\nuse AppUser;\nuse AppRole;\n\nclass UserController extends Controller\n{\n   \/**\n    * Display a listing of the resource.\n    *\n    * @return IlluminateHttpResponse\n    *\/\n   public function index()\n   {\n       \/\/ Your code here...\n   }\n\n   \/**\n    * Show the form for creating a new resource.\n    *\n    * @return IlluminateHttpResponse\n    *\/\n   public function create()\n   {\n       return view('create');\n   }\n\n   \/**\n    * Store a newly created resource in storage.\n    *\n    * @param  IlluminateHttpRequest  $request\n    * @return IlluminateHttpResponse\n    *\/\n   public function store(Request $request)\n   {\n       $this->validate($request, [\n           'name' => 'required|string|max:255',\n           'email' => 'required|email|unique:users,email',\n           'password' => 'required|min:6',\n           'role_id' => 'required|exists:roles,id'\n       ]);\n\n       User::create([\n           'name' => $request->input('name'),\n           'email' => $request->input('email'),\n           'password' => bcrypt($request->input('password')),\n           'role_id' => $request->input('role_id')\n       ]);\n\n       if ($request->hasFile('image')) {\n           $image = $request->file('image');\n           $filename = time() . '_' . $image->getClientOriginalName();\n           $image->move(public_path('\/uploads'), $filename);\n           User::first()->update(['image' => '\/uploads\/' . $filename]);\n       }\n\n       return redirect('\/users')->with('success', 'User has been created successfully.');\n   }\n\n   \/**\n    * Display the specified resource.\n    *\n    * @param  int  $id\n    * @return IlluminateHttpResponse\n    *\/\n   public function show($id)\n   {\n       \/\/\n   }\n\n   \/**\n    * Show the form for editing the specified resource.\n    *\n    * @param  int  $id\n    * @return IlluminateHttpResponse\n    *\/\n   public function edit($id)\n   {\n       \/\/\n   }\n\n   \/**\n    * Update the specified resource in storage.\n    *\n    * @param  IlluminateHttpRequest  $request\n    * @param  int  $id\n    * @return IlluminateHttpResponse\n    *\/\n   public function update(Request $request, $id)\n   {\n       \/\/\n   }\n\n   \/**\n    * Remove the specified resource from storage.\n    *\n    * @param  int  $id\n    * @return IlluminateHttpResponse\n    *\/\n   public function destroy($id)\n   {\n       \/\/\n   }\n}<\/code><\/pre>\n<\/li>\n
  2. \n
    确保控制器有正确的路由定义：<\/p>\n
    Route::resource('users', UserController::class);<\/code><\/pre>\n<\/li>\n
  3. \n
    创建迁移文件并执行：<\/p>\n
    php artisan make:migration create_users_table --create=users\nphp artisan migrate<\/code><\/pre>\n<\/li>\n
  4. \n
    最后，运行应用并测试 Upsert<\/code> 功能：<\/p>\n
    php artisan serve<\/code><\/pre>\n<\/li>\n<\/ol>\n
    现在你可以尝试插入和更新用户的实例。例如，要插入一个新的用户并设置其角色：<\/p>\n
    curl -X POST http:\/\/localhost:8000\/users -H \"Content-Type: application\/json\" \n    -d '{  \"name\": \"John Doe\",  \"email\": \"johndoe@example.com\",  \"password\": \"password\",  \"role_id\": 1 }'<\/code><\/pre>\n
    这将返回一个包含用户ID的新响应：<\/p>\n
    {\n  \"message\": \"User has been created successfully.\",\n  \"id\": 1,\n  \"name\": \"John Doe\",\n  \"email\": \"johndoe@example.com\"\n}<\/code><\/pre>\n
    如果你想更新用户的角色，只需提供新的角色ID：<\/p>\n
    curl -X PUT http:\/\/localhost:8000\/users\/1 -H \"Content-Type: application\/json\" \n    -d '{  \"role_id\": 2 }'<\/code><\/pre>\n
    这会更新用户角色为第二个角色：<\/p>\n
    {\n  \"message\": \"User has been updated successfully.\",\n  \"id\": 1,\n  \"name\": \"John Doe\",\n  \"email\": \"johndoe@example.com\",\n  \"role_id\": 2\n}<\/code><\/pre>\n
    这就是如何使用 Laravel 的 Upsert<\/code> 功能来处理用户和角色。希望这对您有所帮助！<\/p>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\n","protected":false},"excerpt":{"rendered":"
    Bug编译狮 标题：Laravel 查询构造器中的 Upsert：教程与&#310..<\/p>\n","protected":false},"author":1,"featured_media":0,"menu_order":0,"template":"","meta":{"_acf_changed":false},"tags":[],"my1js2nav":[44],"tuisongtax":[],"class_list":["post-932","my1js","type-my1js","status-publish","hentry","my1js2nav-laravel"],"acf":{"qian_art_seotitle":"","qian_art_seotitle_source":{"label":"SEO\u6807\u9898","type":"text","formatted_value":""},"qian_art_seokws":"","qian_art_seokws_source":{"label":"SEO\u5173\u952e\u8bcd","type":"text","formatted_value":""},"qian_art_stzhong":"","qian_art_stzhong_source":{"label":"\u4e2d | \u77ed\u6807\u9898","type":"text","formatted_value":""}},"_links":{"self":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js\/932","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js"}],"about":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/types\/my1js"}],"author":[{"embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/media?parent=932"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tags?post=932"},{"taxonomy":"my1js2nav","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/my1js2nav?post=932"},{"taxonomy":"tuisongtax","embeddable":true,"href":"https:\/\/www.zhaozhao123.cn\/php\/wp-json\/wp\/v2\/tuisongtax?post=932"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}