Faker is a PHP library that generates fake data for you
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.
Faker is heavily inspired by Perl's Data::Faker, and by ruby's Faker.
Faker requires PHP >= 5.3.3.
Faker is archived. Read the reasons behind this decision here: https://marmelab.com/blog/2020/10/21/sunsetting-faker.html
composer require fzaninotto/faker
Faker supports both
PSR-0as
PSR-4autoloaders. ```php <?php
require_once 'vendor/autoload.php'; ```
You can also load
Fakersshipped
PSR-0autoloader ```php <?php
require_once '/path/to/Faker/src/autoload.php'; ```
alternatively, you can use any another PSR-4 compliant autoloader
Use
Faker\Factory::create()to create and initialize a faker generator, which can generate data by accessing properties named after the type of data you want.
// generate data by accessing properties echo $faker->name; // 'Lucy Cechtelar'; echo $faker->address; // "426 Jordy Lodge // Cartwrightshire, SC 88120-6700" echo $faker->text; // Dolores sit sint laboriosam dolorem culpa et autem. Beatae nam sunt fugit // et sit et mollitia sed. // Fuga deserunt tempora facere magni omnis. Omnis quia temporibus laudantium // sit minima sint.
Even if this example shows a property access, each call to
$faker->nameyields a different (random) result. This is because Faker uses
__get()magic, and forwards
Faker\Generator->$propertycalls to
Faker\Generator->format($property).
name, "\n"; } // Adaline Reichel // Dr. Santa Prosacco DVM // Noemy Vandervort V // Lexi O'Conner // Gracie Weber // Roscoe Johns // Emmett Lebsack // Keegan Thiel // Wellington Koelpin II // Ms. Karley Kiehn V
Tip: For a quick generation of fake data, you can also use Faker as a command line tool thanks to faker-cli.
Each of the generator properties (like
name,
address, and
lorem) are called "formatters". A faker generator has many of them, packaged in "providers". Here is a list of the bundled formatters in the default locale.
Faker\Provider\Base
randomDigit // 7 randomDigitNot(5) // 0, 1, 2, 3, 4, 6, 7, 8, or 9 randomDigitNotNull // 5 randomNumber($nbDigits = NULL, $strict = false) // 79907610 randomFloat($nbMaxDecimals = NULL, $min = 0, $max = NULL) // 48.8932 numberBetween($min = 1000, $max = 9000) // 8567 randomLetter // 'b' // returns randomly ordered subsequence of a provided array randomElements($array = array ('a','b','c'), $count = 1) // array('c') randomElement($array = array ('a','b','c')) // 'b' shuffle('hello, world') // 'rlo,h eoldlw' shuffle(array(1, 2, 3)) // array(2, 1, 3) numerify('Hello ###') // 'Hello 609' lexify('Hello ???') // 'Hello wgt' bothify('Hello ##??') // 'Hello 42jz' asciify('Hello ***') // 'Hello R6+' regexify('[A-Z0-9._%+-][email protected][A-Z0-9.-]+\.[A-Z]{2,4}'); // [email protected]
Faker\Provider\Lorem
word // 'aut' words($nb = 3, $asText = false) // array('porro', 'sed', 'magni') sentence($nbWords = 6, $variableNbWords = true) // 'Sit vitae voluptas sint non voluptates.' sentences($nb = 3, $asText = false) // array('Optio quos qui illo error.', 'Laborum vero a officia id corporis.', 'Saepe provident esse hic eligendi.') paragraph($nbSentences = 3, $variableNbSentences = true) // 'Ut ab voluptas sed a nam. Sint autem inventore aut officia aut aut blanditiis. Ducimus eos odit amet et est ut eum.' paragraphs($nb = 3, $asText = false) // array('Quidem ut sunt et quidem est accusamus aut. Fuga est placeat rerum ut. Enim ex eveniet facere sunt.', 'Aut nam et eum architecto fugit repellendus illo. Qui ex esse veritatis.', 'Possimus omnis aut incidunt sunt. Asperiores incidunt iure sequi cum culpa rem. Rerum exercitationem est rem.') text($maxNbChars = 200) // 'Fuga totam reiciendis qui architecto fugiat nemo. Consequatur recusandae qui cupiditate eos quod.'
Faker\Provider\en_US\Person
title($gender = null|'male'|'female') // 'Ms.' titleMale // 'Mr.' titleFemale // 'Ms.' suffix // 'Jr.' name($gender = null|'male'|'female') // 'Dr. Zane Stroman' firstName($gender = null|'male'|'female') // 'Maynard' firstNameMale // 'Maynard' firstNameFemale // 'Rachel' lastName // 'Zulauf'
Faker\Provider\en_US\Address
cityPrefix // 'Lake' secondaryAddress // 'Suite 961' state // 'NewMexico' stateAbbr // 'OH' citySuffix // 'borough' streetSuffix // 'Keys' buildingNumber // '484' city // 'West Judge' streetName // 'Keegan Trail' streetAddress // '439 Karley Loaf Suite 897' postcode // '17916' address // '8888 Cummings Vista Apt. 101, Susanbury, NY 95473' country // 'Falkland Islands (Malvinas)' latitude($min = -90, $max = 90) // 77.147489 longitude($min = -180, $max = 180) // 86.211205
Faker\Provider\en_US\PhoneNumber
phoneNumber // '201-886-0269 x3767' tollFreePhoneNumber // '(888) 937-7238' e164PhoneNumber // '+27113456789'
Faker\Provider\en_US\Company
catchPhrase // 'Monitored regional contingency' bs // 'e-enable robust architectures' company // 'Bogan-Treutel' companySuffix // 'and Sons' jobTitle // 'Cashier'
Faker\Provider\en_US\Text
realText($maxNbChars = 200, $indexSize = 2) // "And yet I wish you could manage it?) 'And what are they made of?' Alice asked in a shrill, passionate voice. 'Would YOU like cats if you were never even spoke to Time!' 'Perhaps not,' Alice replied."
Faker\Provider\DateTime
unixTime($max = 'now') // 58781813 dateTime($max = 'now', $timezone = null) // DateTime('2008-04-25 08:37:17', 'UTC') dateTimeAD($max = 'now', $timezone = null) // DateTime('1800-04-29 20:38:49', 'Europe/Paris') iso8601($max = 'now') // '1978-12-09T10:10:29+0000' date($format = 'Y-m-d', $max = 'now') // '1979-06-09' time($format = 'H:i:s', $max = 'now') // '20:49:42' dateTimeBetween($startDate = '-30 years', $endDate = 'now', $timezone = null) // DateTime('2003-03-15 02:00:49', 'Africa/Lagos') dateTimeInInterval($startDate = '-30 years', $interval = '+ 5 days', $timezone = null) // DateTime('2003-03-15 02:00:49', 'Antartica/Vostok') dateTimeThisCentury($max = 'now', $timezone = null) // DateTime('1915-05-30 19:28:21', 'UTC') dateTimeThisDecade($max = 'now', $timezone = null) // DateTime('2007-05-29 22:30:48', 'Europe/Paris') dateTimeThisYear($max = 'now', $timezone = null) // DateTime('2011-02-27 20:52:14', 'Africa/Lagos') dateTimeThisMonth($max = 'now', $timezone = null) // DateTime('2011-10-23 13:46:23', 'Antarctica/Vostok') amPm($max = 'now') // 'pm' dayOfMonth($max = 'now') // '04' dayOfWeek($max = 'now') // 'Friday' month($max = 'now') // '06' monthName($max = 'now') // 'January' year($max = 'now') // '1993' century // 'VI' timezone // 'Europe/Paris'
Methods accepting a
$timezoneargument default to
date_default_timezone_get(). You can pass a custom timezone string to each method, or define a custom timezone for all time methods at once using
$faker::setDefaultTimezone($timezone).
Faker\Provider\Internet
email // '[email protected]' safeEmail // '[email protected]' freeEmail // '[email protected]' companyEmail // '[email protected]' freeEmailDomain // 'yahoo.com' safeEmailDomain // 'example.org' userName // 'wade55' password // 'k&|X+a45*2[' domainName // 'wolffdeckow.net' domainWord // 'feeney' tld // 'biz' url // 'http://www.skilesdonnelly.biz/aut-accusantium-ut-architecto-sit-et.html' slug // 'aut-repellat-commodi-vel-itaque-nihil-id-saepe-nostrum' ipv4 // '109.133.32.252' localIpv4 // '10.242.58.8' ipv6 // '8e65:933d:22ee:a232:f1c1:2741:1f10:117c' macAddress // '43:85:B7:08:10:CA'
Faker\Provider\UserAgent
userAgent // 'Mozilla/5.0 (Windows CE) AppleWebKit/5350 (KHTML, like Gecko) Chrome/13.0.888.0 Safari/5350' chrome // 'Mozilla/5.0 (Macintosh; PPC Mac OS X 10_6_5) AppleWebKit/5312 (KHTML, like Gecko) Chrome/14.0.894.0 Safari/5312' firefox // 'Mozilla/5.0 (X11; Linuxi686; rv:7.0) Gecko/20101231 Firefox/3.6' safari // 'Mozilla/5.0 (Macintosh; U; PPC Mac OS X 10_7_1 rv:3.0; en-US) AppleWebKit/534.11.3 (KHTML, like Gecko) Version/4.0 Safari/534.11.3' opera // 'Opera/8.25 (Windows NT 5.1; en-US) Presto/2.9.188 Version/10.00' internetExplorer // 'Mozilla/5.0 (compatible; MSIE 7.0; Windows 98; Win 9x 4.90; Trident/3.0)'
Faker\Provider\Payment
creditCardType // 'MasterCard' creditCardNumber // '4485480221084675' creditCardExpirationDate // 04/13 creditCardExpirationDateString // '04/13' creditCardDetails // array('MasterCard', '4485480221084675', 'Aleksander Nowak', '04/13') // Generates a random IBAN. Set $countryCode to null for a random country iban($countryCode) // 'IT31A8497112740YZ575DJ28BP4' swiftBicNumber // 'RZTIAT22263'
Faker\Provider\Color
hexcolor // '#fa3cc2' rgbcolor // '0,255,122' rgbColorAsArray // array(0,255,122) rgbCssColor // 'rgb(0,255,122)' safeColorName // 'fuchsia' colorName // 'Gainsbor' hslColor // '340,50,20' hslColorAsArray // array(340,50,20)
Faker\Provider\File
fileExtension // 'avi' mimeType // 'video/x-msvideo' // Copy a random file from the source to the target directory and returns the fullpath or filename file($sourceDir = '/tmp', $targetDir = '/tmp') // '/path/to/targetDir/13b73edae8443990be1aa8f1a483bc27.jpg' file($sourceDir, $targetDir, false) // '13b73edae8443990be1aa8f1a483bc27.jpg'
Faker\Provider\Image
// Image generation provided by LoremPixel (http://lorempixel.com/) imageUrl($width = 640, $height = 480) // 'http://lorempixel.com/640/480/' imageUrl($width, $height, 'cats') // 'http://lorempixel.com/800/600/cats/' imageUrl($width, $height, 'cats', true, 'Faker') // 'http://lorempixel.com/800/400/cats/Faker' imageUrl($width, $height, 'cats', true, 'Faker', true) // 'http://lorempixel.com/gray/800/400/cats/Faker/' Monochrome image image($dir = '/tmp', $width = 640, $height = 480) // '/tmp/13b73edae8443990be1aa8f1a483bc27.jpg' image($dir, $width, $height, 'cats') // 'tmp/13b73edae8443990be1aa8f1a483bc27.jpg' it's a cat! image($dir, $width, $height, 'cats', false) // '13b73edae8443990be1aa8f1a483bc27.jpg' it's a filename without path image($dir, $width, $height, 'cats', true, false) // it's a no randomize images (default: `true`) image($dir, $width, $height, 'cats', true, true, 'Faker') // 'tmp/13b73edae8443990be1aa8f1a483bc27.jpg' it's a cat with 'Faker' text. Default, `null`.
Faker\Provider\Uuid
uuid // '7e57d004-2b97-0e7a-b45f-5387367791cd'
Faker\Provider\Barcode
ean13 // '4006381333931' ean8 // '73513537' isbn13 // '9790404436093' isbn10 // '4881416324'
Faker\Provider\Miscellaneous
boolean // false boolean($chanceOfGettingTrue = 50) // true md5 // 'de99a620c50f2990e87144735cd357e7' sha1 // 'f08e7f04ca1a413807ebc47551a40a20a0b4de5c' sha256 // '0061e4c60dac5c1d82db0135a42e00c89ae3a333e7c26485321f24348c7e98a5' locale // en_UK countryCode // UK languageCode // en currencyCode // EUR emoji // 😁
Faker\Provider\Biased
// get a random number between 10 and 20, // with more chances to be close to 20 biasedNumberBetween($min = 10, $max = 20, $function = 'sqrt')
Faker\Provider\HtmlLorem
//Generate HTML document which is no more than 2 levels deep, and no more than 3 elements wide at any level. randomHtml(2,3) // Aut illo dolorem et accusantium eum.Id aut saepe non mollitia voluptas voluptas.Non consequatur.Incidunt est.Aut voluptatem.Officia voluptas rerum quo.Asperiores similique.
Sapiente dolorum dolorem sint laboriosam commodi qui. | Commodi nihil nesciunt eveniet quo repudiandae. | Voluptates explicabo numquam distinctio necessitatibus repellat. | Provident ut doloremque nam eum modi aspernatur. | Iusto inventore. |
Animi nihil ratione id mollitia libero ipsa quia tempore. | Velit est officia et aut tenetur dolorem sed mollitia expedita. | Modi modi repudiandae pariatur voluptas rerum ea incidunt non molestiae eligendi eos deleniti. | Exercitationem voluptatibus dolor est iste quod molestiae. | Quia reiciendis. |
Inventore impedit exercitationem voluptatibus rerum cupiditate. | Qui. | Aliquam. | Autem nihil aut et. | Dolor ut quia error. |
Enim facilis iusto earum et minus rerum assumenda quis quia. | Reprehenderit ut sapiente occaecati voluptatum dolor voluptatem vitae qui velit. | Quod fugiat non. | Sunt nobis totam mollitia sed nesciunt est deleniti cumque. | Repudiandae quo. |
Modi dicta libero quisquam doloremque qui autem. | Voluptatem aliquid saepe laudantium facere eos sunt dolor. | Est eos quis laboriosam officia expedita repellendus quia natus. | Et neque delectus quod fugit enim repudiandae qui. | Fugit soluta sit facilis facere repellat culpa magni voluptatem maiores tempora. |
Enim dolores doloremque. | Assumenda voluptatem eum perferendis exercitationem. | Quasi in fugit deserunt ea perferendis sunt nemo consequatur dolorum soluta. | Maxime repellat qui numquam voluptatem est modi. | Alias rerum rerum hic hic eveniet. |
Tempore voluptatem. | Eaque. | Et sit quas fugit iusto. | Nemo nihil rerum dignissimos et esse. | Repudiandae ipsum numquam. |
Nemo sunt quia. | Sint tempore est neque ducimus harum sed. | Dicta placeat atque libero nihil. | Et qui aperiam temporibus facilis eum. | Ut dolores qui enim et maiores nesciunt. |
Dolorum totam sint debitis saepe laborum. | Quidem corrupti ea. | Cum voluptas quod. | Possimus consequatur quasi dolorem ut et. | Et velit non hic labore repudiandae quis. |
Faker provides three special providers,
unique(),
optional(), and
valid(), to be called before any provider.
// unique() forces providers to return unique values $values = array(); for ($i = 0; $i < 10; $i++) { // get a random digit, but always a new one, to avoid duplicates $values []= $faker->unique()->randomDigit; } print_r($values); // [4, 1, 8, 5, 0, 2, 6, 9, 7, 3]// providers with a limited range will throw an exception when no new unique value can be generated $values = array(); try { for ($i = 0; $i < 10; $i++) { $values []= $faker->unique()->randomDigitNotNull; } } catch (\OverflowException $e) { echo "There are only 9 unique digits not null, Faker can't generate 10 of them!"; }
// you can reset the unique modifier for all providers by passing true as first argument $faker->unique($reset = true)->randomDigitNotNull; // will not throw OverflowException since unique() was reset // tip: unique() keeps one array of values per provider
// optional() sometimes bypasses the provider to return a default value instead (which defaults to NULL) $values = array(); for ($i = 0; $i < 10; $i++) { // get a random digit, but also null sometimes $values []= $faker->optional()->randomDigit; } print_r($values); // [1, 4, null, 9, 5, null, null, 4, 6, null]
// optional() accepts a weight argument to specify the probability of receiving the default value. // 0 will always return the default value; 1 will always return the provider. Default weight is 0.5 (50% chance). $faker->optional($weight = 0.1)->randomDigit; // 90% chance of NULL $faker->optional($weight = 0.9)->randomDigit; // 10% chance of NULL
// optional() accepts a default argument to specify the default value to return. // Defaults to NULL. $faker->optional($weight = 0.5, $default = false)->randomDigit; // 50% chance of FALSE $faker->optional($weight = 0.9, $default = 'abc')->word; // 10% chance of 'abc'
// valid() only accepts valid values according to the passed validator functions $values = array(); $evenValidator = function($digit) { return $digit % 2 === 0; }; for ($i = 0; $i < 10; $i++) { $values []= $faker->valid($evenValidator)->randomDigit; } print_r($values); // [0, 4, 8, 4, 2, 6, 0, 8, 8, 6]
// just like unique(), valid() throws an overflow exception when it can't generate a valid value $values = array(); try { $faker->valid($evenValidator)->randomElement([1, 3, 5, 7, 9]); } catch (\OverflowException $e) { echo "Can't pick an even number in that set!"; }
If you would like to use a modifier with a value not generated by Faker, use the
passthrough()method.
passthrough()simply returns whatever value it was given.
$faker->optional()->passthrough(mt_rand(5, 15));
Faker\Factorycan take a locale as an argument, to return localized data. If no localized provider is found, the factory fallbacks to the default locale (en_US).
name, "\n"; } // Luce du Coulon // Auguste Dupont // Roger Le Voisin // Alexandre Lacroix // Jacques Humbert-Roy // Thérèse Guillet-Andre // Gilles Gros-Bodin // Amélie Pires // Marcel Laporte // Geneviève Marchal
You can check available Faker locales in the source code, under the
Providerdirectory. The localization of Faker is an ongoing process, for which we need your help. Don't hesitate to create localized providers to your own locale and submit a PR!
Faker provides adapters for Object-Relational and Object-Document Mappers (currently, Propel, Doctrine2, CakePHP, Spot2, Mandango and Eloquent are supported). These adapters ease the population of databases through the Entity classes provided by an ORM library (or the population of document stores using Document classes provided by an ODM library).
To populate entities, create a new populator class (using a generator instance as parameter), then list the class and number of all the entities that must be generated. To launch the actual data population, call the
execute()method.
Note that some of the
populatorscould require additional parameters. As example the
doctrinepopulator has an option to specify its batchSize on how often it will flush the UnitOfWork to the database.
Here is an example showing how to populate 5
Authorand 10
Bookobjects:
addEntity('Author', 5); $populator->addEntity('Book', 10); $insertedPKs = $populator->execute();
The populator uses name and column type guessers to populate each column with relevant data. For instance, Faker populates a column named
first_nameusing the
firstNameformatter, and a column with a
TIMESTAMPtype using the
dateTimeformatter. The resulting entities are therefore coherent. If Faker misinterprets a column name, you can still specify a custom closure to be used for populating a particular column, using the third argument to
addEntity():
addEntity('Book', 5, array( 'ISBN' => function() use ($generator) { return $generator->ean13(); } ));
In this example, Faker will guess a formatter for all columns except
ISBN, for which the given anonymous function will be used.
Tip: To ignore some columns, specify
nullfor the column names in the third argument of
addEntity(). This is usually necessary for columns added by a behavior:
addEntity('Book', 5, array( 'CreatedAt' => null, 'UpdatedAt' => null, ));
Of course, Faker does not populate autoincremented primary keys. In addition,
Faker\ORM\Propel\Populator::execute()returns the list of inserted PKs, indexed by class:
(34, 35, 36, 37, 38), // 'Book' => (456, 457, 458, 459, 470, 471, 472, 473, 474, 475) // )
Note: Due to the fact that
Fakerreturns all the primary keys inserted, the memory consumption will go up drastically when you do batch inserts due to the big list of data.
In the previous example, the
Bookand
Authormodels share a relationship. Since
Authorentities are populated first, Faker is smart enough to relate the populated
Bookentities to one of the populated
Authorentities.
Lastly, if you want to execute an arbitrary function on an entity before insertion, use the fourth argument of the
addEntity()method:
addEntity('Book', 5, array(), array( function($book) { $book->publish(); }, ));
You may want to get always the same generated data - for instance when using Faker for unit testing purposes. The generator offers a
seed()method, which seeds the random number generator. Calling the same script twice with the same seed produces the same results.
seed(1234);echo $faker->name; // 'Jess Mraz I';
Tip: DateTime formatters won't reproduce the same fake data if you don't fix the
$maxvalue:dateTime(); // equivalent to $faker->dateTime($max = 'now') // make sure you fix the $max parameter $faker->dateTime('2014-02-25 08:37:17'); // will return always the same date when seededTip: Formatters won't reproduce the same fake data if you use the
rand()php function. Use$fakerormt_rand()instead:realText(rand(10,20)); // good $faker->realText($faker->numberBetween(10,20));
A
Faker\Generatoralone can't do much generation. It needs
Faker\Providerobjects to delegate the data generation to them.
Faker\Factory::create()actually creates a
Faker\Generatorbundled with the default providers. Here is what happens under the hood:
addProvider(new Faker\Provider\en_US\Person($faker)); $faker->addProvider(new Faker\Provider\en_US\Address($faker)); $faker->addProvider(new Faker\Provider\en_US\PhoneNumber($faker)); $faker->addProvider(new Faker\Provider\en_US\Company($faker)); $faker->addProvider(new Faker\Provider\Lorem($faker)); $faker->addProvider(new Faker\Provider\Internet($faker));
Whenever you try to access a property on the
$fakerobject, the generator looks for a method with the same name in all the providers attached to it. For instance, calling
$faker->nametriggers a call to
Faker\Provider\Person::name(). And since Faker starts with the last provider, you can easily override existing formatters: just add a provider containing methods named after the formatters you want to override.
That means that you can easily add your own providers to a
Faker\Generatorinstance. A provider is usually a class extending
\Faker\Provider\Base. This parent class allows you to use methods like
lexify()or
randomNumber(); it also gives you access to formatters of other providers, through the protected
$generatorproperty. The new formatters are the public methods of the provider class.
Here is an example provider for populating Book data:
class Book extends \Faker\Provider\Base { public function title($nbWords = 5) { $sentence = $this->generator->sentence($nbWords); return substr($sentence, 0, strlen($sentence) - 1); }public function ISBN() { return $this->generator->ean13(); } }
To register this provider, just add a new instance of
\Faker\Provider\Bookto an existing generator:
addProvider(new \Faker\Provider\Book($faker));
Now you can use the two new formatters like any other Faker formatter:
setTitle($faker->title); $book->setISBN($faker->ISBN); $book->setSummary($faker->text); $book->setPrice($faker->randomNumber(2));
Tip: A provider can also be a Plain Old PHP Object. In that case, all the public methods of the provider become available to the generator.
The following script generates a valid XML document:
boolean(25)): ?> streetAddress ?> city ?> postcode ?> state ?> boolean(33)): ?> bs ?> boolean(33)): ?> boolean(15)): ?>text(400) ?> ]]>
Running this script produces a document looking like:
182 Harrison Cove North Lloyd 45577 Alabama orchestrate compelling web-readiness90111 Hegmann Inlet South Geovanymouth 69961-9311 Colorado 9791 Nona Corner Harberhaven 74062-8191 RhodeIsland 11161 Schultz Via Feilstad 98019 NewJersey</details>
6106 Nader Village Suite 753 McLaughlinstad 43189-8621 Missouri expedite viral synergies 7546 Kuvalis Plaza South Wilfrid 77069 Georgia 478 Daisha Landing Apt. 510 West Lizethhaven 30566-5362 WestVirginia orchestrate dynamic networks</details>
1251 Koelpin Mission North Revastad 81620 Maryland 6396 Langworth Hills Apt. 446 New Carlos 89399-0268 Wyoming 2246 Kreiger Station Apt. 291 Kaydenmouth 11397-1072 Wyoming grow sticky portals</details>
</details>
Faker\Provider\ar_SA\Person
idNumber; // ID number echo $faker->nationalIdNumber // Citizen ID number echo $faker->foreignerIdNumber // Foreigner ID number echo $faker->companyIdNumber // Company ID number
Faker\Provider\ar_SA\Payment
bankAccountNumber // "SA0218IBYZVZJSEC8536V4XC"
Faker\Provider\at_AT\Payment
vat; // "AT U12345678" - Austrian Value Added Tax number echo $faker->vat(false); // "ATU12345678" - unspaced Austrian Value Added Tax number
Faker\Provider\bg_BG\Payment
vat; // "BG 0123456789" - Bulgarian Value Added Tax number echo $faker->vat(false); // "BG0123456789" - unspaced Bulgarian Value Added Tax number
Faker\Provider\cs_CZ\Address
region; // "Liberecký kraj"
Faker\Provider\cs_CZ\Company
ico; // "69663963"
Faker\Provider\cs_CZ\DateTime
monthNameGenitive; // "prosince" echo $faker->formattedDate; // "12. listopadu 2015"
Faker\Provider\cs_CZ\Person
birthNumber; // "7304243452"
Faker\Provider\da_DK\Person
cpr; // "051280-2387"
Faker\Provider\da_DK\Address
kommune; // "Frederiksberg"// Generates a random region name echo $faker->region; // "Region Sjælland"
Faker\Provider\da_DK\Company
cvr; // "32458723"// Generates a random P number echo $faker->p; // "5398237590"
Faker\Provider\de_CH\Person
avs13; // "756.1234.5678.97" OR echo $faker->ahv13; // "756.1234.5678.97"
Faker\Provider\de_DE\Payment
bankAccountNumber; // "DE41849025553661169313" echo $faker->bank; // "Volksbank Stuttgart"
Faker\Provider\en_HK\Address
town; // "Yuen Long"// Generates a fake village name based on the words commonly found in Hong Kong echo $faker->village; // "O Tau"
// Generates a fake estate name based on the words commonly found in Hong Kong echo $faker->estate; // "Ching Lai Court"
Faker\Provider\en_HK\Phone
mobileNumber; // "92150087"// Generates a Hong Kong landline number (starting with 2 or 3) echo $faker->landlineNumber; // "32750132"
// Generates a Hong Kong fax number (starting with 7) echo $faker->faxNumber; // "71937729"
Faker\Provider\en_NG\Address
region; // 'Katsina'
Faker\Provider\en_NG\Person
name; // 'Oluwunmi Mayowa'
Faker\Provider\en_NZ\Phone
mobileNumber; // "021 123 4567"// Generates a toll free number echo $faker->tollFreeNumber; // "0800 123 456"
// Area Code echo $faker->areaCode; // "03"
Faker\Provider\en_US\Company
ein; // '12-3456789'
Faker\Provider\en_US\Payment
bankAccountNumber; // '51915734310' echo $faker->bankRoutingNumber; // '212240302'
Faker\Provider\en_US\Person
ssn; // '123-45-6789'
Faker\Provider\en_ZA\Company
companyNumber; // 1999/789634/01
Faker\Provider\en_ZA\Person
idNumber; // 6606192211041// Generates a random valid licence code echo $faker->licenceCode; // EB
Faker\Provider\en_ZA\PhoneNumber
tollFreeNumber; // 0800 555 5555// Generates a mobile phone number echo $faker->mobileNumber; // 082 123 5555
Faker\Provider\es_ES\Person
dni; // '77446565E'// Generates a random valid licence code echo $faker->licenceCode; // B
Faker\Provider\es_ES\Payment
vat; // "A35864370"
Faker\Provider\es_ES\PhoneNumber
tollFreeNumber; // 900 123 456// Generates a mobile phone number echo $faker->mobileNumber; // +34 612 12 24
Faker\Provider\es_PE\Person
dni; // '83367512'
Faker\Provider\fa_IR\Person
nationalCode; // "0078475759"
Faker\Provider\fa_IR\Address
building; // "ساختمان آفتاب"// Returns a random city name echo $faker->city // "استان زنجان"
Faker\Provider\fa_IR\Company
contract; // "رسمی"
Faker\Provider\fi_FI\Payment
bankAccountNumber; // "FI8350799879879616"
Faker\Provider\fi_FI\Person
personalIdentityNumber() // '170974-007J'//Since the numbers are different for male and female persons, optionally you can specify gender. echo $faker->personalIdentityNumber(\DateTime::createFromFormat('Y-m-d', '2015-12-14'), 'female') // '141215A520B'
Faker\Provider\fr_BE\Payment
vat; // "BE 0123456789" - Belgian Value Added Tax number echo $faker->vat(false); // "BE0123456789" - unspaced Belgian Value Added Tax number
Faker\Provider\es_VE\Person
nationalId; // 'V11223344'
Faker\Provider\es_VE\Company
taxpayerIdentificationNumber; // 'J1234567891'
Faker\Provider\fr_CH\Person
avs13; // "756.1234.5678.97"
Faker\Provider\fr_FR\Address
departmentName; // "Haut-Rhin"// Generates a random department number echo $faker->departmentNumber; // "2B"
// Generates a random department info (department number => department name) $faker->department; // array('18' => 'Cher');
// Generates a random region echo $faker->region; // "Saint-Pierre-et-Miquelon"
// Generates a random appartement,stair echo $faker->secondaryAddress; // "Bat. 961"
Faker\Provider\fr_FR\Company
siren; // 082 250 104// Generates a random SIRET number echo $faker->siret; // 347 355 708 00224
Faker\Provider\fr_FR\Payment
vat; // FR 12 123 456 789
Faker\Provider\fr_FR\Person
nir; // 1 88 07 35 127 571 - 19
Faker\Provider\fr_FR\PhoneNumber
phoneNumber; // +33 (0)1 67 97 01 31 echo $faker->mobileNumber; // +33 6 21 12 72 84 echo $faker->serviceNumber // 08 98 04 84 46
Faker\Provider\he_IL\Payment
bankAccountNumber // "IL392237392219429527697"
Faker\Provider\hr_HR\Payment
bankAccountNumber // "HR3789114847226078672"
Faker\Provider\hu_HU\Payment
bankAccountNumber; // "HU09904437680048220079300783"
Faker\Provider\id_ID\Person
// first argument is gender, either Person::GENDER_MALE or Person::GENDER_FEMALE, if none specified random gender is used // second argument is birth date (DateTime object), if none specified, random birth date is used echo $faker->nik(); // "8522246001570940"
Faker\Provider\it_CH\Person
avs13; // "756.1234.5678.97"
Faker\Provider\it_IT\Company
vatId(); // "IT98746784967"
Faker\Provider\it_IT\Person
taxId(); // "DIXDPZ44E08F367A"
Faker\Provider\ja_JP\Person
kanaName($gender = null|'male'|'female') // "アオタ ミノル"// Generates a 'kana' first name echo $faker->firstKanaName($gender = null|'male'|'female') // "ヒデキ"
// Generates a 'kana' first name on the male echo $faker->firstKanaNameMale // "ヒデキ"
// Generates a 'kana' first name on the female echo $faker->firstKanaNameFemale // "マアヤ"
// Generates a 'kana' last name echo $faker->lastKanaName; // "ナカジマ"
Faker\Provider\ka_GE\Payment
bankAccountNumber; // "GE33ZV9773853617253389"
Faker\Provider\kk_KZ\Company
businessIdentificationNumber; // "150140000019"
Faker\Provider\kk_KZ\Payment
bank; // "Қазкоммерцбанк"// Generates a random bank account number echo $faker->bankAccountNumber; // "KZ1076321LO4H6X41I37"
Faker\Provider\kk_KZ\Person
individualIdentificationNumber; // "780322300455"// Generates an individual identification number based on his/her birth date echo $faker->individualIdentificationNumber(new \DateTime('1999-03-01')); // "990301300455"
Faker\Provider\ko_KR\Address
metropolitanCity; // "서울특별시"// Generates a borough echo $faker->borough; // "강남구"
Faker\Provider\ko_KR\PhoneNumber
localAreaPhoneNumber; // "02-1234-4567"// Generates a cell phone number echo $faker->cellPhoneNumber; // "010-9876-5432"
Faker\Provider\lt_LT\Payment
bankAccountNumber // "LT300848876740317118"
Faker\Provider\lv_LV\Person
personalIdentityNumber; // "140190-12301"
Faker\Provider\ms_MY\Address
township; // "Taman Bahagia"// Generates a random Malaysian town address with matching postcode and state echo $faker->townState; // "55100 Bukit Bintang, Kuala Lumpur"
Faker\Provider\ms_MY\Miscellaneous
jpjNumberPlate; // "WPL 5169"
Faker\Provider\ms_MY\Payment
bank; // "Maybank"// Generates a random Malaysian bank account number (10-16 digits) echo $faker->bankAccountNumber; // "1234567890123456"
// Generates a random Malaysian insurance company echo $faker->insurance; // "AIA Malaysia"
// Generates a random Malaysian bank SWIFT Code echo $faker->swiftCode; // "MBBEMYKLXXX"
Faker\Provider\ms_MY\Person
myKadNumber($gender = null|'male'|'female', $hyphen = null|true|false); // "710703471796"
Faker\Provider\ms_MY\PhoneNumber
mobileNumber($countryCodePrefix = null|true|false, $formatting = null|true|false); // "+6012-705 3767"// Generates a random Malaysian landline number echo $faker->fixedLineNumber($countryCodePrefix = null|true|false, $formatting = null|true|false); // "03-7112 0455"
// Generates a random Malaysian voip number echo $faker->voipNumber($countryCodePrefix = null|true|false, $formatting = null|true|false); // "015-458 7099"
Faker\Provider\ne_NP\Address
district;//Generates a Nepali city name echo $faker->cityName;
Faker\Provider\nl_BE\Payment
vat; // "BE 0123456789" - Belgian Value Added Tax number echo $faker->vat(false); // "BE0123456789" - unspaced Belgian Value Added Tax number
Faker\Provider\nl_BE\Person
rrn(); // "83051711784" - Belgian Rijksregisternummer echo $faker->rrn('female'); // "50032089858" - Belgian Rijksregisternummer for a female
Faker\Provider\nl_NL\Company
jobTitle; // "Houtbewerker" echo $faker->vat; // "NL123456789B01" - Dutch Value Added Tax number echo $faker->btw; // "NL123456789B01" - Dutch Value Added Tax number (alias)
Faker\Provider\nl_NL\Person
idNumber; // "111222333" - Dutch Personal identification number (BSN)
Faker\Provider\nb_NO\MobileNumber
mobileNumber; // "+4799988777" echo $faker->mobileNumber; // "999 88 777" echo $faker->mobileNumber; // "99988777"
Faker\Provider\nb_NO\Payment
bankAccountNumber; // "NO3246764709816"
Faker\Provider\pl_PL\Person
pesel; // "40061451555" // Generates a random personal identity card number echo $faker->personalIdentityNumber; // "AKX383360" // Generates a random taxpayer identification number (NIP) echo $faker->taxpayerIdentificationNumber; // '8211575109'
Faker\Provider\pl_PL\Company
regon; // "714676680" // Generates a random local REGON number echo $faker->regonLocal; // "15346111382836"
Faker\Provider\pl_PL\Payment
bank; // "Narodowy Bank Polski" // Generates a random bank account number echo $faker->bankAccountNumber; // "PL14968907563953822118075816"
Faker\Provider\pt_PT\Person
taxpayerIdentificationNumber; // '165249277'
Faker\Provider\pt_BR\Address
region; // 'Nordeste'// Generates a random region abbreviation echo $faker->regionAbbr; // 'NE'
Faker\Provider\pt_BR\PhoneNumber
areaCode; // 21 echo $faker->cellphone; // 9432-5656 echo $faker->landline; // 2654-3445 echo $faker->phone; // random landline, 8-digit or 9-digit cellphone number// Using the phone functions with a false argument returns unformatted numbers echo $faker->cellphone(false); // 74336667
// cellphone() has a special second argument to add the 9th digit. Ignored if generated a Radio number echo $faker->cellphone(true, true); // 98983-3945 or 7343-1290
// Using the "Number" suffix adds area code to the phone echo $faker->cellphoneNumber; // (11) 98309-2935 echo $faker->landlineNumber(false); // 3522835934 echo $faker->phoneNumber; // formatted, random landline or cellphone (obeying the 9th digit rule) echo $faker->phoneNumberCleared; // not formatted, random landline or cellphone (obeying the 9th digit rule)
Faker\Provider\pt_BR\Person
name; // 'Sr. Luis Adriano Sepúlveda Filho'// Valid document generators have a boolean argument to remove formatting echo $faker->cpf; // '145.343.345-76' echo $faker->cpf(false); // '45623467866' echo $faker->rg; // '84.405.736-3' echo $faker->rg(false); // '844057363'
Faker\Provider\pt_BR\Company
cnpj; // '23.663.478/0001-24' echo $faker->cnpj(false); // '23663478000124'
Faker\Provider\ro_MD\Payment
bankAccountNumber; // "MD83BQW1CKMUW34HBESDP3A8"
Faker\Provider\ro_RO\Payment
bankAccountNumber; // "RO55WRJE3OE8X3YQI7J26U1E"
Faker\Provider\ro_RO\Person
prefixMale; // "ing." // Generates a random female name prefix/title echo $faker->prefixFemale; // "d-na." // Generates a random male first name echo $faker->firstNameMale; // "Adrian" // Generates a random female first name echo $faker->firstNameFemale; // "Miruna"// Generates a random Personal Numerical Code (CNP) echo $faker->cnp; // "2800523081231" // Valid option values: // $gender: null (random), male, female // $dateOfBirth (1800+): null (random), Y-m-d, Y-m (random day), Y (random month and day) // i.e. '1981-06-16', '2015-03', '1900' // $county: 2 letter ISO 3166-2:RO county codes and B1, B2, B3, B4, B5, B6 for Bucharest's 6 sectors // $isResident true/false flag if the person resides in Romania echo $faker->cnp($gender = null, $dateOfBirth = null, $county = null, $isResident = true);
Faker\Provider\ro_RO\PhoneNumber
tollFreePhoneNumber; // "0800123456" // Generates a random premium-rate phone number echo $faker->premiumRatePhoneNumber; // "0900123456"
Faker\Provider\ru_RU\Payment
bank; // "ОТП Банк"//Generate a Russian Tax Payment Number for Company echo $faker->inn; // 7813540735
//Generate a Russian Tax Code for Company echo $faker->kpp; // 781301001
Faker\Provider\sv_SE\Payment
bankAccountNumber; // "SE5018548608468284909192"
Faker\Provider\sv_SE\Person
personalIdentityNumber() // '950910-0799'//Since the numbers are different for male and female persons, optionally you can specify gender. echo $faker->personalIdentityNumber('female') // '950910-0781'
Faker\Provider\tr_TR\Person
tcNo // '55300634882'
Faker\Provider\zh_CN\Payment
bank; // '中国建设银行'
Faker\Provider\uk_UA\Payment
bank; // "Ощадбанк"
Faker\Provider\zh_TW\Person
personalIdentityNumber; // A223456789
Faker\Provider\zh_TW\Company
VAT; //23456789
willdurand/faker-bundle: Put the awesome Faker library into the Symfony2 DIC and populate your database with fake data.
hautelook/alice-bundle,
h4cc/alice-fixtures-bundle: Bundles for using
nelmio/aliceand Faker with data fixtures. Able to use Doctrine ORM as well as Doctrine MongoDB ODM.
emanueleminotto/faker-service-provider: Faker Service Provider for Silex
bit3/faker-cli: Command Line Tool for the Faker PHP library
league/factory-muffin: enable the rapid creation of objects (PHP port of factory-girl)
fzaninotto/company-name-generator: Generate names for English tech companies with class
emanueleminotto/faker-placehold-it-provider: Generate images using placehold.it
spyrit/dataleaA highly customizable random test data generator web app
frequenc1/newage-ipsum: A new aged ipsum provider for the faker library inspired by http://sebpearce.com/bullshit/
prewk/xml-faker: Create fake XML with Faker
denheck/faker-context: Behat context using Faker to generate testdata
swekaj/cron-expression-generator: Faker provider for generating random, valid cron expressions.
pragmafabrik/pomm-faker: Faker client for Pomm database framework (PostgreSQL)
nelmio/alice: Fixtures/object generator with a yaml DSL that can use Faker as data generator.
ravage84/cakephp-fake-seederA CakePHP 2.x shell to seed your database with fake and/or fixed data.
bheller/images-generator: An image generator provider using GD for placeholder type pictures
pattern-lab/plugin-faker: Pattern Lab is a Styleguide, Component Library, and Prototyping tool. This creates unique content each time Pattern Lab is generated.
guidocella/eloquent-populator: Adapter for Laravel's Eloquent ORM.
tamperdata/exiges: Faker provider for generating random temperatures
jzonta/faker-restaurant: Faker for Food and Beverage names generate
aalaap/faker-youtube: Faker for YouTube URLs in various formats
pelmered/fake-car: Faker for cars and car data
bluemmb/faker-picsum-photos-provider: Generate images using picsum.photos
er1z/fakemock: Generate mocks using class-configuration and detection via Faker's guesser and Symfony asserts
xvladqt/faker-lorem-flickr: Generate images using loremflickr.com
metrakit/faker-eddy-malou: Generate French Eddy Malou sentences & paragraphs
drupol/belgian-national-number-faker: Generate fake Belgian national numbers
elgentos/masquerade: Configuration-based, platform-agnostic, locale-compatible data faker tool (out-of-the-box support for Magento 2)
ottaviano/faker-gravatar: Generate avatars using Gravatar
finwe/phpstan-faker: PHPStan extension for Faker methods
Faker is released under the MIT License. See the bundled LICENSE file for details.