Laravel 内置的 dimensions 规则仅支持单一尺寸匹配，无法直接满足“图标（512×512）或横幅（800×30）任一符合即通过”的多条件验证需求；本文介绍通过自定义 Rule 类灵活实现多尺寸校验的完整方案。
laravel 内置的 `dimensions` 规则仅支持单一尺寸匹配，无法直接满足“图标（512×512）或横幅（800×30）任一符合即通过”的多条件验证需求；本文介绍通过自定义 rule 类灵活实现多尺寸校验的完整方案。
在 Laravel 表单验证中，当图像上传需根据业务类型（如用户选择的 type = 'icon' 或 'banner'）动态适配不同尺寸限制时，单纯依赖内置规则（如 dimensions:width=512,height=512）会陷入僵化：它要求所有规则同时通过，而实际场景需要的是「逻辑或（OR）」语义——即图像尺寸匹配任一预设规格即视为有效。
Laravel 并未提供原生的 dimensions:or=512,512|800,30 这类语法，因此推荐采用自定义验证规则（Custom Rule） 方案，既保持代码可读性，又具备高度可扩展性。
✅ 步骤一：生成自定义 Rule 类
运行 Artisan 命令创建规则类：
php artisan make:rule DimensionRule
✅ 步骤二：实现多尺寸校验逻辑
编辑 app/Rules/DimensionRule.php，重写 passes() 方法，利用 Laravel 内置 Validator 实例分别测试各尺寸组合：
<?php namespace App\Rules;
use Illuminate\Contracts\Validation\Rule;
use Illuminate\Support\Facades\Validator;
class DimensionRule implements Rule
{
public function passes($attribute, $value)
{
// 检查是否为有效上传文件（避免空值或非图像触发异常）
if (! $value || ! $value->isValid()) {
return false;
}
// 尝试第一组尺寸：图标（512×512）
$validator1 = Validator::make([$attribute => $value], [
$attribute => 'dimensions:width=512,height=512'
]);
if ($validator1->passes()) {
return true;
}
// 尝试第二组尺寸：横幅（800×30）
$validator2 = Validator::make([$attribute => $value], [
$attribute => 'dimensions:width=800,height=30'
]);
return $validator2->passes();
}
public function message()
{
return 'The :attribute dimensions must be either 512×512 (icon) or 800×30 (banner).';
}
}
⚠️ 注意事项：
- 必须先校验
$value->isValid()，防止对未上传或损坏文件执行dimensions导致InvalidArgumentException；dimensions规则底层依赖getimagesize()，仅适用于真实图像文件（PNG、WebP、JPEG 等），对非图像 MIME 类型（如 TXT）会静默失败，因此建议前置mimes:png,webp,jpeg等限制；- 若未来需支持更多尺寸（如移动端图标 192×192、App Store 图标 1024×1024），只需在
passes()中追加对应验证分支即可，无需修改调用方。
✅ 步骤三：在验证器中组合使用
将自定义规则与其它约束并列声明，确保职责分离：
use App\Rules\DimensionRule;
$validator = Validator::make([
'file' => $uploadedFile,
'type' => $request->input('type'), // 可选：用于更复杂逻辑（如动态加载尺寸配置）
], [
'file' => [
'required',
'file',
'mimes:png,webp,jpeg', // 先限定格式
new DimensionRule(), // 再校验尺寸（OR 逻辑）
'max:2048', // 最终限制文件大小（KB）
],
]);
$validator->validate();
✅ 进阶建议：支持配置化尺寸
若尺寸规则随业务频繁变化，可将尺寸数组注入 Rule 构造函数，提升复用性：
// 使用时
new DimensionRule([[512, 512], [800, 30], [192, 192]])
// Rule 构造函数接收 $allowedDimensions
public function __construct(public array $allowedDimensions) {}
// passes() 中遍历 $this->allowedDimensions 动态构建验证规则
通过该方案，你不仅解决了当前「单字段多尺寸验证」的核心痛点，还构建了可维护、可测试、易扩展的验证基础设施——这正是 Laravel 自定义规则设计哲学的典型实践。
