PHPackages                             cnaebadi/persian-faker - 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. cnaebadi/persian-faker

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

cnaebadi/persian-faker
======================

A Laravel package for generating Persian fake data, including names, addresses, phone numbers, and more.

2.0.0(5mo ago)43MITPHPPHP >=8.0

Since Dec 31Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/cnaebadi/persian-faker)[ Packagist](https://packagist.org/packages/cnaebadi/persian-faker)[ RSS](/packages/cnaebadi-persian-faker/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (3)Used By (0)

Persian Faker
=============

[](#persian-faker)

A Laravel package to generate Persian fake data for testing and development purposes.

Features
--------

[](#features)

- Generate random Persian names, addresses, phone numbers, and more.
- Supports a wide range of data types such as job titles, dates, and emails.

Installation
------------

[](#installation)

Run the following command to install via Composer:

```
composer require cnaebadi/persian-faker
```

Usage
-----

[](#usage)

Here's how you can use the package in your Laravel project:

```
use Cnaebadi\PersianFaker\Faker\PersianFaker;
use Faker\Factory as FakerFactory;

// Create a Faker instance
$faker = FakerFactory::create();

// Create a PersianFaker instance
$persianFaker = new PersianFaker($faker);

// Generate Persian fake data
echo $persianFaker->randomFullName(); // Outputs a random Persian full name
echo $persianFaker->randomLandlinePhone(); // Outputs a random landline phone number
echo $persianFaker->randomAddress(); // Outputs a random Persian address
```

Methods
-------

[](#methods)

The following methods are available for generating fake data:

#### `randomFullName()`

[](#randomfullname)

Generates a random full name in Persian.
Example: `محمد رضا احمدی`

#### `randomEnglishFullName()`

[](#randomenglishfullname)

Generates a random full name in English.
Example: `Sina Mohammadi`

#### `randomFirstName()`

[](#randomfirstname)

Generates a random first name in Persian.
Example: `زهرا`

#### `randomEnglishFirstName()`

[](#randomenglishfirstname)

Generates a random first name in English.
Example: `Ali`

#### `randomLastName()`

[](#randomlastname)

Generates a random last name in Persian.
Example: `کاظمی`

#### `randomEnglishLastName()`

[](#randomenglishlastname)

Generates a random last name in English.
Example: `Karimi`

#### `randomMaleFirstName()`

[](#randommalefirstname)

Generates a random male first name in Persian.
Example: `حسین`

#### `randomEnglishMaleFirstName()`

[](#randomenglishmalefirstname)

Generates a random male first name in English.
Example: `Reza`

#### `randomFemaleFirstName()`

[](#randomfemalefirstname)

Generates a random female first name in Persian.
Example: `نرگس`

#### `randomEnglishFemaleFirstName()`

[](#randomenglishfemalefirstname)

Generates a random female first name in English.
Example: `Sara`

#### `randomJobTitle()`

[](#randomjobtitle)

Generates a random job title.
Example: `مهندس نرم‌افزار`

#### `randomAddress()`

[](#randomaddress)

Generates a random address in Persian.
Example: `تهران، خیابان ولیعصر، کوچه احمدی، پلاک 5، واحد 2`

#### `randomLandlinePhone()`

[](#randomlandlinephone)

Generates a random landline phone number.
Example: `02112345678`

#### `randomMobilePhone()`

[](#randommobilephone)

Generates a random mobile phone number.
Example: `09123456789`

#### `randomEmail()`

[](#randomemail)

Generates a random email address.
Example: `sina.mohammadi@gmail.com`

#### `randomNationalCode()`

[](#randomnationalcode)

Generates a random national code.
Example: `1234567890`

#### `randomPostalCode()`

[](#randompostalcode)

Generates a random postal code.
Example: `1234567890`

#### `randomDate()`

[](#randomdate)

Generates a random date.
Example: `1399/5/21`

#### `randomWord()`

[](#randomword)

Generates a random Persian word.
Example: `دوست`

#### `randomSentence()`

[](#randomsentence)

Generates a random Persian sentence.
Example: `او کتاب خود را خواند.`

#### `randomParagraph()`

[](#randomparagraph)

Generates a random Persian paragraph.
Example: `این یک پاراگراف نمونه است که شامل کلمات مختلف می‌باشد.`

#### `randomState()`

[](#randomstate)

Generates a random Persian state.
Example: `تهران`

#### `randomCity()`

[](#randomcity)

Generates a random Persian city.
Example: `اصفهان`

#### `randomStreet()`

[](#randomstreet)

Generates a random Persian street.
Example: `خیابان حافظ`

#### `randomProtocol()`

[](#randomprotocol)

Generates a random protocol (e.g., http or https).
Example: `https`

#### `randomDomain()`

[](#randomdomain)

Generates a random domain.
Example: `example.com`

#### `randomBank()`

[](#randombank)

Generates a random bank name in Persian.
Example: `بانک ملی`

#### `randomEnglishBank()`

[](#randomenglishbank)

Generates a random bank name in English.
Example: `Mellat Bank`

Contribution
------------

[](#contribution)

We welcome contributions!
To contribute, fork the repository, make your changes, and submit a pull request. Please ensure your code is clean and well-documented. Thank you!

Thanks
------

[](#thanks)

This project was inspired by my dear friend, @Keivan-S . I am truly grateful for his guidance and support.

License
-------

[](#license)

This package is open-source and licensed under the MIT license.

فیکر فارسی
==========

[](#فیکر-فارسی)

یک پکیج لاراول برای تولید داده‌های تصادفی فارسی برای تست و توسعه.

ویژگی‌ها
--------

[](#ویژگی‌ها)

- تولید نام، آدرس، شماره تلفن و دیگر داده‌های فارسی.
- پشتیبانی از انواع مختلف داده‌ها مانند عنوان شغلی، تاریخ و ایمیل.

نصب
---

[](#نصب)

برای نصب این پکیج از دستور زیر استفاده کنید:

```
composer require cnaebadi/persian-faker
```

استفاده
-------

[](#استفاده)

نمونه‌ای از نحوه استفاده از پکیج در پروژه لاراول:

```
use Cnaebadi\PersianFaker\Faker\PersianFaker;
use Faker\Factory as FakerFactory;

// ساخت نمونه Faker
$faker = FakerFactory::create();

// ساخت نمونه PersianFaker
$persianFaker = new PersianFaker($faker);

// تولید داده‌های تصادفی فارسی
echo $persianFaker->randomFullName(); // تولید یک نام کامل تصادفی فارسی
echo $persianFaker->randomLandlinePhone(); // تولید یک شماره تلفن ثابت تصادفی
echo $persianFaker->randomAddress(); // تولید یک آدرس تصادفی فارسی
```

متدها
-----

[](#متدها)

متدهای موجود برای تولید داده‌های تصادفی:

#### `randomFullName()`

[](#randomfullname-1)

یک نام کامل تصادفی به زبان فارسی تولید می‌کند.
مثال: `محمد رضا احمدی`

#### `randomEnglishFullName()`

[](#randomenglishfullname-1)

یک نام کامل تصادفی به زبان انگلیسی تولید می‌کند.
مثال: `Sina Mohammadi`

#### `randomFirstName()`

[](#randomfirstname-1)

یک نام کوچک تصادفی به زبان فارسی تولید می‌کند.
مثال: `زهرا`

#### `randomEnglishFirstName()`

[](#randomenglishfirstname-1)

یک نام کوچک تصادفی به زبان انگلیسی تولید می‌کند.
مثال: `Ali`

#### `randomLastName()`

[](#randomlastname-1)

یک نام خانوادگی تصادفی به زبان فارسی تولید می‌کند.
مثال: `کاظمی`

#### `randomEnglishLastName()`

[](#randomenglishlastname-1)

یک نام خانوادگی تصادفی به زبان انگلیسی تولید می‌کند.
مثال: `Karimi`

#### `randomMaleFirstName()`

[](#randommalefirstname-1)

یک نام کوچک مردانه تصادفی به زبان فارسی تولید می‌کند.
مثال: `حسین`

#### `randomEnglishMaleFirstName()`

[](#randomenglishmalefirstname-1)

یک نام کوچک مردانه تصادفی به زبان انگلیسی تولید می‌کند.
مثال: `Reza`

#### `randomFemaleFirstName()`

[](#randomfemalefirstname-1)

یک نام کوچک زنانه تصادفی به زبان فارسی تولید می‌کند.
مثال: `نرگس`

#### `randomEnglishFemaleFirstName()`

[](#randomenglishfemalefirstname-1)

یک نام کوچک زنانه تصادفی به زبان انگلیسی تولید می‌کند.
مثال: `Sara`

#### `randomJobTitle()`

[](#randomjobtitle-1)

یک عنوان شغلی تصادفی تولید می‌کند.
مثال: `مهندس نرم‌افزار`

#### `randomAddress()`

[](#randomaddress-1)

یک آدرس تصادفی به زبان فارسی تولید می‌کند.
مثال: `تهران، خیابان ولیعصر، کوچه احمدی، پلاک 5، واحد 2`

#### `randomLandlinePhone()`

[](#randomlandlinephone-1)

یک شماره تلفن ثابت تصادفی تولید می‌کند.
مثال: `02112345678`

#### `randomMobilePhone()`

[](#randommobilephone-1)

یک شماره تلفن همراه تصادفی تولید می‌کند.
مثال: `09123456789`

#### `randomEmail()`

[](#randomemail-1)

یک ایمیل تصادفی تولید می‌کند.
مثال: `sina.mohammadi@gmail.com`

#### `randomNationalCode()`

[](#randomnationalcode-1)

یک کد ملی تصادفی تولید می‌کند.
مثال: `1234567890`

#### `randomPostalCode()`

[](#randompostalcode-1)

یک کد پستی تصادفی تولید می‌کند.
مثال: `1234567890`

#### `randomDate()`

[](#randomdate-1)

یک تاریخ تصادفی تولید می‌کند.
مثال: `1399/5/21`

#### `randomWord()`

[](#randomword-1)

یک کلمه تصادفی به زبان فارسی تولید می‌کند.
مثال: `دوست`

#### `randomSentence()`

[](#randomsentence-1)

یک جمله تصادفی به زبان فارسی تولید می‌کند.
مثال: `او کتاب خود را خواند.`

#### `randomParagraph()`

[](#randomparagraph-1)

یک پاراگراف تصادفی به زبان فارسی تولید می‌کند.
مثال: `این یک پاراگراف نمونه است که شامل کلمات مختلف می‌باشد.`

#### `randomState()`

[](#randomstate-1)

یک استان تصادفی به زبان فارسی تولید می‌کند.
مثال: `تهران`

#### `randomCity()`

[](#randomcity-1)

یک شهر تصادفی به زبان فارسی تولید می‌کند.
مثال: `اصفهان`

#### `randomStreet()`

[](#randomstreet-1)

یک خیابان تصادفی به زبان فارسی تولید می‌کند.
مثال: `خیابان حافظ`

#### `randomProtocol()`

[](#randomprotocol-1)

یک پروتکل تصادفی (مثل http یا https) تولید می‌کند.
مثال: `https`

#### `randomDomain()`

[](#randomdomain-1)

یک دامنه تصادفی تولید می‌کند.
مثال: `example.com`

#### `randomBank()`

[](#randombank-1)

یک نام بانک تصادفی به زبان فارسی تولید می‌کند.
مثال: `بانک ملی`

#### `randomEnglishBank()`

[](#randomenglishbank-1)

یک نام بانک تصادفی به زبان انگلیسی تولید می‌کند.
مثال: `Mellat Bank`

تشکر و قدردانی
--------------

[](#تشکر-و-قدردانی)

این پروژه با الهام از دوست عزیزم، کیوان، ساخته شده است. از راهنمایی‌ها و حمایت‌های او بسیار سپاسگزارم.

مشارکت
------

[](#مشارکت)

مشارکت شما باعث خوشحالی ماست!
برای مشارکت، مخزن را Fork کنید، تغییرات خود را اعمال کرده و یک Pull Request ارسال کنید. لطفاً مطمئن شوید که کد شما تمیز و مستند است. سپاسگزاریم!

مجوز
----

[](#مجوز)

این پکیج متن‌باز است و تحت مجوز MIT منتشر شده است.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance70

Regular maintenance activity

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 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 ~319 days

Total

2

Last Release

177d ago

Major Versions

v1.0.0 → 2.0.02025-11-16

### Community

Maintainers

![](https://www.gravatar.com/avatar/961ccb069b001f13e4347489d06972da2aacc01316b2ca94bb422ec7a24c8b5f?d=identicon)[cnaebadi](/maintainers/cnaebadi)

---

Top Contributors

[![cnaebadi](https://avatars.githubusercontent.com/u/45448941?v=4)](https://github.com/cnaebadi "cnaebadi (22 commits)")

---

Tags

backendfakerfaker-librarylaravellaravel-package

### Embed Badge

![Health badge](/badges/cnaebadi-persian-faker/health.svg)

```
[![Health](https://phpackages.com/badges/cnaebadi-persian-faker/health.svg)](https://phpackages.com/packages/cnaebadi-persian-faker)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[illuminate/pipeline

The Illuminate Pipeline package.

9446.6M213](/packages/illuminate-pipeline)[illuminate/pagination

The Illuminate Pagination package.

10532.5M862](/packages/illuminate-pagination)[spatie/laravel-pjax

A pjax middleware for Laravel 5

513371.8k11](/packages/spatie-laravel-pjax)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)[spatie/laravel-mix-preload

Add preload and prefetch links based your Mix manifest

169176.0k2](/packages/spatie-laravel-mix-preload)

PHPackages © 2026

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