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(6mo ago)012MITPHPPHP ^8.2

Since Dec 15Pushed 2mo 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 today

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

36

—

LowBetter than 79% of packages

Maintenance78

Regular maintenance activity

Popularity5

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

202d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/9713287?v=4)[Oveys Rostami](/maintainers/oveysrostami)[@oveysrostami](https://github.com/oveysrostami)

---

Top Contributors

[![oveysrostami](https://avatars.githubusercontent.com/u/9713287?v=4)](https://github.com/oveysrostami "oveysrostami (4 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

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[illuminate/pagination

The Illuminate Pagination package.

12234.1M1.0k](/packages/illuminate-pagination)[illuminate/pipeline

The Illuminate Pipeline package.

9349.2M282](/packages/illuminate-pipeline)[aedart/athenaeum

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

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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