webman-tech / laravel-validation
Webman plugin webman-tech/laravel-validation
Installs: 5 366
Dependents: 2
Suggesters: 0
Security: 0
Stars: 14
Watchers: 1
Forks: 1
Open Issues: 0
Requires
- php: >=7.3
- illuminate/validation: >=8.0
Requires (Dev)
- illuminate/database: >=8.0
- phpunit/phpunit: ^9
- symfony/translation: >=5.0
- webman-tech/laravel-translation: ^1.0
- workerman/webman-framework: ^1.4
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.php
的 extends
字段中配置即可
配置形式同 Laravel
目前暂未提供 make:rule 的 command,需要自己写 Rule 类
locale 本地化翻译需求
支持本地化
需要使用 webman-tech/laravel-translation
来支持
安装
composer require webman-tech/laravel-translation
你也可以自行实现验证错误消息的本地化实现
通过修改 config/plugin/webman-tech/laravel-validation/app.php
的 translation
提供一个 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