PHPackages                             usmanahmedmalik/muslim-name-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. [Testing & Quality](/categories/testing)
4. /
5. usmanahmedmalik/muslim-name-faker

ActiveLibrary[Testing & Quality](/categories/testing)

usmanahmedmalik/muslim-name-faker
=================================

Generate realistic Muslim fake names from Arab, Iranian, and Pakistani origins. Works with Laravel or standalone PHP.

v1.1.0(3mo ago)01MITPHPPHP ^7.4|^8.0|^8.1|^8.2|^8.3

Since Jan 31Pushed 3mo agoCompare

[ Source](https://github.com/usmanahmedmalik/muslim-name-faker)[ Packagist](https://packagist.org/packages/usmanahmedmalik/muslim-name-faker)[ RSS](/packages/usmanahmedmalik-muslim-name-faker/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (3)Used By (0)

Muslim Name Faker
=================

[](#muslim-name-faker)

[![Latest Version on Packagist](https://camo.githubusercontent.com/cbe9d205a2c0aa9153058dcfdd90154c0dc8416387b8cbe7627cf09854903bc2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f75736d616e61686d65646d616c696b2f6d75736c696d2d6e616d652d66616b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/usmanahmedmalik/muslim-name-faker)[![Total Downloads](https://camo.githubusercontent.com/32866ae0f6091a22013a7c7203d54e4966454c30f5e84bb95a39867162ecd843/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f75736d616e61686d65646d616c696b2f6d75736c696d2d6e616d652d66616b65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/usmanahmedmalik/muslim-name-faker)

A PHP package that generates realistic fake Muslim names for testing and development purposes. Works seamlessly with Laravel or as a standalone PHP library.

Features
--------

[](#features)

- **1300+ Authentic Names** from Arab, Iranian, Pakistani, Indonesian, Malaysian, Bangladeshi, and African Muslim origins
- **Gender-Specific** male and female name generation
- **Origin Filtering** to generate names from specific regions
- **Laravel Integration** with Service Provider and Facade
- **Standalone PHP Support** for use in any PHP project
- **Helper Functions** for quick and easy name generation
- **Fully Tested** with comprehensive PHPUnit test suite

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

[](#installation)

### Via Composer

[](#via-composer)

```
composer require usmanahmedmalik/muslim-name-faker
```

### Laravel Auto-Discovery

[](#laravel-auto-discovery)

If you're using Laravel 5.5 or higher, the package will automatically register itself. For older versions, add the service provider to `config/app.php`:

```
'providers' => [
    // ...
    MuslimNameFaker\Laravel\MuslimNameFakerServiceProvider::class,
],
```

And optionally add the facade:

```
'aliases' => [
    // ...
    'MuslimNameFaker' => MuslimNameFaker\Laravel\Facades\MuslimNameFaker::class,
],
```

Usage
-----

[](#usage)

### Standalone PHP

[](#standalone-php)

```
use MuslimNameFaker\MuslimNameFaker;

$faker = new MuslimNameFaker();

// Generate any Muslim name
echo $faker->name();
// Output: "Hassan Al-Rashid"

// Generate male or female names
echo $faker->male();
// Output: "Omar Khalil"

echo $faker->female();
// Output: "Fatima Hussain"

// Generate names by origin
echo $faker->arab();
// Output: "Ahmed Al-Mansour"

echo $faker->iranian();
// Output: "Reza Hosseini"

echo $faker->pakistani();
// Output: "Ali Khan"

echo $faker->indonesian();
// Output: "Abdullah Hidayat"

echo $faker->malaysian();
// Output: "Hafiz Rahman"

echo $faker->bangladeshi();
// Output: "Kamal Hossain"

echo $faker->african();
// Output: "Ibrahim Diallo"

// Combine gender and origin
echo $faker->male('arab');
// Output: "Khalid Said"

echo $faker->female('iranian');
// Output: "Leila Rezaei"

// Generate first names only
echo $faker->firstName();
// Output: "Yusuf"

echo $faker->maleFirstName('pakistani');
// Output: "Imran"

echo $faker->femaleFirstName('arab');
// Output: "Aisha"

// Generate last names only
echo $faker->lastName();
// Output: "Ahmed"

echo $faker->lastName('iranian');
// Output: "Karimi"
```

### Specific Origin and Gender Methods

[](#specific-origin-and-gender-methods)

```
// Arab names
echo $faker->arabMale();
// Output: "Tariq Nasr"

echo $faker->arabFemale();
// Output: "Maryam Farah"

// Iranian names
echo $faker->iranianMale();
// Output: "Mehdi Ahmadi"

echo $faker->iranianFemale();
// Output: "Zahra Mousavi"

// Pakistani names
echo $faker->pakistaniMale();
// Output: "Bilal Sheikh"

echo $faker->pakistaniFemale();
// Output: "Ayesha Malik"

// Indonesian names
echo $faker->indonesianMale();
// Output: "Rahman Santoso"

echo $faker->indonesianFemale();
// Output: "Fatima Putri"

// Malaysian names
echo $faker->malaysianMale();
// Output: "Hafiz Abdullah"

echo $faker->malaysianFemale();
// Output: "Nur Aisyah"

// Bangladeshi names
echo $faker->bangladeshiMale();
// Output: "Rashid Hossain"

echo $faker->bangladeshiFemale();
// Output: "Ayesha Khadiza"

// African names
echo $faker->africanMale();
// Output: "Mamadou Diallo"

echo $faker->africanFemale();
// Output: "Aminata Fatou"
```

### Laravel Usage

[](#laravel-usage)

#### Using the Facade

[](#using-the-facade)

```
use MuslimNameFaker;

// Generate names
$name = MuslimNameFaker::name();
$male = MuslimNameFaker::male();
$female = MuslimNameFaker::female('arab');
$firstName = MuslimNameFaker::firstName('male', 'iranian');
```

#### Using Dependency Injection

[](#using-dependency-injection)

```
use MuslimNameFaker\MuslimNameFaker;

class UserController extends Controller
{
    public function store(MuslimNameFaker $faker)
    {
        $name = $faker->name();
        // ...
    }
}
```

#### In Laravel Factories

[](#in-laravel-factories)

```
namespace Database\Factories;

use App\Models\User;
use Illuminate\Database\Eloquent\Factories\Factory;
use MuslimNameFaker;

class UserFactory extends Factory
{
    protected $model = User::class;

    public function definition()
    {
        return [
            'name' => MuslimNameFaker::name(),
            'email' => $this->faker->unique()->safeEmail(),
            'password' => bcrypt('password'),
        ];
    }
}
```

#### In Seeders

[](#in-seeders)

```
use Illuminate\Database\Seeder;
use App\Models\User;
use MuslimNameFaker;

class UserSeeder extends Seeder
{
    public function run()
    {
        for ($i = 0; $i < 50; $i++) {
            User::create([
                'name' => MuslimNameFaker::name(),
                'email' => "user{$i}@example.com",
                'password' => bcrypt('password'),
            ]);
        }
    }
}
```

### Helper Functions

[](#helper-functions)

The package provides convenient global helper functions:

```
// General name generation
muslim_name();                           // Random Muslim name
muslim_name('male', 'arab');            // Arab male name
muslim_name('female', 'iranian');       // Iranian female name

// Gender-specific helpers
muslim_name_male();                      // Random male name
muslim_name_male('pakistani');          // Pakistani male name
muslim_name_female();                    // Random female name
muslim_name_female('arab');             // Arab female name

// Origin-specific helpers
muslim_name_arab();                      // Random Arab name
muslim_name_arab('male');               // Arab male name
muslim_name_iranian();                   // Random Iranian name
muslim_name_iranian('female');          // Iranian female name
muslim_name_pakistani();                 // Random Pakistani name
muslim_name_pakistani('male');          // Pakistani male name
muslim_name_indonesian();                // Random Indonesian name
muslim_name_indonesian('female');       // Indonesian female name
muslim_name_malaysian();                 // Random Malaysian name
muslim_name_malaysian('male');          // Malaysian male name
muslim_name_bangladeshi();               // Random Bangladeshi name
muslim_name_bangladeshi('female');      // Bangladeshi female name
muslim_name_african();                   // Random African name
muslim_name_african('male');            // African male name

// First and last names
muslim_first_name();                     // Random first name
muslim_first_name('female', 'iranian'); // Iranian female first name
muslim_last_name();                      // Random last name
muslim_last_name('pakistani');          // Pakistani last name
```

Available Methods
-----------------

[](#available-methods)

### Main Methods

[](#main-methods)

MethodParametersDescription`name()``?string $gender, ?string $origin`Generate any Muslim name`fullName()``?string $gender, ?string $origin`Generate full name (first + last)`firstName()``?string $gender, ?string $origin`Generate first name only`lastName()``?string $origin`Generate last name only### Gender-Specific Methods

[](#gender-specific-methods)

MethodParametersDescription`male()``?string $origin`Generate male full name`female()``?string $origin`Generate female full name`maleFirstName()``?string $origin`Generate male first name`femaleFirstName()``?string $origin`Generate female first name### Origin-Specific Methods

[](#origin-specific-methods)

MethodParametersDescription`arab()``?string $gender`Generate Arab name`iranian()``?string $gender`Generate Iranian name`pakistani()``?string $gender`Generate Pakistani name`indonesian()``?string $gender`Generate Indonesian name`malaysian()``?string $gender`Generate Malaysian name`bangladeshi()``?string $gender`Generate Bangladeshi name`african()``?string $gender`Generate African Muslim name`arabMale()`-Generate Arab male name`arabFemale()`-Generate Arab female name`iranianMale()`-Generate Iranian male name`iranianFemale()`-Generate Iranian female name`pakistaniMale()`-Generate Pakistani male name`pakistaniFemale()`-Generate Pakistani female name`indonesianMale()`-Generate Indonesian male name`indonesianFemale()`-Generate Indonesian female name`malaysianMale()`-Generate Malaysian male name`malaysianFemale()`-Generate Malaysian female name`bangladeshiMale()`-Generate Bangladeshi male name`bangladeshiFemale()`-Generate Bangladeshi female name`africanMale()`-Generate African Muslim male name`africanFemale()`-Generate African Muslim female nameName Database Statistics
------------------------

[](#name-database-statistics)

The package includes over 1300 authentic Muslim names:

### Arab Names

[](#arab-names)

- **Male First Names**: 110+
- **Female First Names**: 115+
- **Last Names**: 130+

### Iranian Names

[](#iranian-names)

- **Male First Names**: 125+
- **Female First Names**: 100+
- **Last Names**: 140+

### Pakistani Names

[](#pakistani-names)

- **Male First Names**: 150+
- **Female First Names**: 175+
- **Last Names**: 170+

### Indonesian Names

[](#indonesian-names)

- **Male First Names**: 65+
- **Female First Names**: 70+
- **Last Names**: 85+

### Malaysian Names

[](#malaysian-names)

- **Male First Names**: 75+
- **Female First Names**: 80+
- **Last Names**: 90+

### Bangladeshi Names

[](#bangladeshi-names)

- **Male First Names**: 95+
- **Female First Names**: 105+
- **Last Names**: 95+

### African Muslim Names

[](#african-muslim-names)

- **Male First Names**: 70+
- **Female First Names**: 85+
- **Last Names**: 75+

Testing
-------

[](#testing)

Run the test suite:

```
composer test
```

Or with PHPUnit directly:

```
vendor/bin/phpunit
```

Requirements
------------

[](#requirements)

- PHP 7.4 or higher
- PHP 8.0, 8.1, 8.2, 8.3 supported

Credits
-------

[](#credits)

- [Usman Ahmed Malik](https://github.com/usmanahmedmalik)
- Inspired by [Laravel Faker](https://github.com/fzaninotto/Faker)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

Contributing
------------

[](#contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

### Adding More Names

[](#adding-more-names)

To add more names to the database, edit the following files:

- `src/Data/MaleNames.php` - Male first names
- `src/Data/FemaleNames.php` - Female first names
- `src/Data/LastNames.php` - Last/family names

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Support
-------

[](#support)

If you discover any issues, please open an issue on GitHub.

---

Made with ❤️ for the Muslim developer community

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance81

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity50

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

Total

2

Last Release

101d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3dbcad40004a7023dca06a5d6aaebc8164bf64ff7a38e46e06907207d07ee803?d=identicon)[usmanmalik.me](/maintainers/usmanmalik.me)

---

Top Contributors

[![usmanahmedmalik](https://avatars.githubusercontent.com/u/22715704?v=4)](https://github.com/usmanahmedmalik "usmanahmedmalik (2 commits)")

---

Tags

phptestinglaravelfakerFake datamuslim-names

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/usmanahmedmalik-muslim-name-faker/health.svg)

```
[![Health](https://phpackages.com/badges/usmanahmedmalik-muslim-name-faker/health.svg)](https://phpackages.com/packages/usmanahmedmalik-muslim-name-faker)
```

###  Alternatives

[nunomaduro/laravel-mojito

A lightweight package for testing Laravel views.

368435.5k11](/packages/nunomaduro-laravel-mojito)[marvinrabe/laravel-graphql-test

Provides you with a simple GraphQL testing trait.

58329.7k](/packages/marvinrabe-laravel-graphql-test)

PHPackages © 2026

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