webman-tech/laravel-validation

Webman plugin webman-tech/laravel-validation

v1.2.0 2023-05-19 15:56 UTC

This package is auto-updated.

Last update: 2024-10-20 15:33:45 UTC


README

Laravel illuminate/validation for webman

介绍

站在巨人(laravel)的肩膀上使验证器使用更加可靠便捷

所有方法和配置与 laravel 几乎一模一样,因此使用方式完全参考 Laravel文档 即可

安装

composer require webman-tech/laravel-validation

使用

所有 API 同 laravel,以下仅对有些特殊的操作做说明

常规使用如下:

<?php
namespace app\controller;

use support\Request;

class FooController
{
    public function bar(Request $request) 
    {
        $validator = validator($request->post(), [
            'title' => 'required|unique:posts|max:255',
            'body' => 'required',
        ]);
        if ($validator->fails()) {
            return json($validator->errors()->first());
        }
        return json('ok');
    }
}

file/mimeType 相关的 rule

由于 laravel 的 validation 验证 file/image 等文件时(包括文件 mimeType)时,都是使用的 Symfony 的 UploadedFile,而 webman 里 $request->file() 得到的是 Webman\UploadFile, 因此无法直接使用相关的 rules

需要使用 webman-tech/polyfill 来支持

安装

composer require webman-tech/polyfill illuminate/http

使用

<?php
namespace app\controller;

use support\Request;
use WebmanTech\Polyfill\LaravelRequest;

class FooController
{
    public function bar(Request $request) 
    {
        $validator = validator(LaravelRequest::wrapper($request)->all(), [
           'file' => 'required|file|image',
        ]);
        if ($validator->fails()) {
            return json($validator->errors()->first());
        }
        return json('ok');
    }
}

$request->validate

需要使用 webman-tech/polyfill 来支持

安装

composer require webman-tech/polyfill illuminate/http

使用

<?php
namespace app\controller;

use support\Request;
use WebmanTech\Polyfill\LaravelRequest;

class FooController
{
    public function bar(Request $request) 
    {
        LaravelRequest::wrapper($request)->validate([
            'file' => 'required|file|image',
        ]);
        
        return json('ok');
    }
}

自定义验证规则

config/plugin/webman-tech/laravel-validation/app.phpextends 字段中配置即可

配置形式同 Laravel

目前暂未提供 make:rule 的 command,需要自己写 Rule 类

locale 本地化翻译需求

支持本地化

需要使用 webman-tech/laravel-translation 来支持

安装

composer require webman-tech/laravel-translation

你也可以自行实现验证错误消息的本地化实现

通过修改 config/plugin/webman-tech/laravel-validation/app.phptranslation 提供一个 Illuminate\Contracts\Translation\Translator 来实现

切换 locale

因为没有 Laravel App 的存在,所以不能通过 App::setLocale()App::currentLocale() 来切换验证器的语言

且由于 webman 建议的多语言是使用的 symfony/translation,并且全局 locale 函数也是使用其实现的

因此本扩展基于此原因,已经做到了根据 locale() 自动切换 validator() 下使用的语言包,无需开发手动设置

unique 验证器

unique 依赖数据库,本扩展对已经安装 illuminate/database 了 webman 应用自动支持

如果不支持,比如报错:Presence verifier has not been set. 时,请手动安装 illuminate/database

原则上不一定强依赖于 Laravel 的 database, TP 的应该也是可以的(实现 DatabasePresenceVerifierInterface),目前暂未实现,欢迎PR