PHPValidator

เกี่ยวกับ 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 มาพร้อมกับชุดของกฎการตรวจสอบความถูกต้องที่กำหนดไว้ล่วงหน้าเช่นที่ต้องการสตริงอีเมลความยาว ฯลฯ

• Custom Rules : สร้างกฎการตรวจสอบความถูกต้องที่กำหนดเองได้อย่างง่ายดายโดยใช้อินเตอร์เฟส Rule

• Multilingual Support : ปรับแต่งข้อความแสดงข้อผิดพลาดการตรวจสอบความถูกต้องตามภาษาของแอปพลิเคชันโดยใช้ LangManager

รายการกฎที่กำหนดไว้ล่วงหน้า

PHPValidator มีกฎที่กำหนดไว้ล่วงหน้าที่หลากหลายซึ่งคุณสามารถใช้สำหรับการตรวจสอบข้อมูล นี่คือรายการของกฎที่ใช้กันทั่วไปบางอย่างพร้อมกับตัวอย่างของการใช้งาน:

1. กฎที่จำเป็น

   • ตรวจสอบให้แน่ใจว่ามีฟิลด์อยู่ในข้อมูล

    ' username ' => ' required '

2. กฎสตริง

   • ตรวจสอบว่าฟิลด์เป็นประเภทสตริงหรือไม่

    ' username ' => ' string '

3. กฎอีเมล

   • ตรวจสอบว่าฟิลด์เป็นที่อยู่อีเมลที่มีรูปร่างดี

    ' email ' => ' email '

4. กฎความยาวสูงสุด

   • ระบุความยาวสูงสุดของฟิลด์สตริง

    ' username ' => ' max:25 '

5. กฎที่ได้รับการยืนยัน

   • ตรวจสอบว่าค่าของฟิลด์นั้นเหมือนกับฟิลด์อื่นหรือไม่ (ใช้กันทั่วไปสำหรับการยืนยันรหัสผ่าน)

    ' password_confirmation ' => ' confirmed:password '

6. กฎไฟล์

   • ตรวจสอบว่าฟิลด์เป็นการอัปโหลดไฟล์

    ' file ' => ' file '

7. กฎที่ได้รับการยอมรับ

   • ตรวจสอบว่าฟิลด์คือ "yes" , "on" , "1" หรือ true มีประโยชน์สำหรับช่องทำเครื่องหมาย

    ' terms_and_conditions ' => ' accepted '

8. ยอมรับหากกฎ

   • ตรวจสอบว่าฟิลด์ได้รับการยอมรับหากฟิลด์อื่นเท่ากับค่าที่ระบุ

    ' terms_and_conditions ' => ' accepted_if:is_adult,true '

9. กฎ activeUrl

   • ตรวจสอบว่าฟิลด์เป็น URL ที่ใช้งานได้และใช้งานอยู่

    ' website ' => ' active_url '

10. กฎอัลฟ่า

    • ตรวจสอบว่าฟิลด์มีอักขระตัวอักษรเท่านั้น

     ' name ' => ' alpha '

11. กฎตัวเลข

    • ตรวจสอบว่าฟิลด์มีอักขระตัวเลขเท่านั้น

     ' age ' => ' numeric '

12. กฎตัวพิมพ์เล็ก

    • ตรวจสอบว่าฟิลด์มีอักขระตัวอักษรตัวพิมพ์เล็กเท่านั้น

     ' username ' => ' lowercase '

13. กฎตัวพิมพ์ใหญ่

    • ตรวจสอบว่าฟิลด์มีเฉพาะตัวอักษรตัวอักษรตัวอักษรเท่านั้น

     ' username ' => ' uppercase '

14. ในการปกครอง

    • ตรวจสอบว่าค่าของฟิลด์อยู่ในรายการของค่าที่กำหนดไว้ล่วงหน้า

     ' role ' => ' in:admin,editor,viewer '

15. กฎที่ไม่มีค่า

    • อนุญาตให้ฟิลด์เป็น null หรือว่างเปล่า

     ' optional_field ' => ' nullable '

16. กฎรหัสผ่าน

    • ตรวจสอบว่าฟิลด์เป็น secure password

     ' password ' => ' password '

17. กฎเดียวกัน

    • ตรวจสอบว่าค่าของฟิลด์นั้นเหมือนกับค่าของฟิลด์อื่น

     ' password_confirmation ' => ' same:password '

18. กฎความยาวสูงสุด

    • ระบุความยาวต่ำสุดของฟิลด์สตริง

     ' username ' => ' min:8 '

19. ไม่อยู่ในกฎ

    • ตรวจสอบว่าค่าของฟิลด์ไม่ได้อยู่ในชุดที่ระบุ

     ' value ' => ' not_in:foo,bar '

20. จำเป็นต้องมีกฎ

    • ต้องมีฟิลด์ที่จะอยู่หากมีฟิลด์ที่ระบุอื่น

     ' firstname ' => ' required_with:lastname ' ,

21. กฎ IP ที่ถูกต้อง

    • ตรวจสอบว่าค่าของฟิลด์เป็นที่อยู่ IP ที่ถูกต้อง

     ' client_ip ' => ' ip ' ,

22. กฎ JSON

    • ตรวจสอบว่าค่าของฟิลด์เป็นสตริง JSON ที่ถูกต้อง

     ' config ' => ' json ' ,

23. กฎ URL

    • ตรวจสอบว่าค่าของฟิลด์เป็น URL ที่ถูกต้อง

     ' website ' => ' url ' ,

24. กฎตัวเลขอัลฟ่า

    • ตรวจสอบว่าค่าของฟิลด์มีเฉพาะอักขระตัวอักษรและตัวเลข

     ' pseudo ' => ' alpha_num ' ,

25. กฎบูลีน

    • ตรวจสอบว่าค่าของฟิลด์เป็นบูลีน

     ' is_admin ' => ' bool ' ,

26. กฎขนาด

    • ตรวจสอบว่าขนาดของสตริง, จำนวนเต็ม, อาร์เรย์หรือไฟล์เท่ากับค่าที่ระบุ

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

27. ไม่จำเป็นต้องมีกฎ

    • ต้องการฟิลด์ที่ไม่ปรากฏหากมีฟิลด์ที่ระบุอื่น

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

ในตัวอย่างนี้เราสร้าง CustomPasswordRule ที่ตรวจสอบว่ารหัสผ่านมีค่าเท่ากับยืนยัน _Password คุณสามารถปรับแต่งวิธีการส่งผ่านเพื่อใช้ตรรกะการตรวจสอบความถูกต้องเฉพาะของคุณ

การบริจาค

หากคุณต้องการมีส่วนร่วมใน PHPValidator โปรดปฏิบัติตามแนวทางการบริจาคของเรา

ผู้เขียน

• Kabirou Alassane

สนับสนุน

สำหรับการสนับสนุนคุณสามารถติดต่อฉันทางอีเมลได้ที่ [email protected] อย่าลังเลที่จะติดต่อฉันหากคุณมีคำถามหรือต้องการความช่วยเหลือกับ phpvalidator

ใบอนุญาต

PHPValidator เป็นซอฟต์แวร์โอเพ่นซอร์สที่ได้รับอนุญาตภายใต้ใบอนุญาต MIT