PHPackages                             geekish/faker-providers - 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 &amp; Helpers](/categories/utility)
4. /
5. geekish/faker-providers

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

geekish/faker-providers
=======================

Extra providers for Faker

0.2.0(1w ago)07↓50%MITPHPPHP ^8.2CI passing

Since May 20Pushed 1w agoCompare

[ Source](https://github.com/geekish/faker-providers)[ Packagist](https://packagist.org/packages/geekish/faker-providers)[ Docs](https://github.com/geekish/faker-providers)[ GitHub Sponsors](https://github.com/geekish)[ RSS](/packages/geekish-faker-providers/feed)WikiDiscussions main Synced 1w ago

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

geekish/faker-providers
=======================

[](#geekishfaker-providers)

[![Latest Version on Packagist](https://camo.githubusercontent.com/0c3bb6b7b4bce8c6b62531d29599e6b33552b92c594a06e36ee23a044b33be04/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6765656b6973682f66616b65722d70726f7669646572732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/geekish/faker-providers)[![Tests](https://camo.githubusercontent.com/ed2ad0ceffeab3e7cf81c01518b2f3d14d025065c8ef20e039c6b7495a773ad8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6765656b6973682f66616b65722d70726f7669646572732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/geekish/faker-providers/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/b8d9b031a082df59798c4d8260739ecafc1a150a569b1d7ec9115c2f65223743/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6765656b6973682f66616b65722d70726f7669646572732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/geekish/faker-providers)

Adds some extra providers to [fakerphp/faker](https://github.com/fakerphp/faker). Some are ported/adapted from [the original](https://github.com/faker-ruby/faker) and [mbezhanov/faker-provider-collection](https://github.com/mbezhanov/faker-provider-collection).

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

[](#installation)

You can install the package via composer:

```
composer require geekish/faker-providers
```

Usage
-----

[](#usage)

To register all providers:

```
use Faker\Generator;

$faker = new Faker\Generator();

FakerProviders::register($faker);
```

In Laravel, adding providers to the Faker instance accessible via `fake()` can be done like so:

```
use Faker\Generator;
use Geekish\FakerProviders\FakerProviders;
use Illuminate\Foundation\Application;

$locale = $this->app->get('config')->get('app.faker_locale', 'en_US');
$abstract = Generator::class.':'.$locale;

$this->app->resolving($abstract, function (Generator $faker, Application $app) {
    FakerProviders::register($faker);

    return $faker;
});
```

Of course, you are free to register the providers individually:

```
use Faker\Generator;
use Geekish\FakerProviders\Arts\Literature;

$faker = new Faker\Generator();

$faker->addProvider(new Literature($faker));

$faker->bookTitle();
```

### Providers

[](#providers)

- [Literature](https://github.com/geekish/faker-providers/tree/main/src/Arts/Literature.php)
    - `author`
    - `genre`
    - `bookTitle`
    - `bookSeries`
- [Horse](https://github.com/geekish/faker-providers/tree/main/src/Animals/Horse.php)
    - `horseBreed`
- [Music](https://github.com/geekish/faker-providers/tree/main/src/Arts/Music.php)
    - `musicalGenre`
    - `instrument`
    - `band`
    - `femaleMusician`
    - `maleMusician`
    - `musician` (generates any of the previous three)
- [StarWars](https://github.com/geekish/faker-providers/tree/main/src/Fandom/StarWars.php)
    - `starWarsCharacter`
    - `starWarsDroid`
    - `starWarsPlanet`
    - `starWarsSpecies`
    - `starWarsVehicle`
- [Space](https://github.com/geekish/faker-providers/tree/main/src/Science/Space.php)
    - `constellation`
    - `cluster`
    - `dwarfPlanet`
    - `galaxy`
    - `planet`
    - `moon`
    - `nebula`
    - `star`

Testing
-------

[](#testing)

Each provider should be covered.

```
composer test
```

Changelog
---------

[](#changelog)

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

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

[](#contributing)

Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Hannah Chartier](https://github.com/geekish)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance98

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

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

Total

2

Last Release

11d ago

PHP version history (2 changes)0.1.0PHP ^8.4

0.2.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/8f71f88eade469052b3394beb105edf22d815cd1449a90bb28ce94eccbd51740?d=identicon)[hannahwarmbier](/maintainers/hannahwarmbier)

---

Top Contributors

[![geekish](https://avatars.githubusercontent.com/u/684339?v=4)](https://github.com/geekish "geekish (9 commits)")

---

Tags

fakergeekishfaker-providers

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/geekish-faker-providers/health.svg)

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

###  Alternatives

[mbezhanov/faker-provider-collection

A collection of custom providers for the Faker library

2139.1M25](/packages/mbezhanov-faker-provider-collection)[verbb/formie

The most user-friendly forms plugin for Craft.

100387.6k57](/packages/verbb-formie)[pelmered/fake-car

Fake-Car is a Faker provider that generates fake car data for you.

1261.3M2](/packages/pelmered-fake-car)[solspace/craft-freeform

The most flexible and user-friendly form building plugin!

53675.5k15](/packages/solspace-craft-freeform)[directorytree/dummy

418.9k](/packages/directorytree-dummy)[smknstd/fakerphp-picsum-images

Alternative image provider for fakerphp using picsum.photos

45242.7k7](/packages/smknstd-fakerphp-picsum-images)

PHPackages © 2026

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