在Laravel的表单验证体系中，exists验证规则常用于校验某个字段的值是否存在于数据库指定表的对应列中，默认仅支持单字段的等值匹配。当业务需要校验多个字段中任意一个满足条件即视为通过验证时，就需要实现多列OR逻辑的exists查询。
方法一：自定义验证规则实现多列OR查询
自定义验证规则是最灵活的实现方式，开发者可以完全控制查询逻辑，适配各种复杂条件。首先需要在验证器中定义自定义规则，然后在验证时使用该规则。
定义自定义验证规则
可以在服务提供者或者验证器类中注册自定义规则，以下是在控制器中直接定义的示例：
<?php
namespace AppHttpControllers;
use IlluminateHttpRequest;
use IlluminateSupportFacadesValidator;
use IlluminateValidationRule;
class TestController extends Controller
{
public function validateData(Request $request)
{
// 自定义exists多列OR验证规则
$validator = Validator::make($request->all(), [
'user_identifier' => [
'required',
function ($attribute, $value, $fail) {
// 校验user_identifier是否存在于users表的email或者phone列中
$exists = DB::table('users')
->where(function ($query) use ($value) {
$query->where('email', $value)
->orWhere('phone', $value);
})
->exists();
if (!$exists) {
$fail('该用户标识不存在');
}
}
]
]);
if ($validator->fails()) {
return response()->json($validator->errors(), 422);
}
return response()->json(['message' => '验证通过']);
}
}
自定义规则的适用场景
这种方式适合验证逻辑复杂、需要额外处理查询条件的情况，比如还需要添加软删除过滤、状态过滤等条件。例如需要排除已删除的用户，只需要在查询中添加->whereNull('deleted_at')即可。
方法二：扩展exists规则参数支持OR逻辑
如果项目中多处需要使用多列OR的exists验证，可以扩展Laravel自带的exists规则，让其支持传入多个列名，自动生成OR查询条件。
创建自定义规则类
首先创建一个自定义规则类，继承IlluminateValidationRulesExists规则：
<?php
namespace AppRules;
use IlluminateValidationRulesExists;
class ExistsOr extends Exists
{
protected $orColumns = [];
public function orColumns(array $columns)
{
$this->orColumns = $columns;
return $this;
}
public function query($query)
{
parent::query($query);
if (!empty($this->orColumns)) {
$value = $this->getValue();
$query->where(function ($q) use ($value) {
foreach ($this->orColumns as $column) {
$q->orWhere($column, $value);
}
});
}
}
}
使用扩展后的规则
在验证器中可以直接调用扩展后的规则，传入需要OR匹配的列名：
<?php
namespace AppHttpControllers;
use IlluminateHttpRequest;
use AppRulesExistsOr;
class UserController extends Controller
{
public function store(Request $request)
{
$request->validate([
'account' => [
'required',
(new ExistsOr('users'))->orColumns(['email', 'phone'])
]
]);
// 验证通过后的业务逻辑
return response()->json(['message' => '账号验证通过']);
}
}
两种方法的对比
可以通过以下表格对比两种实现方式的优缺点，方便开发者根据场景选择：
| 实现方式 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 自定义验证规则 | 逻辑灵活，可添加任意额外条件 | 重复使用时需要重复编写逻辑，代码冗余 | 单次使用、逻辑复杂的验证场景 |
| 扩展exists规则类 | 可复用性强，使用方式与原生规则一致 | 需要扩展规则类，初期有一定开发成本 | 多处使用多列OR验证的场景 |
注意事项
- 使用多列OR验证时，需要确保查询的表已经被正确配置数据库连接，避免查询报错。
- 如果OR的列有不同的数据类型，需要提前做好类型转换，保证查询条件匹配正确。
- 自定义规则中如果需要获取当前验证的其他字段值，可以通过
$validator->getData()获取所有请求数据。
通过以上两种方式，就可以在Laravel中轻松实现exists验证规则的多列OR逻辑查询，满足各类复杂的表单验证需求。
Laravelexists验证规则多列OR查询验证器数据库查询修改时间：2026-07-02 04:36:29