Download PHPValidator - download kode sumber PHPValidator

PHPValidator

Kategori lainnya

v2.1.0 stable

Unduh

Tentang phpvalidator

PHPValidator adalah pustaka PHP modern untuk validasi data dalam aplikasi PHP Anda. Ini memberikan cara yang fleksibel dan dapat diperluas untuk memvalidasi data menggunakan aturan yang telah ditentukan atau dengan membuat aturan validasi khusus.

Instalasi

Gunakan komposer untuk menginstal phpvalidator:

composer require blakvghost/php-validator

Penggunaan

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

Anda juga dapat menyesuaikan pesan kesalahan validasi atau 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 ' );

Fitur

Predefined Rules : PhpValidator hadir dengan serangkaian aturan validasi yang telah ditentukan seperti yang diperlukan, string, email, maxlength dll.
Custom Rules : Mudah membuat aturan validasi khusus dengan mengimplementasikan antarmuka Rule .
Multilingual Support : Kustomisasi pesan kesalahan validasi berdasarkan bahasa aplikasi menggunakan LangManager .

Daftar aturan yang telah ditentukan sebelumnya

PHPValidator menyediakan berbagai aturan yang telah ditentukan yang dapat Anda gunakan untuk validasi data. Berikut adalah daftar beberapa aturan yang umum digunakan bersama dengan contoh penggunaannya:

Aturan yang diperlukan
- Memastikan bahwa suatu bidang ada dalam data.
```
 ' username ' => ' required '
```
Aturan string
- Periksa apakah suatu bidang adalah jenis string.
```
 ' username ' => ' string '
```
Aturan email
- Memvalidasi bahwa bidang adalah alamat email yang dibentuk dengan baik.
```
 ' email ' => ' email '
```
Aturan panjang maksimal
- Menentukan panjang maksimum bidang string.
```
 ' username ' => ' max:25 '
```
Aturan yang dikonfirmasi
- Periksa apakah nilai bidang sama dengan bidang lain (biasanya digunakan untuk konfirmasi kata sandi).
```
 ' password_confirmation ' => ' confirmed:password '
```
Aturan file
- Memvalidasi bahwa bidang adalah unggahan file.
```
 ' file ' => ' file '
```
Aturan yang diterima
- Memvalidasi bahwa suatu bidang adalah "yes" , "on" , "1" , atau true . Berguna untuk kotak centang.
```
 ' terms_and_conditions ' => ' accepted '
```
Diterima jika aturan
- Memvalidasi bahwa suatu bidang diterima jika bidang lain sama dengan nilai yang ditentukan.
```
 ' terms_and_conditions ' => ' accepted_if:is_adult,true '
```
Aturan ActiveUrl
- Memvalidasi bahwa bidang adalah URL aktif yang valid.
```
 ' website ' => ' active_url '
```
Aturan Alpha
- Memvalidasi bahwa bidang hanya berisi karakter alfabet.
```
 ' name ' => ' alpha '
```
Aturan numerik
- Memvalidasi bahwa bidang hanya berisi karakter numerik.
```
 ' age ' => ' numeric '
```
Aturan kecil
- Memvalidasi bahwa bidang hanya berisi karakter alfabet kecil.
```
 ' username ' => ' lowercase '
```
Aturan huruf besar
- Memvalidasi bahwa bidang hanya berisi karakter alfabet besar.
```
 ' username ' => ' uppercase '
```
Dalam aturan
- Memvalidasi bahwa nilai bidang adalah salah satu daftar nilai yang telah ditentukan.
```
 ' role ' => ' in:admin,editor,viewer '
```
Aturan yang dapat dibatalkan
- Memungkinkan bidang menjadi null atau kosong.
```
 ' optional_field ' => ' nullable '
```
Aturan Kata Sandi
- Memvalidasi bahwa bidang adalah secure password .
```
 ' password ' => ' password '
```
Aturan yang sama
- Memvalidasi bahwa nilai bidang sama dengan nilai bidang lain.
```
 ' password_confirmation ' => ' same:password '
```
Aturan panjang maksimal
- Menentukan panjang minimum bidang string.
```
 ' username ' => ' min:8 '
```
Tidak dalam aturan
- Memvalidasi bahwa nilai bidang tidak dalam set yang ditentukan.
```
 ' value ' => ' not_in:foo,bar '
```
Diperlukan dengan aturan
- Membutuhkan bidang untuk hadir jika bidang lain yang ditentukan ada.
```
 ' firstname ' => ' required_with:lastname ' ,
```
Aturan IP yang valid
- Memvalidasi bahwa nilai bidang adalah alamat IP yang valid.
```
 ' client_ip ' => ' ip ' ,
```
Aturan json
- Memvalidasi bahwa nilai bidang adalah string JSON yang valid.
```
 ' config ' => ' json ' ,
```
Aturan URL
- Memvalidasi bahwa nilai bidang adalah URL yang valid.
```
 ' website ' => ' url ' ,
```
Aturan Numerik Alpha
- Memvalidasi bahwa nilai bidang hanya berisi karakter alfanumerik.
```
 ' pseudo ' => ' alpha_num ' ,
```
Aturan boolean
- Memvalidasi bahwa nilai bidang adalah boolean.
```
 ' is_admin ' => ' bool ' ,
```

Aturan ukuran

Memvalidasi ukuran string, integer, array, atau file sama dengan nilai yang ditentukan.

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

Tidak diperlukan dengan aturan
- Membutuhkan bidang yang tidak ada jika bidang lain yang ditentukan ada.
```
 ' email ' => ' not_required_with:phone_number ' ,
```

Aturan khusus

Selain aturan yang telah ditentukan, Anda dapat membuat aturan validasi khusus dengan mengimplementasikan antarmuka Rule . Berikut adalah contoh cara membuat dan menggunakan aturan khusus:

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 " ;
    }
}

Penggunaan di Validator

Gunakan kelas khusus Anda secara langsung

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

Tambahkan kelas khusus Anda ke daftar aturan dan gunakan seolah -olah itu asli

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

Dalam contoh ini, kami membuat CustomPasswordRule yang memeriksa apakah kata sandi sama dengan konfirmasi_password. Anda dapat menyesuaikan metode operan untuk mengimplementasikan logika validasi spesifik Anda.

Berkontribusi

Jika Anda ingin berkontribusi pada PHPValidator, silakan ikuti pedoman kontribusi kami.

Penulis

Kabirou Alassane

Mendukung

Untuk dukungan, Anda dapat menghubungi saya melalui email di [email protected]. Jangan ragu untuk menghubungi saya jika Anda memiliki pertanyaan atau memerlukan bantuan dengan PhpValidator.