fakerphp / faker
Faker is a PHP library that generates fake data for you.
Installs: 2 911 840
Dependents: 220
Suggesters: 6
Security: 0
Stars: 1 076
Watchers: 25
Forks: 3 008
Open Issues: 11
Requires
- php: ^7.1 || ^8.0
Requires (Dev)
- ext-intl: *
- bamarni/composer-bin-plugin: ^1.4.1
- phpunit/phpunit: ^7.5.20 || ^8.5.8 || ^9.4.2
Conflicts
README
Faker
Faker is a PHP library that generates fake data for you. Whether you need to bootstrap your database, create good-looking XML documents, fill-in your persistence to stress test it, or anonymize data taken from a production service, Faker is for you.
It's heavily inspired by Perl's Data::Faker, and by Ruby's Faker.
Getting Started
Installation
Faker requires PHP >= 7.1.
composer require fakerphp/faker
Documentation
Full documentation can be found over on fakerphp.github.io.
Basic Usage
Use Faker\Factory::create()
to create and initialize a Faker generator, which can generate data by accessing methods named after the type of data you want.
<?php require_once 'vendor/autoload.php'; // use the factory to create a Faker\Generator instance $faker = Faker\Factory::create(); // generate data by calling methods echo $faker->name(); // 'Vince Sporer' echo $faker->email(); // 'walter.sophia@hotmail.com' echo $faker->text(); // 'Numquam ut mollitia at consequuntur inventore dolorem.'
Each call to $faker->name()
yields a different (random) result. This is because Faker uses __call()
magic, and forwards Faker\Generator->$method()
calls to Faker\Generator->format($method, $attributes)
.
<?php for ($i = 0; $i < 3; $i++) { echo $faker->name() . "\n"; } // 'Cyrus Boyle' // 'Alena Cummerata' // 'Orlo Bergstrom'
License
Faker is released under the MIT License. See LICENSE
for details.