理解二选一互斥规则在 Laravel 验证中的应用
互斥需求的场景与目标
在表单验证场景中，常常需要两字段之间实现二选一且互斥的约束。也就是说用户只能填写其中一个字段，另一个字段留空。这类场景广泛存在于注册、联系方式选择、支付方式切换等场景中。核心目标是确保至少有一个字段被提交，同时防止同时提交两个字段，从而避免冲突或重复信息。
为了实现这个目标，开发者可以借助 Laravel 的验证规则进行组合，充分利用框架内置的能力来表达“恰好一个字段被提交”的约束，而无需写大量自定义逻辑。使用内置规则的组合，是提高代码可读性与可维护性的关键。
为何要采用显式的互斥规则
显式的互斥规则不仅能够在服务端直接进行校验，还能生成友好的错误信息，提升用户体验。通过在两字段上互为对方的条件进行约束，可以避免后续因为边界情况而引发的边界错误。清晰的规则表达有助于后续维护和本地化错误信息。
核心规则：required_without 的组合与互斥机制
规则分解与工作原理
要实现两字段的严格 XOR（恰好一个字段被提交），可以在字段 A 上应用 required_without，在字段 B 上应用同样的规则，并配合 prohibited_with 来阻止同时填写两者。具体组合如下：email 使用 required_without:phone|prohibited_with:phone，phone 使用 required_without:email|prohibited_with:email。
工作原理如下：当两个字段都缺失时，任一字段的 required_without 都会触发，导致验证失败；当两个字段同时存在时，prohibited_with 会触发，导致验证失败；当恰好只有一个字段存在时，验证通过。这就实现了完全的二选一互斥效果。
与 required_without_all 的对比
与 required_without_all 的方式相比，使用 required_without 的组合在某些场景下更直观，因为它直接基于“某个字段不存在时，另一个字段才需要填写”的逻辑来推导互斥关系。通过搭配 prohibited_with，同样可以实现“恰好一个字段被提交”的严格约束，并且对错误信息的粒度控制更灵活。
完整示例：两字段的二选一互斥验证（email vs phone）
FormRequest 规则示例
下面的示例展示了如何在 FormRequest 中定义上述规则，以及如何为不同的验证错误提供自定义信息。两字段分别为邮箱和手机号，确保二选一且互斥。
'required_without:phone|prohibited_with:phone|email',// 当没有提供邮箱时，手机号必须提供；手机号不能和邮箱同时存在'phone' => 'required_without:email|prohibited_with:email',];}public function messages(){return ['email.required_without' => '在未提供手机号时，邮箱为必填项。','email.prohibited_with' => '邮箱与手机号不能同时填写。','email.email' => '请输入有效的邮箱地址。','phone.required_without' => '在未提供邮箱时，手机号为必填项。','phone.prohibited_with' => '手机号与邮箱不能同时填写。',];}
}
控制器中的用法
在控制器中直接使用该 FormRequest，就可以自动完成验证、错误信息回传与后续处理。通过引入请求对象，可以将验证与业务逻辑解耦，提升代码的可维护性。
validated();// 业务逻辑，例如保存联系人信息// Contact::create($data);return response()->json(['message' => '联系人信息已保存']);}
}
前端表单示例（Blade）
下面是一个简化的表单示例，展示如何在前端收集邮箱和手机号，并确保用户界面的字段命名与后端规则保持一致。前端呈现有助于理解两字段之间的互斥关系。
<form method="POST" action="{{ route('contact.store') }}">@csrf<label>邮箱地址</label><input type="email" name="email" value="{{ old('email') }}" /><label>手机号</label><input type="text" name="phone" value="{{ old('phone') }}" /><button type="submit">提交</button>
</form>
