yiiviet/yii2-validator

Extension hổ trợ các validator dữ liệu đặc thù trong nước.

YII2 Việt Nam Validator

Thông báo chúng tôi đã ngừng phát triển extension này, hãy sử dụng https://github.com/phpviet/yii-validation để thay thế., _(*1)

Yii2 Extension hổ trợ bạn kiểm tra dữ liệu đặc thù trong nước ta., _(*2)

, _(*3)

Khi bạn xây dựng hệ thống trong nước thì chắc chắn rằng việc xây dựng các validator để kiểm tra dữ liệu đặc thù như: số điện thoại, chứng minh thư, ip Việt Nam, domain Việt Nam... sẽ thường xuyên xảy ra. Chính vì vậy extension này được xây dựng nên để cung cấp các validator phổ biến nhất về các dữ liệu cơ bản tại nước ta., _(*4)

Các kiểu dữ liệu hiện được hổ trợ:, _(*5)

• Số điện thoại bao gồm số di động và số bàn.
• Chứng minh thư và thẻ căn cước.
• IP Việt Nam
• Tên miền Việt Nam

Cài đặt

Cài đặt thông qua composer nếu như đó là một khái niệm mới với bạn xin click vào đây để tìm hiểu nó., _(*6)

composer require "yiiviet/yii2-validator"

hoặc thêm, _(*7)

"yiiviet/yii2-validator": "*"

vào phần require trong file composer.json., _(*8)

Cách sử dụng cơ bản

Về cách sử dụng thì bạn khai báo nó vào rules của model, AR như các validator thuần của yii2, _(*9)

Ví dụ:, _(*10)

class Info extends Model {

    public function rules() {

        return [
            ['IP', 'ipvn'],
            ['SDT', 'telnumvn'],
            ['CMND', 'idnumvn'],
            ['domain', 'domainvn']
        ];

    }
}

Bảng chú thích tên các validator:, _(*11)

telnumvn

Khai báo rules:, _(*12)

    return [
        ['SDT', 'telnumvn', 'message' => '{attribute} không phải là số điện thoại Việt Nam'],
    ];

Chỉ muốn kiểm tra số di động loại bỏ số bàn, _(*13)

    return [
        ['SDT', 'telnumvn', 'exceptTelco' => ['landLine']],
    ];

Chỉ muốn kiểm tra số viettel, _(*14)

    return [
        ['SDT', 'telnumvn', 'onlyTelco' => ['viettel']],
    ];

Chỉ muốn kiểm tra số viettel, mobi, vina, _(*15)

    return [
        ['SDT', 'telnumvn', 'onlyTelco' => ['viettel', 'mobiFone', 'vinaPhone']],
    ];

Danh sách tên các telco (nhà mạng), _(*16)

idnumvn

Khai báo rules:, _(*17)

    return [
        ['CMND', 'idnumvn', 'message' => '{attribute} không phải là chứng minh thư Việt Nam'],
    ];

Chỉ muốn kiểm tra số chứng minh (9 và 12 số) thư loại bỏ thẻ căn cước, _(*18)

    return [
        ['SDT', 'telnumvn', 'onlyId' => true],
    ];

ipvn

Khai báo rules:, _(*19)

    return [
        ['IP', 'ipvn', 'message' => '{attribute} phải là IP Việt Nam!'],
    ];

Do validator này kế thừa IpValidator của Yii2 nên tất cả các tham số thiết lập nâng cao bạn có thể kham khảo thêm tại đây, còn không bạn chỉ cần khai báo như trên là đủ., _(*20)

domainvn

Khai báo rules:, _(*21)

    return [
        ['domain', 'domainvn', 'message' => '{attribute} phải là tên miền Việt Nam!'],
    ];

Do validator này kế thừa DomainValidator của Dmitry Kulikov nên tất cả các tham số thiết lập nâng cao bạn có thể kham khảo thêm tại đây, còn không bạn chỉ cần khai báo như trên là đủ., _(*22)

Dành cho nhà phát triển

Nếu như bạn cảm thấy các validators bên trên vẫn chưa đủ đối với thị trường trong nước và bạn muốn đóng góp để phát triển chung, chúng tôi rất hoan nghênh! Hãy tạo các issue để đóng góp ý tưởng cho phiên bản kế tiếp hoặc tạo PR để đóng góp thêm các validator còn thiếu sót. Cảm ơn!, _(*23)