【WordPress插件】2022年最新版完整功能demo+插件v9.3.8.zip

Rakit Validation - PHP Standalone Validation Library ====================================================== [](https://travis-ci.org/rakit/validation) [](https://coveralls.io/github/rakit/validation) [](http://doge.mit-license.org) PHP Standalone library for validating data. Inspired by `Illuminate\Validation` Laravel. ## Features * API like Laravel validation. * Array validation. * `$_FILES` validation with multiple file support. * Custom attribute aliases. * Custom validation messages. * Custom rule. ## Requirements * PHP 7.0 or higher * Composer for installation ## Quick Start #### Installation ``` composer require "rakit/validation" ``` #### Usage There are two ways to validating data with this library. Using `make` to make validation object, then validate it using `validate`. Or just use `validate`. Examples: Using `make`: ```php <?php require('vendor/autoload.php'); use Rakit\Validation\Validator; $validator = new Validator; // make it $validation = $validator->make($_POST + $_FILES, [ 'name' => 'required', 'email' => 'required|email', 'password' => 'required|min:6', 'confirm_password' => 'required|same:password', 'avatar' => 'required|uploaded_file:0,500K,png,jpeg', 'skills' => 'array', 'skills.*.id' => 'required|numeric', 'skills.*.percentage' => 'required|numeric' ]); // then validate $validation->validate(); if ($validation->fails()) { // handling errors $errors = $validation->errors(); echo "<pre>"; print_r($errors->firstOfAll()); echo "</pre>"; exit; } else { // validation passes echo "Success!"; } ``` or just `validate` it: ```php <?php require('vendor/autoload.php'); use Rakit\Validation\Validator; $validator = new Validator; $validation = $validator->validate($_POST + $_FILES, [ 'name' => 'required', 'email' => 'required|email', 'password' => 'required|min:6', 'confirm_password' => 'required|same:password', 'avatar' => 'required|uploaded_file:0,500K,png,jpeg', 'skills' => 'array', 'skills.*.id' => 'required|numeric', 'skills.*.percentage' => 'required|numeric' ]); if ($validation->fails()) { // handling errors $errors = $validation->errors(); echo "<pre>"; print_r($errors->firstOfAll()); echo "</pre>"; exit; } else { // validation passes echo "Success!"; } ``` In this case, 2 examples above will output the same results. But with `make` you can setup something like custom invalid message, custom attribute alias, etc before validation running. ### Attribute Alias By default we will transform your attribute into more readable text. For example `confirm_password` will be displayed as `Confirm password`. But you can set it anything you want with `setAlias` or `setAliases` method. Example: ```php $validator = new Validator; // To set attribute alias, you should use `make` instead `validate`. $validation->make([ 'province_id' => $_POST['province_id'], 'district_id' => $_POST['district_id'] ], [ 'province_id' => 'required|numeric', 'district_id' => 'required|numeric' ]); // now you can set aliases using this way: $validation->setAlias('province_id', 'Province'); $validation->setAlias('district_id', 'District'); // or this way: $validation->setAliases([ 'province_id' => 'Province', 'district_id' => 'District' ]); // then validate it $validation->validate(); ``` Now if `province_id` value is empty, error message would be 'Province is required'. ## Custom Validation Message Before register/set custom messages, here are some variables you can use in your custom messages: * `:attribute`: will replaced into attribute alias. * `:value`: will replaced into stringify value of attribute. For array and object will replaced to json. And also there are several message variables depends on their rules. Here are some ways to register/set your custom message(s): #### Custom Messages for Validator With this way, anytime you make validation using `make` or `validate` it will set your custom messages for it. It is useful for localization. To do this, you can set custom messages as first argument constructor like this: ```php $validator = new Validator([ 'required' => ':attribute harus diisi', 'email' => ':email tidak valid', // etc ]); // then validation belows will use those custom messages $validation_a = $validator->validate($dataset_a, $rules_for_a); $validation_b = $validator->validate($dataset_b, $rules_for_b); ``` Or using `setMessages` method like this: ```php $validator = new Validator; $validator->setMessages([ 'required' => ':attribute harus diisi', 'email' => ':email tidak valid', // etc ]); // now validation belows will use those custom messages $validation_a = $validator->validate($dataset_a, $rules_for_dataset_a); $validation_b = $validator->validate($dataset_b, $rules_for_dataset_b); ``` #### Custom Messages for Validation Sometimes you may want to set custom messages for specific validation. To do this you can set your custom messages as 3rd argument of `$validator->make` or `$validator->validate` like this: ```php $validator = new Validator; $validation_a = $validator->validate($dataset_a, $rules_for_dataset_a, [ 'required' => ':attribute harus diisi', 'email' => ':email tidak valid', // etc ]); ``` Or you can use `$validation->setMessages` like this: ```php $validator = new Validator; $validation_a = $validator->make($dataset_a, $rules_for_dataset_a); $validation_a->setMessages([ 'required' => ':attribute harus diisi', 'email' => ':email tidak valid', // etc ]); ... $validation_a->validate(); ``` #### Custom Message for Specific Attribute Rule Sometimes you may want to set custom message for specific rule attribute. To do this you can use `:` as message separator or using chaining methods. Examples: ```php $validator = new Validator; $validation_a = $validator->make($dataset_a, [ 'age' => 'required|min:18' ]); $validation_a->setMessages([ 'age:min' => '18+ only', ]); $validation_a->validate(); ``` Or using chaining methods: ```php $validator = new Validator; $validation_a = $validator->make($dataset_a, [ 'photo' => [ 'required', $validator('uploaded_file')->fileTypes('jpeg|png')->message('Photo must be jpeg/png image') ] ]); $validation_a->validate(); ``` ## Translation Translation is different with custom messages. Translation may needed when you use custom message for rule `in`, `not_in`, `mimes`, and `uploaded_file`. For example if you use rule `in:1,2,3` we will set invalid message like "The Attribute only allows '1', '2', or '3'" where part "'1', '2', or '3'" is comes from ":allowed_values" tag. So if you have custom Indonesian message ":attribute hanya memperbolehkan :allowed_values", we will set invalid message like "Attribute hanya memperbolehkan '1', '2', or '3'" which is the "or" word is not part of Indonesian language. So, to solve this problem, we can use translation like this: ```php // Set translation for words 'and' and 'or'. $validator->setTranslations([ 'and' => 'dan', 'or' => 'atau' ]); // Set custom message for 'in' rule $validator->setMessage('in', ":attribute hanya memperbolehkan :allowed_values"); // Validate $validation = $validator->validate($inputs, [ 'nomor' => 'in:1,2,3' ]); $message = $validation->errors()->first('nomor'); // "Nomor hanya memperbolehkan '1', '2', atau '3'" ``` > Actually, our built-in rules only use words 'and' and 'or' that you may need to translates. ## Working with Error Message Errors messages are collected in `Rakit\Validation\Er