Laravel 文件数组总大小验证：使用自定义规则实现

php artisan make:rule ArraySize

<?php

namespace App\Rules;

use Illuminate\Contracts\Validation\Rule;
use Illuminate\Http\UploadedFile; // 引入 UploadedFile 类

class ArraySize implements Rule
{
    /**
     * 数组的最大允许总大小（单位：KB）。
     *
     * @var int
     */
    private int $maxSizeInKb;

    /**
     * 创建一个新的规则实例。
     *
     * @param int $maxSizeInKb 允许的最大总大小（KB）
     * @return void
     */
    public function __construct(int $maxSizeInKb)
    {
        $this->maxSizeInKb = $maxSizeInKb;
    }

    /**
     * 判断验证规则是否通过。
     *
     * @param  string  $attribute 正在验证的属性名
     * @param  mixed  $value 正在验证的属性值（文件数组）
     * @return bool
     */
    public function passes($attribute, $value): bool
    {
        $totalBytes = 0;

        // 确保 $value 是一个数组
        if (!is_array($value)) {
            return false;
        }

        foreach ($value as $file) {
            // 确保数组中的每个元素都是 UploadedFile 实例
            if (!$file instanceof UploadedFile) {
                // 如果不是上传文件实例，则验证失败，避免潜在错误
                return false;
            }
            // 累加每个文件的字节大小
            $totalBytes += $file->getSize();
        }

        // 将总字节数转换为 KB，并与设定的最大值进行比较
        // 注意：getSize() 返回的是字节数
        return ($totalBytes / 1024) <= $this->maxSizeInKb;
    }

    /**
     * 获取验证失败时返回的错误消息。
     *
     * @return string
     */
    public function message(): string
    {
        return sprintf('所有上传文件的总大小必须小于 %d KB。', $this->maxSizeInKb);
    }
}

use App\Rules\ArraySize;
// ... 其他 use 语句

// ...
public function rules()
{
    return [
        'title'               => 'required|max:125',
        'quantity'            => 'required|numeric|min:0',
        'retail_price'        => 'required|numeric|min:0',
        'diamond_shape_id'    => 'required',
        'diamond_cut_id'      => 'required',
        'diamond_color_id'    => 'required',
        'diamond_clarity_id'  => 'required',
        'carat_weight'        => 'required',
        'diamond_polish_id'   => 'required',
        'diamond_symmetry_id' => 'required',
        'video_url'           => ['url', new EmbeddableUrl], // 假设 EmbeddableUrl 是另一个自定义规则
        'images.*'            => 'mimes:jpg,jpeg,png|max:1000', // 验证每个文件不超过 1000KB (1MB)
        'images'              => [new ArraySize(30000)],      // 验证所有文件总大小不超过 30000KB (即 30MB)
    ];
}