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

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

oveysrostami/laravel-persian-faker
==================================

A Laravel package for generating Persian fake data

1.0.0(4mo ago)09MITPHPPHP ^8.2

Since Dec 15Pushed 4mo agoCompare

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

READMEChangelogDependencies (2)Versions (2)Used By (0)

لاراول Persian Faker
--------------------

[](#لاراول-persian-faker)

یک پکیج ساده برای اضافه کردن داده‌ساز فارسی به Faker در پروژه‌های لاراول و تست‌های PHP.

### نصب

[](#نصب)

```
composer require oveysrostami/laravel-persian-faker
```

پکیج از auto-discovery لاراول استفاده می‌کند و به صورت خودکار به `Faker\Generator` اضافه می‌شود.

### استفاده در لاراول

[](#استفاده-در-لاراول)

```
// داخل تست‌ها، seeder یا factory
$faker = app(\Faker\Generator::class);

$faker->persianFirstName();      // حامد
$faker->persianLastName();       // کریمی
$faker->persianFullName('male'); // سینا مرادی
$faker->iranianMobile();         // 09121234567
$faker->iranianPhone();          // 02176543210
```

### استفاده خارج از لاراول

[](#استفاده-خارج-از-لاراول)

```
use Faker\Factory;
use Oveysrostami\LaravelPersianFaker\PersianFakerProvider;

$faker = Factory::create('fa_IR');
$faker->addProvider(new PersianFakerProvider($faker));

echo $faker->persianFullName();
```

### متدهای فعلی

[](#متدهای-فعلی)

- `persianFirstName(?string $gender = null)` — نام کوچک (مقادیر `male` یا `female` برای جنسیت اختیاری است)
- `persianLastName()` — نام خانوادگی
- `persianFullName(?string $gender = null)` — نام و نام خانوادگی
- `iranianMobile()` — شماره موبایل معتبر 11 رقمی
- `iranianPhone()` — شماره ثابت شهری با کد پیش‌شماره
- `iranianNationalCode()` — تولید کد ملی معتبر با الگوریتم کنترل رقم دهم
    - متد کمکی: `PersianFakerProvider::validateIranianNationalCode($code)`
- `persianWord()`, `persianWords($nb = 3, $asText = false)`
- `persianSentence($nbWords = 6, $variableNbWords = true)`
- `persianSentences($nb = 3)`
- `persianParagraph($nbSentences = 3, $variableNbSentences = true)`
- `persianParagraphs($nb = 3)`
- `persianProvince()`, `persianCity($province = null)`, `persianStreet()`
- `persianAddress(array $options = [])` — به طور پیش‌فرض همه اجزا را دارد؛ می‌توانید اجزای زیر را `true/false` کنید یا `randomize_missing => true` بدهید تا تصادفی حذف/اضافه شوند:
    - `province`, `city`, `street`, `plaque`, `unit`, `postal_code`
- `persianPostalCode()` — کد پستی ۱۰ رقمی معتبر (بدون تکرار یکنواخت ارقام و بدون صفر در ابتدای کد)
- `persianCompanyName()` — نام شرکت ایرانی
- `persianBrandName()` — نام برند/محصول ایرانی
- `iranianBankName()` — نام بانک ایرانی
- `iranianCardNumber(?string $bankName = null)` — شماره کارت ۱۶ رقمی با الگوریتم لوهن. اگر `bankName` بدهید از BIN آن بانک استفاده می‌شود، در غیر این صورت به صورت تصادفی یکی انتخاب می‌شود.
- `iranianSheba(?string $bankName = null)` — شماره شبا ۲۶ کاراکتری (IR + ۲۴ رقم). اگر بانک مشخص شود از کد بانک استفاده می‌کند، در غیر این صورت تصادفی انتخاب می‌شود.
- `persianJobTitle()` — عنوان شغلی فارسی (مدیرعامل، معاون، سرتیپ، کارشناس، ...).
- `persianProfession()` — حرفه/شغل عمومی (پزشک، پرستار، کارگر، بنا، برنامه‌نویس، گرافیست، ...).

### مدیریت دیتاست

[](#مدیریت-دیتاست)

برای اضافه/حذف نام‌ها یا پیش‌شماره‌ها، فقط فایل‌های `resources/data/names.php` و `resources/data/phones.php` را ویرایش کنید. Provider داده‌ها را در زمان اجرا از این فایل‌ها می‌خواند.

### تست سریع (Smoke test)

[](#تست-سریع-smoke-test)

یک اسکریپت ساده برای اطمینان از اتصال provider:

```
php tests/smoke.php
```

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance74

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

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

Unknown

Total

1

Last Release

148d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9e27e3ae88fb98040818962d6e2673d5aac3992dce24a71592c9010c507f35b0?d=identicon)[oveysrostami](/maintainers/oveysrostami)

---

Top Contributors

[![oveysrostami](https://avatars.githubusercontent.com/u/9713287?v=4)](https://github.com/oveysrostami "oveysrostami (3 commits)")

### Embed Badge

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

```
[![Health](https://phpackages.com/badges/oveysrostami-laravel-persian-faker/health.svg)](https://phpackages.com/packages/oveysrostami-laravel-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)