PHPackages                             ductho1201/vnfaker - 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. [Utility & Helpers](/categories/utility)
4. /
5. ductho1201/vnfaker

ActivePackage[Utility & Helpers](/categories/utility)

ductho1201/vnfaker
==================

VNFaker is a Laravel package that generates fake data about name, city, address, phone,... in Viet Nam

v1.0.0(6y ago)043MITPHP

Since Feb 24Pushed 6y agoCompare

[ Source](https://github.com/ductho1201/VNFaker)[ Packagist](https://packagist.org/packages/ductho1201/vnfaker)[ Docs](https://github.com/BuiHuyCuong/VNFaker)[ RSS](/packages/ductho1201-vnfaker/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

VNFaker
=======

[](#vnfaker)

VNFaker is a Laravel package that generates fake data about name, city, address, phone, datetime,... in Viet Nam.

### Require

[](#require)

- PHP >= 5.3.3
- Laravel >= 5.0

### Installation

[](#installation)

```
composer require buihuycuong/vnfaker
```

### Basic Usage

[](#basic-usage)

Add to your class:

```
use Buihuycuong\Vnfaker\VNFaker;
VNFaker::date();
// 12/02/1980
# or call via helper function
vnfaker()->date();
// 10/08/1996
```

#### `Name`

[](#name)

```
vnfaker()->lastname(); // Bùi
vnfaker()->midname(); // Huy
vnfaker()->firstname($word = 1); // 1:Cường, 2: Huy Cường
vnfaker()->fullname($word = 3); // 3: Bùi Huy Cường, 4: Bùi Huy Hoàng Cường
```

#### `Time`

[](#time)

```
vnfaker()->date($symbol = '/'); // 12/02/1980
vnfaker()->year(); // 1990
vnfaker()->month(); // 10
vnfaker()->day(); // 05
```

#### `Address`

[](#address)

```
vnfaker()->address(); // Hai bà trưng, Hà nội
vnfaker()->city($array = false); // Hà nội, true-> return 63 province.
```

#### `Phone`

[](#phone)

```
vnfaker()->mobilephone($numbers = 10); // 0979587347
vnfaker()->fixedLineNumber($numbers = 12); // 0248584903
vnfaker()->cityphone($numbers = 12); // 0240897395 (Ha Noi)
```

#### `Email, username`

[](#email-username)

```
vnfaker()->email(array $domain); //default: ['gmail.com', 'outlook.com', 'example.com'] -> buihuycuong@gmail.com
vnfaker()->username(); // buihuycuong
```

#### `Number`

[](#number)

```
vnfaker()->int(); // 69
vnfaker()->maxInt(); // 2147483647
vnfaker()->float($min = 0, $max = 100, $decimals = 2); // 69,96
vnfaker()->numberBetween(int $min = 0, int $max = 100000); // 69
vnfaker()->boolean($string = true); // true|false : 1|0
```

#### `OrderNo`

[](#orderno)

```
vnfaker()->generateOrderNo($length = 6, $prefix = null, $postfix = null, $numbers = false, $letters = false, $uppercase = false, $lowercase = false); // DHF3K8
```

#### `String`

[](#string)

```
vnfaker()->paragraphs(int $paragraph = 1, bool $array = false, $glue = ''); // Tình yêu đến em không mong đợi gì. Tình yêu đi em không hề hối tiếc.
vnfaker()->words(int $word = 2, bool $array = false, $glue = ', '); // Bùi, Huy
vnfaker()->sentences(int $sentence = 1, bool $array = false, $glue = '. '); // Tình yêu đến em không mong đợi gì
vnfaker()->vnToString($str = "Bùi Huy Cường"); // Bui Huy Cuong
vnfaker()->str_clean($string, $remove_space = false); // remove all special characters
```

#### `Color`

[](#color)

```
vnfaker()->hexcolor(); // #830f0
vnfaker()->colorName(); // red
```

#### `File`

[](#file)

```
vnfaker()->file($name = null, array $extentions = ['png', 'jpg'], $width = 100, $height = 100, $mimeType = 'image'); // avatar.png
```

#### `More`

[](#more)

```
vnfaker()->company(); // Tập Đoàn Vingroup
vnfaker()->gender(); // Nam | Nữ
vnfaker()->array_rand(array $items, $num = 1, $array = false, $glue = ',');
```

### Change log

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

### License

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

### Author

[](#author)

- [Bui Huy Cuong](https://medium.com/@buihuycuong/)

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 94.4% 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

Unknown

Total

1

Last Release

2266d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6875ffd2435a6d67be30dcea17ba81a19e5d94c9cf29d0717acc7211abe65232?d=identicon)[ductho1201](/maintainers/ductho1201)

---

Top Contributors

[![itbk95](https://avatars.githubusercontent.com/u/15372593?v=4)](https://github.com/itbk95 "itbk95 (17 commits)")[![ductho1201](https://avatars.githubusercontent.com/u/11205362?v=4)](https://github.com/ductho1201 "ductho1201 (1 commits)")

---

Tags

phplaraveldatalaravel-fakervnfakerviet namBui Huy CuongRichard Bui

### Embed Badge

![Health badge](/badges/ductho1201-vnfaker/health.svg)

```
[![Health](https://phpackages.com/badges/ductho1201-vnfaker/health.svg)](https://phpackages.com/packages/ductho1201-vnfaker)
```

###  Alternatives

[iteks/laravel-enum

A comprehensive Laravel package providing enhanced enum functionalities, including attribute handling, select array conversions, and fluent facade interactions for robust enum management in Laravel applications.

2516.7k](/packages/iteks-laravel-enum)[amranidev/laracombee

Recommendation system for laravel

11636.7k1](/packages/amranidev-laracombee)[wujunze/money-wrapper

MoneyPHP Wrapper

113.8k](/packages/wujunze-money-wrapper)

PHPackages © 2026

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