Laravel 8 全局化与复用验证规则的最佳实践

// 这是一个错误的示例，会导致FatalError
class AppValidationRules
{
    public static $SIGNATURE_RULES = [
        'first_name' => ['required', 'max:255', 'string'],
        'last_name' => ['required', 'max:255', 'string'],
        'enabled' => ['required', \Illuminate\Validation\Rule::in(['on', 'off'])], // 这里的Rule::in是一个表达式
        'signature_file' => ['required', 'mimes:png,jpeg,jpg', 'max:1024'],
        'operator_id' => ['required', 'numeric'],
    ];
}

<?php

namespace App\Http\Requests\Traits;

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

trait UserRequestTrait
{
    /**
     * 返回用户信息的验证规则。
     *
     * @param string $prefix 字段前缀，用于处理嵌套对象或数组。
     * @return array
     */
    private function userInfoValidator(string $prefix = ''): array
    {
        return [
            $prefix . 'first_name' => ['required', 'string', 'max:100'],
            $prefix . 'last_name' => ['required', 'string', 'max:100'],
            // 假设这里有更多用户相关的通用规则，甚至包含Rule::in等表达式
            // $prefix . 'status' => ['required', Rule::in(['active', 'inactive'])],
        ];
    }

    /**
     * 返回签名信息的验证规则。
     *
     * @param string $prefix 字段前缀。
     * @return array
     */
    private function signatureInfoValidator(string $prefix = ''): array
    {
        return [
            $prefix . 'enabled' => ['required', Rule::in(['on', 'off'])],
            $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\Requests\Traits\UserRequestTrait; // 引入我们创建的Trait

class UserFormRequest extends FormRequest
{
    use UserRequestTrait; // 使用Trait

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

    /**
     * 获取应用于请求的验证规则。
     *
     * @return array
     */
    public function rules()
    {
        $rules = [
            // 此处可以添加UserFormRequest特有的其他验证规则
            'email' => ['required', 'email', 'unique:users,email,' . $this->route('user')],
            'password' => ['sometimes', 'required', 'min:8'],
        ];

        // 调用Trait中的方法获取用户信息的验证规则
        $userValidationRules = $this->userInfoValidator();

        // 调用Trait中的方法获取签名信息的验证规则（如果需要）
        // $signatureValidationRules = $this->signatureInfoValidator();

        // 合并所有规则
        return array_merge(
            $rules,
            $userValidationRules
            // $signatureValidationRules // 如果有，也合并进来
        );
    }
}

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use App\Http\Requests\Traits\UserRequestTrait;

class BatchUserUpdateRequest extends FormRequest
{
    use UserRequestTrait;

    public function authorize()
    {
        return true;
    }

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

        // 调用Trait中的方法，并传入前缀 'users.*.'
        // 这将生成 'users.*.first_name', 'users.*.last_name' 等规则
        $userValidationRules = $this->userInfoValidator('users.*.');

        return array_merge(
            $rules,
            $userValidationRules
        );
    }
}