PHPackages                             nguyenhiep/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. nguyenhiep/vnfaker

ActivePackage

nguyenhiep/vnfaker
==================

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

0135PHP

Since May 18Pushed 4y agoCompare

[ Source](https://github.com/nguyenhiepvan/VNFaker)[ Packagist](https://packagist.org/packages/nguyenhiep/vnfaker)[ RSS](/packages/nguyenhiep-vnfaker/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (1)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 nguyenhiep/vnfaker
```

### Basic Usage

[](#basic-usage)

Add to your class:

```
use Nguyenhiep\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

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity29

Early-stage or recently created project

 Bus Factor1

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

### Community

Maintainers

![](https://www.gravatar.com/avatar/5ee7ece29e66e7029d6b12d947a7d9714ae36346f21e92d767cfc797b86949d8?d=identicon)[nguyenhiepvan](/maintainers/nguyenhiepvan)

---

Top Contributors

[![itbk95](https://avatars.githubusercontent.com/u/15372593?v=4)](https://github.com/itbk95 "itbk95 (17 commits)")[![nguyenhiepvan](https://avatars.githubusercontent.com/u/33170716?v=4)](https://github.com/nguyenhiepvan "nguyenhiepvan (10 commits)")

### Embed Badge

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

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

PHPackages © 2026

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