在 Laravel 8 中优雅地定义和复用全局验证规则

// 错误的示例：尝试在静态属性中定义动态规则
class GlobalRules
{
    public static $VALIDATION_RULES = [
        'signatures' => [
            'enabled' => ['required', \Illuminate\Validation\Rule::in(['on', 'off'])], // 错误：Rule::in 是运行时表达式
            // ... 其他规则
        ],
    ];
}

<?php

namespace App\Http\Traits;

use Illuminate\Validation\Rule; // 如果规则中使用了Rule::in等，需要引入

trait UserValidationTrait
{
    /**
     * 返回用户信息的验证规则。
     *
     * @param string $prefix 规则字段前缀，用于处理嵌套对象。
     * @return array
     */
    private function getUserInfoRules(string $prefix = ''): array
    {
        return [
            $prefix . 'first_name' => ['required', 'string', 'max:100'],
            $prefix . 'last_name' => ['required', 'string', 'max:100'],
            $prefix . 'status' => ['required', Rule::in(['active', 'inactive'])], // 可以在这里使用Rule::in
        ];
    }

    /**
     * 返回签名信息的验证规则。
     *
     * @param string $prefix 规则字段前缀。
     * @return array
     */
    private function getSignatureRules(string $prefix = ''): array
    {
        return [
            $prefix . 'signature_file' => ['required', 'mimes:png,jpeg,jpg', 'max:1024'],
            $prefix . 'operator_id' => ['required', 'numeric'],
            // ... 其他签名相关规则
        ];
    }
}

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use App\Http\Traits\UserValidationTrait; // 引入之前创建的Trait

class UserProfileRequest extends FormRequest
{
    use UserValidationTrait; // 使用Trait

    /**
     * 确定用户是否有权发出此请求。
     *
     * @return bool
     */
    public function authorize()
    {
        return true; // 根据实际授权逻辑修改
    }

    /**
     * 获取适用于请求的验证规则。
     *
     * @return array
     */
    public function rules()
    {
        // 定义当前FormRequest特有的规则
        $currentRequestRules = [
            'email' => ['required', 'email', 'unique:users,email,' . $this->user->id],
            'phone' => ['nullable', 'string', 'max:20'],
        ];

        // 调用Trait方法获取复用规则
        $userInfoValidation = $this->getUserInfoRules();
        $signatureValidation = $this->getSignatureRules();

        // 合并所有规则
        return array_merge(
            $currentRequestRules,
            $userInfoValidation,
            $signatureValidation
        );
    }
}

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use App\Http\Traits\UserValidationTrait;

class BulkUserUpdateRequest extends FormRequest
{
    use UserValidationTrait;

    public function authorize()
    {
        return true;
    }

    public function rules()
    {
        $currentRequestRules = [
            'users' => ['required', 'array'],
            'users.*.id' => ['required', 'numeric', 'exists:users,id'], // 验证每个用户的ID
        ];

        // 为嵌套的 'users' 数组中的每个元素添加用户信息验证规则
        $nestedUserValidation = $this->getUserInfoRules('users.*.'); // 注意这里的 'users.*.' 前缀

        return array_merge(
            $currentRequestRules,
            $nestedUserValidation
        );
    }
}