Download the PHP package cupidontech/multi-faker without Composer
On this page you can find all versions of the php package cupidontech/multi-faker. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cupidontech/multi-faker
More information about cupidontech/multi-faker
Files in cupidontech/multi-faker
Package multi-faker
Short Description Package for generating Faker by country
License MIT
Homepage https://github.com/Dilane05/multi-faker
Informations about the package multi-faker
multi-faker
The missing Faker locale for Africa.
Generate realistic fake data for African and international applications.
Table of Contents
- The Problem
- FakerPHP vs multi-faker
- Supported Countries
- Features
- Requirements
- Installation
- Configuration
- Usage
- Example Output
- Available Methods
- Roadmap
- Contributions
- License
The Problem
FakerPHP supports many locales but provides no realistic datasets for most African countries.
| Country | FakerPHP | multi-faker |
|---|---|---|
| Cameroon | ❌ | ✅ |
| Senegal | ❌ | ✅ |
| Ivory Coast | ❌ | ✅ |
| Nigeria | Limited | ✅ |
| South Africa | Limited | ✅ |
| France | ✅ | ✅ |
| USA | ✅ | ✅ |
As a result, developers often seed African applications with unrealistic names, cities, and phone numbers. multi-faker solves this with country-specific generators built from real local datasets.
FakerPHP vs multi-faker
| Feature | FakerPHP | multi-faker |
|---|---|---|
| Local names | ❌ (for Africa) | ✅ |
| Local phone formats | ❌ | ✅ |
| Local regions | ❌ | ✅ |
| Local cities | ❌ | ✅ |
| GPS coordinates | ❌ | ✅ |
| Switch country at runtime | ❌ | ✅ |
| Laravel integration | ✅ | ✅ |
Supported Countries
| Country | Key |
|---|---|
| 🇨🇲 Cameroon | Cameroon |
| 🇨🇮 Ivory Coast | IvoryCoast |
| 🇳🇬 Nigeria | Nigeria |
| 🇸🇳 Senegal | Senegal |
| 🇿🇦 South Africa | SouthAfrica |
| 🇨🇦 Canada | Canada |
| 🇺🇸 United States | UnitedStates |
| 🇫🇷 France | France |
| 🇩🇪 Germany | Germany |
Features
| Feature | Supported |
|---|---|
| First & last names | ✅ |
| Full names & usernames | ✅ |
| Email addresses | ✅ |
| Phone numbers (local format) | ✅ |
| Addresses | ✅ |
| Regions & cities | ✅ |
| GPS coordinates | ✅ |
| Company names | ✅ |
| Products & food items | ✅ |
| Dates | ✅ |
| Passwords & credit cards | ✅ |
| Random text | ✅ |
| Mobile money / payments | ✅ |
Requirements
- PHP 8.1+
- Laravel 9, 10, or 11 (optional — works standalone too)
Installation
Laravel auto-discovers the service provider. For older versions of Laravel, add it manually in config/app.php:
Configuration
Set the default country in your .env file:
Accepted values: Cameroon, IvoryCoast, Nigeria, Senegal, SouthAfrica, Canada, UnitedStates, France, Germany.
Usage
Standalone
Laravel (dependency injection)
Laravel Seeder
Switching country at runtime
Example Output
🇨🇲 Cameroon
🇸🇳 Senegal
🇳🇬 Nigeria
Available Methods
All generators implement the same interface, regardless of country.
The mobile money methods are contextual — they use the dominant payment platform per country:
| Country | Platform |
|---|---|
| 🇨🇲 Cameroon | Orange Money CM |
| 🇨🇮 Ivory Coast | Orange Money CI |
| 🇸🇳 Senegal | Orange Money SN |
| 🇳🇬 Nigeria | MTN MoMo |
| 🇿🇦 South Africa | MTN MoMo SA |
| 🇨🇦 Canada | Interac e-Transfer |
| 🇺🇸 United States | Venmo / CashApp |
| 🇫🇷 France | Orange Bank |
| 🇩🇪 Germany | PayPal / Klarna |
Roadmap
- [x] 🇨🇲 Cameroon
- [x] 🇨🇮 Ivory Coast
- [x] 🇳🇬 Nigeria
- [x] 🇸🇳 Senegal
- [x] 🇿🇦 South Africa
- [x] 🇫🇷 France
- [x] 🇨🇦 Canada
- [x] 🇺🇸 United States
- [x] 🇩🇪 Germany
- [ ] 🇨🇬 Congo
- [ ] 🇬🇦 Gabon
- [ ] 🇧🇯 Benin
- [ ] 🇹🇬 Togo
- [ ] 🇧🇫 Burkina Faso
- [ ] 🇲🇱 Mali
- [ ] 🇬🇭 Ghana
- [ ] 🇰🇪 Kenya
Contributions
We welcome contributions. Please follow the git flow below:
- Fork the repository and clone it locally.
- Create a feature branch from
dev:git checkout -b feature/my-feature dev - Write your code and tests, then commit.
- Push your branch and open a pull request targeting
dev. - Once reviewed and merged to
dev, a maintainer will cut a release tomain.
To add a new country, see the CLAUDE.md guide.
License
Distributed under the MIT license.
All versions of multi-faker with dependencies
fakerphp/faker Version ^1.23
illuminate/support Version ^9.0 || ^10.0 || ^11.0