Laravel查询参数验证：如何自动转换为PHP原生类型？

问题核心原因 #

HTTP GET请求的参数本质都是字符串类型，integer:strict规则会严格要求参数必须是PHP原生整数，因此所有传入的数字字符串都会被验证拒绝，导致validated()返回null。

方案一：通过prepareForValidation预处理参数 #

在CommunityRequest中重写prepareForValidation方法，在验证前将指定参数转换为原生类型，既满足验证要求，又能直接拿到对应类型的值：

class CommunityRequest extends FormRequest
{
    public function authorize(): bool
    {
        return true;
    }

    public function rules(): array
    {
        return [
            'radius' => ['sometimes', 'nullable', 'integer', 'min:1'],
        ];
    }

    protected function prepareForValidation(): void
    {
        // 仅当radius参数存在且不为空时，转换为整数
        if ($this->has('radius') && $this->input('radius') !== null) {
            $this->merge([
                'radius' => (int)$this->input('radius'),
            ]);
        }
    }
}

处理后，验证阶段radius已经是PHP原生整数，调用$request->validated('radius')会直接返回整数类型的值。

方案二：自定义验证规则实现验证+类型转换 #

如果需要复用类似的类型转换逻辑，可以自定义一个验证规则，在验证通过时自动转换参数类型：

1. 创建自定义规则类：

namespace App\Rules;

use Illuminate\Contracts\Validation\Rule;

class IntegerCast implements Rule
{
    public function passes($attribute, $value): bool
    {
        // 验证值是否可以安全转换为整数（避免类似"123abc"的非法值）
        return is_numeric($value) && (string)(int)$value === (string)$value;
    }

    public function message(): string
    {
        return ':attribute 必须是有效的整数。';
    }

    // 验证通过后自动转换参数类型
    public function afterValidation($attribute, $value, $validator)
    {
        $validator->getData()[$attribute] = (int)$value;
    }
}

2. 在CommunityRequest中使用该规则：

class CommunityRequest extends FormRequest
{
    public function authorize(): bool
    {
        return true;
    }

    public function rules(): array
    {
        return [
            'radius' => ['sometimes', 'nullable', new \App\Rules\IntegerCast, 'min:1'],
        ];
    }
}

方案三：控制器内直接转换（最简临时方案） #

如果不想修改FormRequest，也可以在验证通过后直接转换类型：

class CommunityController extends Controller
{
    public function index(CommunityRequest $request): Response{
        $radius = $request->validated('radius');
        // 仅当值存在时转换为整数
        if ($radius !== null) {
            $radius = (int)$radius;
        }
        // 后续业务逻辑处理
        // [...]
    }
}

扩展处理其他类型 #

如果需要处理布尔值、浮点数、日期等类型，只需调整转换逻辑：

• 布尔值：filter_var($value, FILTER_VALIDATE_BOOLEAN)
• 浮点数：(float)$value
• 日期：Carbon::parse($value)（需确保Carbon已引入）

内容的提问来源于stack exchange，提问作者Frexom