PHPValidatorのダウンロードPHPValidatorソースコードのダウンロード

PHPValidator

その他のカテゴリー

v2.1.0 stable

ダウンロード

phpvalidatorについて

PHPValidatorは、PHPアプリケーションのデータ検証用の最新のPHPライブラリです。事前定義されたルールを使用してデータを検証するため、またはカスタム検証ルールを作成する柔軟で拡張可能な方法を提供します。

インストール

Composerを使用して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には、必要な、文字列、電子メール、maxlengthなどの事前定義された検証ルールが付属しています。
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 '
```
ルールで
- フィールドの値が事前定義された値のリストの1つであることを検証します。
```
 ' 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 ' ,
```
アルファ数値ルール
- フィールドの値には英数字のみが含まれていることを検証します。
```
 ' 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 " ;
    }
}

VALDATORでの使用

カスタムクラスを直接使用します

 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 ();
}