PHPackages                             rippledevs/laravel-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. [Localization & i18n](/categories/localization)
4. /
5. rippledevs/laravel-faker

ActiveLibrary[Localization & i18n](/categories/localization)

rippledevs/laravel-faker
========================

An advanced Faker extension for Laravel providing comprehensive Persian (Iran) localization and missing global utilities.

v1.0.0(5mo ago)10MITPHPPHP ^8.0CI passing

Since Jan 16Pushed 5mo agoCompare

[ Source](https://github.com/rippledevs/laravel-faker)[ Packagist](https://packagist.org/packages/rippledevs/laravel-faker)[ RSS](/packages/rippledevs-laravel-faker/feed)WikiDiscussions main Synced today

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

🚀 RippleDevs Laravel Faker
==========================

[](#-rippledevs-laravel-faker)

[![Latest Version](https://camo.githubusercontent.com/4bb46ef975b576c6ca2177d8732062ec0f9563f5ab9ab8eca5bfef8bbbdb584c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726970706c65646576732f6c61726176656c2d66616b6572)](https://camo.githubusercontent.com/4bb46ef975b576c6ca2177d8732062ec0f9563f5ab9ab8eca5bfef8bbbdb584c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726970706c65646576732f6c61726176656c2d66616b6572)[![Tests](https://github.com/rippledevs/laravel-faker/workflows/Tests/badge.svg)](https://github.com/rippledevs/laravel-faker/workflows/Tests/badge.svg)[![License](https://camo.githubusercontent.com/1cd926a2348b5e068fd3a4951aa15f90d86c332266cf982550578ae04c6e2970/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f726970706c65646576732f6c61726176656c2d66616b6572)](https://camo.githubusercontent.com/1cd926a2348b5e068fd3a4951aa15f90d86c332266cf982550578ae04c6e2970/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f726970706c65646576732f6c61726176656c2d66616b6572)

An advanced and extensible **Laravel Faker extension** that enhances Laravel’s Faker system with **localized providers**, **regional datasets**, and **missing global utilities**.

Currently, the package includes a comprehensive **Persian (fa\_IR) localization** with Iranian-specific generators such as **Sheba**, **National Code**, **Bank Card Number**, **Postal Code**, and **Persian Lorem Ipsum** — with a roadmap designed to support additional locales and Laravel-related utilities in the future.

Built to integrate seamlessly with Laravel’s Faker ecosystem while remaining flexible and expandable.

---

✨ Features
----------

[](#-features)

- 🌍 Extensible Faker providers architecture
- 🇮🇷 Persian (fa\_IR) localization (Iran)
- Localized Lorem Ipsum generators
- Language-specific word generators
- Regional & global utility generators
- Validated algorithm-based data generation
- Fully compatible with Laravel 9, 10, 11, and 12
- PHP 8+ support

---

📦 Installation
--------------

[](#-installation)

Install via Composer:

```
composer require rippledevs/laravel-faker
```

Laravel will auto-discover the service provider.

---

⚙️ Configuration
----------------

[](#️-configuration)

⚠️ **Important**

To use this package, you **must** set Faker locale to `fa_IR`.

Edit `config/app.php`:

```
'faker_locale' => 'fa_IR',
```

Without this configuration, the custom Persian Faker methods will **not** be available.

---

🚀 Usage
-------

[](#-usage)

Use Laravel’s `fake()` helper or `$this->faker` inside factories and seeders.

```
fake()->sheba();
```

---

🧩 Available Methods
-------------------

[](#-available-methods)

### Persian Lorem Ipsum

[](#persian-lorem-ipsum)

```
fake()->sentence();        // Persian lorem sentence
fake()->paragraph();       // Persian lorem paragraph
fake()->paragraphs(3);     // Multiple paragraphs
fake()->lorem();           // Alias for paragraph()
```

---

### Persian Words

[](#persian-words)

```
fake()->word();            // Random Persian word
fake()->words(5);          // Array of Persian words
```

---

### Iranian Utilities

[](#iranian-utilities)

```
fake()->nationalCode();     // Valid Iranian National Code
fake()->sheba();            // Valid Iranian Sheba (IBAN)
fake()->bankCardNumber();   // Iranian bank card number
fake()->postalCode();       // Valid Iranian postal code
```

All generated values are **algorithmically valid**.

---

🧪 Testing
---------

[](#-testing)

Run tests using:

```
vendor/bin/phpunit
```

---

📋 Requirements
--------------

[](#-requirements)

- PHP ^8.0
- Laravel ^9 | ^10 | ^11 | ^12
- fakerphp/faker ^1.23

---

📄 License
---------

[](#-license)

This package is open-sourced software licensed under the **MIT License**.

---

👤 Author
--------

[](#-author)

**RippleDevs**
📧

---

🤝 Contributing
--------------

[](#-contributing)

Contributions, issues, and feature requests are welcome.

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Open a Pull Request

---

⭐ Support
---------

[](#-support)

If you find this package useful, please consider giving it a ⭐ on GitHub.

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance70

Regular maintenance activity

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

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

168d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/255113182?v=4)[RippleDevs](/maintainers/rippledevs)[@rippledevs](https://github.com/rippledevs)

---

Top Contributors

[![rippledevs](https://avatars.githubusercontent.com/u/255113182?v=4)](https://github.com/rippledevs "rippledevs (26 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[illuminate/translation

The Illuminate Translation package.

6938.0M572](/packages/illuminate-translation)[erag/laravel-lang-sync-inertia

A powerful Laravel package for syncing and managing language translations across backend and Inertia.js (Vue/React/Svelte) frontends, offering effortless localization, auto-sync features, and smooth multi-language support for modern Laravel applications.

4925.3k](/packages/erag-laravel-lang-sync-inertia)[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)