作为 Laravel 开发者，你是否也曾遇到这样的困扰？在构建用户管理系统时，可能需要确保 first_name 和 last_name 的组合是唯一的，而不是单独的 first_name 或 last_name。又或者在电商平台中，一个产品的 SKU 和 color 组合必须是唯一的，以避免数据冗余和业务逻辑混乱。
Laravel 内置的 unique 验证规则非常强大，但它只针对单个数据库字段进行唯一性检查。这意味着，如果我有一个 users 表，其中有 first_name 和 last_name 字段，我不能简单地写 ['first_name' => 'unique:users', 'last_name' => 'unique:users'] 来保证两者的组合唯一。这样做只会检查 first_name 是否唯一，last_name 是否唯一，而不是它们的联合唯一性。
面对这种需求，我们通常会怎么做？手动编写复杂的数据库查询，然后在验证器中加入自定义逻辑？这不仅代码冗余，难以维护，还容易出错。每次遇到类似场景，都要重复造轮子，开发效率大打折扣。当项目规模变大，这种手动处理方式的弊端会更加明显。
引入解决方案：felixkiss/uniquewith-validator
正当我为此烦恼时，felixkiss/uniquewith-validator 这个 Composer 包如同及时雨般出现了。它专门为 Laravel 扩展了 unique_with 验证规则，完美解决了多字段联合唯一性验证的痛点。通过它，我们可以用声明式的方式，像使用 Laravel 原生规则一样，轻松实现复杂的联合唯一性校验。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
安装与配置
安装 felixkiss/uniquewith-validator 非常简单，通过 Composer 即可完成：
composer require felixkiss/uniquewith-validator
安装完成后，别忘了在 config/app.php 文件的 providers 数组中注册其服务提供者：
// config/app.php
'providers' => [
// ...
Felixkiss\UniqueWithValidator\ServiceProvider::class,
],
unique_with 规则的使用
现在，我们就可以像使用 Laravel 原生验证规则一样，使用 unique_with 了！其基本语法如下：
$rules = [
'<field1>' => 'unique_with:<table>,<field2>[,<field3>,...,<ignore_rowid>]',
];让我们通过一个实际例子来演示。假设我们有一个 users 表，其中 first_name 和 last_name 字段需要联合唯一。数据库迁移文件可能如下所示：
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
class CreateUsersTable extends Migration
{
public function up()
{
Schema::create('users', function (Blueprint $table) {
$table->increments('id');
$table->timestamps();
$table->string('first_name');
$table->string('last_name');
$table->unique(['first_name', 'last_name']); // 定义联合唯一索引
});
}
public function down()
{
Schema::dropIfExists('users');
}
}然后，在你的控制器或表单请求中，你可以这样定义验证规则：
<?php
use Illuminate\Support\Facades\Validator;
use Illuminate\Support\Facades\Input; // Laravel 5.x 及以下，Laravel 6+ 使用 request()->all()
use Illuminate\Support\Facades\Redirect;
use Illuminate\Support\Facades\Route;
// 假设在一个路由中处理
Route::post('register-user', function() {
$rules = [
'first_name' => 'required|unique_with:users,last_name',
'last_name' => 'required',
];
// 在 Laravel 6+ 中通常使用 request()->all()
$validator = Validator::make(Input::all(), $rules);
if ($validator->fails()) {
return Redirect::back()->withErrors($validator);
}
// 验证通过，保存用户...
// $user = new User;
// $user->first_name = Input::get('first_name');
// $user->last_name = Input::get('last_name');
// $user->save();
return Redirect::home()->with('success', 'User created!');
});在这个例子中，first_name 字段的 unique_with:users,last_name 规则告诉 Laravel：在 users 表中，first_name 字段的值必须与 last_name 字段的值组合起来是唯一的。
更多高级用法
unique_with 规则还提供了丰富的选项来处理更复杂的场景：
-
指定不同的数据库列名： 如果你的表单字段名和数据库列名不一致，可以明确指定。 例如，表单字段是
last_name，但数据库列是sur_name：$rules = [ 'first_name' => 'unique_with:users, middle_name, last_name = sur_name', ]; -
更新时忽略当前行： 在编辑操作时，我们通常需要忽略当前正在更新的记录。 这将忽略
id为2的行：$rules = [ 'first_name' => 'required|unique_with:users,last_name,2', 'last_name' => 'required', ];如果 ID 列名不是
id，或者 ID 类型不是数字：// 自定义 ID 列名 $rules = [ 'first_name' => 'required|unique_with:users,last_name,2 = custom_id_column', ]; // 非数字 ID $rules = [ 'first_name' => 'required|unique_with:users,last_name,ignore:abc123', ]; -
添加额外查询条件（例如软删除）： 如果你的模型使用了软删除，并且需要将软删除的记录也纳入唯一性检查范围，或者反之，可以添加额外的
where子句。$rules = [ 'first_name' => 'required|unique_with:users,last_name,deleted_at,2 = custom_id_column', ];软删除注意事项： 在 Laravel 5.5+ 的表单请求中，如果
deleted_at字段未在请求中发送，验证可能会跳过它。解决方法是在validationData()方法中合并该字段：protected function validationData() { return array_merge($this->request->all(), [ 'deleted_at' => null // 确保 deleted_at 参与验证 ]); } -
指定数据库连接： 如果你的应用使用了多个数据库连接，也可以为
unique_with规则指定特定的连接。$rules = [ 'first_name' => 'unique_with:some-database.users, middle_name, last_name', ];
优势与实际应用效果
使用 felixkiss/uniquewith-validator 后，我深刻体会到了它的强大和便捷：
- 代码简洁高效： 告别手动编写复杂的数据库查询和条件判断，一行规则即可搞定多字段联合唯一验证，大大减少了冗余代码。
- 与 Laravel 无缝集成： 它完全融入 Laravel 的验证体系，使用体验与原生规则无异，学习成本极低，开发者可以快速上手。
- 功能全面： 无论是忽略当前记录（更新操作）、处理软删除，还是自定义字段名和数据库连接，它都提供了灵活的配置选项，满足各种复杂场景的需求。
- 提升开发效率： 减少了重复性工作，让开发者能更专注于业务逻辑的实现，而非底层的验证细节。
- 增强代码可读性与可维护性： 验证规则清晰明了，一眼就能看出其意图，方便团队协作和后期维护。
总结
总而言之，felixkiss/uniquewith-validator 是 Laravel 开发者处理多字段联合唯一性验证的利器。它将原本繁琐复杂的逻辑简化为一条优雅的验证规则，极大地提升了开发效率和代码质量。如果你也曾被这类问题困扰，不妨尝试一下这个包，相信它会给你带来惊喜！
从此，Laravel 中的多字段联合唯一验证不再是难题，而是信手拈来的小菜一碟！
