PHPackages                             yiiviet/yii2-validator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation & Sanitization](/categories/validation)
4. /
5. yiiviet/yii2-validator

AbandonedArchivedYii2-extension[Validation & Sanitization](/categories/validation)

yiiviet/yii2-validator
======================

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

1.0.3.1(7y ago)44751BSD-3-ClausePHPPHP >=5.5

Since May 27Pushed 6y ago2 watchersCompare

[ Source](https://github.com/yiiviet/yii2-validator)[ Packagist](https://packagist.org/packages/yiiviet/yii2-validator)[ RSS](/packages/yiiviet-yii2-validator/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (6)Used By (0)

YII2 Việt Nam Validator
=======================

[](#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  để thay thế.

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

[![Latest Stable Version](https://camo.githubusercontent.com/0f6abec7681ace586b56df26d0696f6e4af8a9048c84695aacc1c6768939aa07/68747470733a2f2f706f7365722e707567782e6f72672f796969766965742f796969322d76616c696461746f722f762f737461626c65)](https://packagist.org/packages/yiiviet/yii2-validator)[![Total Downloads](https://camo.githubusercontent.com/7e13f81b2e8c367c8113edd7e9c5c9270df4831f1008be0c462a98444014d612/68747470733a2f2f706f7365722e707567782e6f72672f796969766965742f796969322d76616c696461746f722f646f776e6c6f616473)](https://packagist.org/packages/yiiviet/yii2-validator)[![Build Status](https://camo.githubusercontent.com/2586d652c319a7015d0afde91bd7415d8ecfe101fb8c357f7164956d12dc2e79/68747470733a2f2f7472617669732d63692e6f72672f796969766965742f796969322d76616c696461746f722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/yiiviet/yii2-validator)[![Code Coverage](https://camo.githubusercontent.com/864874605d2c44ce5dfdfd4845f0940ddaa783862a6d98535c109f85c027144c/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f796969766965742f796969322d76616c696461746f722f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/yiiviet/yii2-validator/?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/725782730c41f22336d5e68ad229883a145ae37012e1092fc2b30c59b841034e/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f796969766965742f796969322d76616c696461746f722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/yiiviet/yii2-validator/?branch=master)[![Yii2](https://camo.githubusercontent.com/d6b0929173e28cc627430d2519ca1853466a70f37395877eaf4820cb3e1e1909/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f506f77657265645f62792d5969695f4672616d65776f726b2d677265656e2e7376673f7374796c653d666c6174)](http://www.yiiframework.com/)

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.

Các kiểu dữ liệu hiện được hổ trợ:

- 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)

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](http://getcomposer.org/download/) để tìm hiểu nó.

```
composer require "yiiviet/yii2-validator"
```

hoặc thêm

```
"yiiviet/yii2-validator": "*"
```

vào phần `require` trong file composer.json.

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

[](#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`

Ví dụ:

```
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`:

ValidatorChú thíchCách dùngtelnumvnDùng để kiểm tra số điện thoại Việt Nam (viettel, vina, vsat, beeline, mobi, vietnammobi, số bàn...)[Nhấn vào đây](#telnumvn)idnumvnDùng để kiểm tra chứng minh thư, thẻ căn cước (chứng minh 9 số, 12 số, thẻ căn cước)[Nhấn vào đây](#idnumvn)ipvnDùng để kiểm tra IP Việt Nam[Nhấn vào đây](#ipvn)domainvnDùng để kiểm tra tên miền Việt Nam (là tên miền hợp lệ và kết thúc bằng `.vn`)[Nhấn vào đây](#domainvn)### `telnumvn`

[](#telnumvn)

Khai báo rules:

```
    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

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

Chỉ muốn kiểm tra số `viettel`

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

Chỉ muốn kiểm tra số `viettel`, `mobi`, `vina`

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

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

TelcoĐại diệnlandLineSố điện thoại bànviettelViettelvinaPhoneVinaphonemobiFoneMobifonevietNamMobileViet Nam MobilegMobileG MobileindoChinaIndoChina### `idnumvn`

[](#idnumvn)

Khai báo rules:

```
    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

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

### `ipvn`

[](#ipvn)

Khai báo rules:

```
    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](https://www.yiiframework.com/doc/guide/2.0/en/tutorial-core-validators#ip), còn không bạn chỉ cần khai báo như trên là đủ.

### `domainvn`

[](#domainvn)

Khai báo rules:

```
    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](https://github.com/dmitry-kulikov/yii2-domain-validator), còn không bạn chỉ cần khai báo như trên là đủ.

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

[](#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!

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~51 days

Total

5

Last Release

2701d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8901d64a1059726b851dbdd91463ad1d3169f9dba6a2dcff11d05f97d9bccaea?d=identicon)[vuongxuongminh](/maintainers/vuongxuongminh)

---

Top Contributors

[![vuongxuongminh](https://avatars.githubusercontent.com/u/38932626?v=4)](https://github.com/vuongxuongminh "vuongxuongminh (25 commits)")

---

Tags

validatorvietnamyii2yii2-extensionvalidatoryii2Viet Nam validator

### Embed Badge

![Health badge](/badges/yiiviet-yii2-validator/health.svg)

```
[![Health](https://phpackages.com/badges/yiiviet-yii2-validator/health.svg)](https://phpackages.com/packages/yiiviet-yii2-validator)
```

###  Alternatives

[paulzi/yii2-json-behavior

Yii2 json attribute behavior

76528.6k3](/packages/paulzi-yii2-json-behavior)[codeonyii/yii2-at-least-validator

Validates at least one (or more) attributes.

28253.5k1](/packages/codeonyii-yii2-at-least-validator)[arogachev/yii2-many-to-many

Many-to-many ActiveRecord relation for Yii 2 framework

3541.2k4](/packages/arogachev-yii2-many-to-many)[kdn/yii2-domain-validator

Domain name validator for Yii 2.

11122.3k1](/packages/kdn-yii2-domain-validator)[dstotijn/yii2-json-schema-validator

A Yii2 extension that provides a validator class for JSON Schema validation.

1730.7k](/packages/dstotijn-yii2-json-schema-validator)[insolita/yii2-array-structure-validator

Validate array with complex structure

1326.4k2](/packages/insolita-yii2-array-structure-validator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)