https://github.com/webman-tech/laravel-validation
[READ ONLY] Subtree split from webman-tech/laravel-monorepo
https://github.com/webman-tech/laravel-validation
Last synced: 9 months ago
JSON representation
[READ ONLY] Subtree split from webman-tech/laravel-monorepo
- Host: GitHub
- URL: https://github.com/webman-tech/laravel-validation
- Owner: webman-tech
- Created: 2022-09-17T14:55:30.000Z (over 3 years ago)
- Default Branch: 12.x
- Last Pushed: 2025-07-22T06:07:27.000Z (11 months ago)
- Last Synced: 2025-08-04T07:36:42.213Z (10 months ago)
- Language: PHP
- Homepage:
- Size: 57.6 KB
- Stars: 18
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# webman-tech/laravel-validation
> Split from [webman-tech/laravel-monorepo](https://github.com/webman-tech/laravel-monorepo)
Laravel [illuminate/validation](https://packagist.org/packages/illuminate/validation) for webman
## 介绍
站在巨人（laravel）的肩膀上使验证器使用更加*可靠*和*便捷*
所有方法和配置与 laravel 几乎一模一样，因此使用方式完全参考 [Laravel文档](https://laravel.com/docs/validation) 即可
## 安装
```bash
composer require webman-tech/laravel-validation
```
## 使用
所有 API 同 laravel，以下仅对有些特殊的操作做说明
常规使用如下：
```php
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/laravel-http`](https://github.com/webman-tech/laravel-http) 来支持
安装
```bash
composer require webman-tech/laravel-http
```
使用
```php
'required|file|image',
]);
if ($validator->fails()) {
return json($validator->errors()->first());
}
return json('ok');
}
}
```
### $request->validate
需要使用 [`webman-tech/laravel-http`](https://github.com/webman-tech/laravel-http) 来支持
安装
```bash
composer require webman-tech/laravel-http
```
使用
```php
'required|file|image',
]);
return json('ok');
}
}
```
### 自定义验证规则
在 `config/plugin/webman-tech/laravel-validation/app.php` 的 `extends` 字段中配置即可
配置形式同 Laravel
> 目前暂未提供 make:rule 的 command，需要自己写 Rule 类
### locale 本地化翻译需求
#### 支持本地化
> 如果已经安装了 `symfony/translation`(webman 默认支持的)，会自动使用其来支持本地化，可以忽略以下的内容
使用 [`webman-tech/laravel-translation`](https://github.com/webman-tech/laravel-translation) 来支持
安装
```bash
composer require webman-tech/laravel-translation
```
#### 切换 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