PHPValidator下載 - PHPValidator源代碼下載

PHPValidator

其他類別

v2.1.0 stable

下載

關於phpvalidator

PHPVALIDATOR是用於PHP應用程序中數據驗證的現代PHP庫。它提供了一種靈活且可擴展的方法，可以使用預定義的規則或創建自定義驗證規則來驗證數據。

安裝

使用作曲家安裝phpvalidator：

composer require blakvghost/php-validator

用法

 use BlakvGhost  PHPValidator  Validator ;
use BlakvGhost  PHPValidator  ValidatorException ;

try {

    $ data = [
        ' username ' => ' BlakvGhost ' ,
        ' email ' => ' [email protected] ' ,
        ' score ' => 42 ,
    ];
    // or
    // $data = $_POST;

    $ validator = new Validator ( $ data , [
        ' username ' => ' required|string ' ,
        ' email ' => ' required|email ' ,
        ' score ' => [ ' required ' , ' max:200 ' , new CustomRule ()],
        ' password ' => new CustomRule (),
    ]);

    if ( $ validator -> isValid ()) {
        echo " Validation passed! " ;
    } else {
        $ errors = $ validator -> getErrors ();
        print_r ( $ errors );
    }
} catch ( ValidatorException $ e ) {
    echo " Validation error: " . $ e -> getMessage ();
}

您還可以自定義驗證錯誤消息或specify the default language

 $ data = [
    ' username ' => ' BlakvGhost ' ,
];

$ validator = new Validator (
    $ data ,
    [
        ' username ' => ' required|string ' ,
    ],
    [
        ' username ' => [
            ' required ' => ' Votre nom d ' utilisateur doit être présent ' ,
            ' string ' => ' Votre nom d ' utilisateur doit forcément être une chaîne de caractère ' ,
            ],
        ]
    );
    
    // For the default language
    $ validator = new Validator ( $ data , $ rules , lang: ' fr ' );

特徵

Predefined Rules ：PHPVALIDATOR附帶一組預定義的驗證規則，例如必需，字符串，電子郵件，最大長度等。
Custom Rules ：通過實現Rule接口來輕鬆創建自定義驗證規則。
Multilingual Support ：使用LangManager根據應用程序的語言自定義驗證錯誤消息。

預定義規則列表

PHPVALIDATOR提供了各種預定義的規則，您可以將其用於數據驗證。這是一些常用規則的列表以及其用法的示例：

所需的規則
- 確保數據中存在一個字段。
```
 ' username ' => ' required '
```
字符串規則
- 檢查字段是否為字符串類型。
```
 ' username ' => ' string '
```
電子郵件規則
- 驗證字段是一個良好的電子郵件地址。
```
 ' email ' => ' email '
```
最大長度規則
- 指定字符串字段的最大長度。
```
 ' username ' => ' max:25 '
```
確認的規則
- 檢查字段的值是否與另一個字段相同（通常用於密碼確認）。
```
 ' password_confirmation ' => ' confirmed:password '
```
文件規則
- 驗證字段是文件上傳。
```
 ' file ' => ' file '
```
接受的規則
- 驗證字段是"yes" ， "on" ， "1"或true 。對複選框有用。
```
 ' terms_and_conditions ' => ' accepted '
```
如果規則接受
- 如果另一個字段等於指定的值，則驗證字段被接受。
```
 ' terms_and_conditions ' => ' accepted_if:is_adult,true '
```
ActiveUrl規則
- 驗證字段是有效的，有效的URL。
```
 ' website ' => ' active_url '
```
阿爾法規則
- 驗證字段僅包含字母字符。
```
 ' name ' => ' alpha '
```
數字規則
- 驗證字段僅包含數字字符。
```
 ' age ' => ' numeric '
```
小寫規則
- 驗證字段僅包含小寫字母字符。
```
 ' username ' => ' lowercase '
```
大寫規則
- 驗證字段僅包含大寫字母字符。
```
 ' username ' => ' uppercase '
```
在規則中
- 驗證字段的值是預定義值的列表之一。
```
 ' role ' => ' in:admin,editor,viewer '
```
無效的規則
- 允許字段為null或空。
```
 ' optional_field ' => ' nullable '
```
密碼規則
- 驗證字段是secure password 。
```
 ' password ' => ' password '
```
相同的規則
- 驗證字段的值與另一個字段的值相同。
```
 ' password_confirmation ' => ' same:password '
```
最大長度規則
- 指定字符串字段的最小長度。
```
 ' username ' => ' min:8 '
```
不統治
- 驗證字段的值不在指定的集合中。
```
 ' value ' => ' not_in:foo,bar '
```
規則要求
- 如果存在另一個指定的字段，則需要存在該字段。
```
 ' firstname ' => ' required_with:lastname ' ,
```
有效的IP規則
- 驗證字段的值是有效的IP地址。
```
 ' client_ip ' => ' ip ' ,
```
JSON規則
- 驗證字段的值是有效的JSON字符串。
```
 ' config ' => ' json ' ,
```
URL規則
- 驗證字段的值是有效的URL。
```
 ' website ' => ' url ' ,
```
alpha數字規則
- 驗證字段的值僅包含字母數字字符。
```
 ' pseudo ' => ' alpha_num ' ,
```
布爾規則
- 驗證字段的價值是布爾值。
```
 ' is_admin ' => ' bool ' ,
```

尺寸規則

驗證字符串，整數，數組或文件的大小等於指定值。

    [
        ' string ' => ' size:7 ' , // strlen(string) == 7
        ' integer ' => ' size:7 ' , // integer == 7
        ' array ' => ' size:7 ' , // count(array) == 7
        ' file ' => ' size:512 ' , // file size (kb) == 512
    ]

規則不需要
- 如果存在另一個指定的字段，則不需要該字段。
```
 ' email ' => ' not_required_with:phone_number ' ,
```

自定義規則

除了預定義的規則外，您還可以通過實現Rule接口來創建自定義驗證規則。這是如何創建和使用自定義規則的示例：

custompasswordrule.php

 // CustomPasswordRule.php
namespace YourNameSpace  Rules ;

use BlakvGhost  PHPValidator  Contracts  Rule ;

class CustomPasswordRule implements Rule
{
    protected $ field ;

    public function __construct ( protected array $ parameters = [])
    {
    }

    public function passes ( string $ field , $ value , array $ data ): bool
    {
        $ this -> field = $ field ;
        // Implement your custom validation logic here
        // Example: Check if the password is equal to confirm_password
        return $ value === $ data [ ' confirm_password ' ];
    }

    public function message (): string
    {
        return " Vos deux mot de passes ne sont pas identiques " ;
    }
}

在驗證器中使用

直接使用您的自定義課程

 use BlakvGhost  PHPValidator  Validator ;
use BlakvGhost  PHPValidator  ValidatorException ;

use YourNameSpace  CustomPasswordRule ;


// ...

try {

    $ data = [
        ' password ' => ' 42 ' ,
        ' confirm_password ' => ' 142 ' ,
    ];
    // or
    // $data = $_POST;

    $ validator = new Validator ( $ data , [
        ' password ' => [ ' required ' , new CustomPasswordRule ()],
    ]);

    if ( $ validator -> isValid ()) {
        echo " Validation passed! " ;
    } else {
        $ errors = $ validator -> getErrors ();
        print_r ( $ errors );
    }
} catch ( ValidatorException $ e ) {
    echo " Validation error: " . $ e -> getMessage ();
}

將您的自定義類添加到規則列表中，然後將其像本機一樣使用

 use BlakvGhost  PHPValidator  Validator ;
use BlakvGhost  PHPValidator  ValidatorException ;
use BlakvGhost  PHPValidator  Mapping  RulesMaped ;

use YourNameSpace  CustomPasswordRule ;

// Add your rule here using an alias and the full namespace of your custom class
RulesMaped:: addRule ( ' c_password ' , CustomPasswordRule::class);

try {

    $ data = [
        ' password ' => ' 42 ' ,
        ' confirm_password ' => ' 142 ' ,
    ];

    $ validator = new Validator ( $ data , [
        ' password ' => ' required|c_password ' ,
    ]);

    if ( $ validator -> isValid ()) {
        echo " Validation passed! " ;
    } else {
        $ errors = $ validator -> getErrors ();
        print_r ( $ errors );
    }
} catch ( ValidatorException $ e ) {
    echo " Validation error: " . $ e -> getMessage ();
}