Faker

Faker is a PHP library that generates fake data for you

Subscribe to updates I use Faker


Statistics on Faker

Number of watchers on Github 14568
Number of open issues 65
Average time to close an issue 6 days
Main language PHP
Average time to merge a PR 4 days
Open pull requests 195+
Closed pull requests 105+
Last commit 9 months ago
Repo Created about 7 years ago
Repo Last Updated 8 months ago
Size 7.63 MB
Organization / Authorfzaninotto
Latest Releasev1.7.0
Contributors211
Page Updated
Do you use Faker? Leave a review!
View open issues (65)
View Faker activity
View TODOs for Faker (6)
View on github
Latest Open Source Launches
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating Faker for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

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.

Faker is heavily inspired by Perl's Data::Faker, and by ruby's Faker.

Faker requires PHP >= 5.3.3.

Monthly Downloads Build Status SensioLabsInsight

Table of Contents

Installation

composer require fzaninotto/faker

Basic Usage

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.

<?php
// require the Faker autoloader
require_once '/path/to/Faker/src/autoload.php';
// alternatively, use another PSR-0 compliant autoloader (like the Symfony2 ClassLoader for instance)

// use the factory to create a Faker\Generator instance
$faker = Faker\Factory::create();

// 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->name yields a different (random) result. This is because Faker uses __get() magic, and forwards Faker\Generator->$property calls to Faker\Generator->format($property).

<?php
for ($i=0; $i < 10; $i++) {
  echo $faker->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.

Formatters

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
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._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}'); // sm0@y8k96a.ej

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 $timezone argument 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                   // 'tkshlerin@collins.com'
safeEmail               // 'king.alford@example.org'
freeEmail               // 'bradley72@gmail.com'
companyEmail            // 'russel.durward@mcdermott.org'
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'

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/grey/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)   // <html><head><title>Aut illo dolorem et accusantium eum.</title></head><body><form action="example.com" method="POST"><label for="username">sequi</label><input type="text" id="username"><label for="password">et</label><input type="password" id="password"></form><b>Id aut saepe non mollitia voluptas voluptas.</b><table><thead><tr><tr>Non consequatur.</tr><tr>Incidunt est.</tr><tr>Aut voluptatem.</tr><tr>Officia voluptas rerum quo.</tr><tr>Asperiores similique.</tr></tr></thead><tbody><tr><td>Sapiente dolorum dolorem sint laboriosam commodi qui.</td><td>Commodi nihil nesciunt eveniet quo repudiandae.</td><td>Voluptates explicabo numquam distinctio necessitatibus repellat.</td><td>Provident ut doloremque nam eum modi aspernatur.</td><td>Iusto inventore.</td></tr><tr><td>Animi nihil ratione id mollitia libero ipsa quia tempore.</td><td>Velit est officia et aut tenetur dolorem sed mollitia expedita.</td><td>Modi modi repudiandae pariatur voluptas rerum ea incidunt non molestiae eligendi eos deleniti.</td><td>Exercitationem voluptatibus dolor est iste quod molestiae.</td><td>Quia reiciendis.</td></tr><tr><td>Inventore impedit exercitationem voluptatibus rerum cupiditate.</td><td>Qui.</td><td>Aliquam.</td><td>Autem nihil aut et.</td><td>Dolor ut quia error.</td></tr><tr><td>Enim facilis iusto earum et minus rerum assumenda quis quia.</td><td>Reprehenderit ut sapiente occaecati voluptatum dolor voluptatem vitae qui velit.</td><td>Quod fugiat non.</td><td>Sunt nobis totam mollitia sed nesciunt est deleniti cumque.</td><td>Repudiandae quo.</td></tr><tr><td>Modi dicta libero quisquam doloremque qui autem.</td><td>Voluptatem aliquid saepe laudantium facere eos sunt dolor.</td><td>Est eos quis laboriosam officia expedita repellendus quia natus.</td><td>Et neque delectus quod fugit enim repudiandae qui.</td><td>Fugit soluta sit facilis facere repellat culpa magni voluptatem maiores tempora.</td></tr><tr><td>Enim dolores doloremque.</td><td>Assumenda voluptatem eum perferendis exercitationem.</td><td>Quasi in fugit deserunt ea perferendis sunt nemo consequatur dolorum soluta.</td><td>Maxime repellat qui numquam voluptatem est modi.</td><td>Alias rerum rerum hic hic eveniet.</td></tr><tr><td>Tempore voluptatem.</td><td>Eaque.</td><td>Et sit quas fugit iusto.</td><td>Nemo nihil rerum dignissimos et esse.</td><td>Repudiandae ipsum numquam.</td></tr><tr><td>Nemo sunt quia.</td><td>Sint tempore est neque ducimus harum sed.</td><td>Dicta placeat atque libero nihil.</td><td>Et qui aperiam temporibus facilis eum.</td><td>Ut dolores qui enim et maiores nesciunt.</td></tr><tr><td>Dolorum totam sint debitis saepe laborum.</td><td>Quidem corrupti ea.</td><td>Cum voluptas quod.</td><td>Possimus consequatur quasi dolorem ut et.</td><td>Et velit non hic labore repudiandae quis.</td></tr></tbody></table></body></html>

Modifiers

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!";
}

Localization

Faker\Factory can 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).

<?php
$faker = Faker\Factory::create('fr_FR'); // create a French faker
for ($i=0; $i < 10; $i++) {
  echo $faker->name, "\n";
}
  // Luce du Coulon
  // Auguste Dupont
  // Roger Le Voisin
  // Alexandre Lacroix
  // Jacques Humbert-Roy
  // Thrse Guillet-Andre
  // Gilles Gros-Bodin
  // Amlie Pires
  // Marcel Laporte
  // Genevive Marchal

You can check available Faker locales in the source code, under the Provider directory. 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!

Populating Entities Using an ORM or an ODM

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.

Here is an example showing how to populate 5 Author and 10 Book objects:

<?php
$generator = \Faker\Factory::create();
$populator = new Faker\ORM\Propel\Populator($generator);
$populator->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_name using the firstName formatter, and a column with a TIMESTAMP type using the dateTime formatter. 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():

<?php
$populator->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 null for the column names in the third argument of addEntity(). This is usually necessary for columns added by a behavior:

<?php
$populator->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:

<?php
print_r($insertedPKs);
// array(
//   'Author' => (34, 35, 36, 37, 38),
//   'Book'   => (456, 457, 458, 459, 470, 471, 472, 473, 474, 475)
// )

In the previous example, the Book and Author models share a relationship. Since Author entities are populated first, Faker is smart enough to relate the populated Book entities to one of the populated Author entities.

Lastly, if you want to execute an arbitrary function on an entity before insertion, use the fourth argument of the addEntity() method:

<?php
$populator->addEntity('Book', 5, array(), array(
  function($book) { $book->publish(); },
));

Seeding the Generator

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.

<?php
$faker = Faker\Factory::create();
$faker->seed(1234);

echo $faker->name; // 'Jess Mraz I';

Tip: DateTime formatters won't reproduce the same fake data if you don't fix the $max value:

<?php
// even when seeded, this line will return different results because $max varies
$faker->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 seeded

Tip: Formatters won't reproduce the same fake data if you use the rand() php function. Use $faker or mt_rand() instead:

<?php
// bad
$faker->realText(rand(10,20));
// good
$faker->realText($faker->numberBetween(10,20));

Faker Internals: Understanding Providers

A Faker\Generator alone can't do much generation. It needs Faker\Provider objects to delegate the data generation to them. Faker\Factory::create() actually creates a Faker\Generator bundled with the default providers. Here is what happens under the hood:

<?php
$faker = new Faker\Generator();
$faker->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 $faker object, the generator looks for a method with the same name in all the providers attached to it. For instance, calling $faker->name triggers 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\Generator instance. 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 $generator property. The new formatters are the public methods of the provider class.

Here is an example provider for populating Book data:

<?php

namespace Faker\Provider;

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\Book to an existing generator:

<?php
$faker->addProvider(new \Faker\Provider\Book($faker));

Now you can use the two new formatters like any other Faker formatter:

<?php
$book = new Book();
$book->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.

Real Life Usage

The following script generates a valid XML document:

<?php
require_once '/path/to/Faker/src/autoload.php';
$faker = Faker\Factory::create();
?>
<?xml version="1.0" encoding="UTF-8"?>
<contacts>
<?php for ($i=0; $i < 10; $i++): ?>
  <contact firstName="<?php echo $faker->firstName ?>" lastName="<?php echo $faker->lastName ?>" email="<?php echo $faker->email ?>">
    <phone number="<?php echo $faker->phoneNumber ?>"/>
<?php if ($faker->boolean(25)): ?>
    <birth date="<?php echo $faker->dateTimeThisCentury->format('Y-m-d') ?>" place="<?php echo $faker->city ?>"/>
<?php endif; ?>
    <address>
      <street><?php echo $faker->streetAddress ?></street>
      <city><?php echo $faker->city ?></city>
      <postcode><?php echo $faker->postcode ?></postcode>
      <state><?php echo $faker->state ?></state>
    </address>
    <company name="<?php echo $faker->company ?>" catchPhrase="<?php echo $faker->catchPhrase ?>">
<?php if ($faker->boolean(33)): ?>
      <offer><?php echo $faker->bs ?></offer>
<?php endif; ?>
<?php if ($faker->boolean(33)): ?>
      <director name="<?php echo $faker->name ?>" />
<?php endif; ?>
    </company>
<?php if ($faker->boolean(15)): ?>
    <details>
<![CDATA[
<?php echo $faker->text(400) ?>
]]>
    </details>
<?php endif; ?>
  </contact>
<?php endfor; ?>
</contacts>

Running this script produces a document looking like:

<?xml version="1.0" encoding="UTF-8"?>
<contacts>
  <contact firstName="Ona" lastName="Bednar" email="schamberger.frank@wuckert.com">
    <phone number="1-265-479-1196x714"/>
    <address>
      <street>182 Harrison Cove</street>
      <city>North Lloyd</city>
      <postcode>45577</postcode>
      <state>Alabama</state>
    </address>
    <company name="Veum, Funk and Shanahan" catchPhrase="Function-based stable solution">
      <offer>orchestrate compelling web-readiness</offer>
    </company>
    <details>
<![CDATA[
Alias accusantium voluptatum autem nobis cumque neque modi. Voluptatem error molestiae consequatur alias.
Illum commodi molestiae aut repellat id. Et sit consequuntur aut et ullam asperiores. Cupiditate culpa voluptatem et mollitia dolor. Nisi praesentium qui ut.
]]>
    </details>
  </contact>
  <contact firstName="Aurelie" lastName="Paucek" email="alfonzo55@durgan.com">
    <phone number="863.712.1363x9425"/>
    <address>
      <street>90111 Hegmann Inlet</street>
      <city>South Geovanymouth</city>
      <postcode>69961-9311</postcode>
      <state>Colorado</state>
    </address>
    <company name="Krajcik-Grimes" catchPhrase="Switchable cohesive instructionset">
    </company>
  </contact>
  <contact firstName="Clifton" lastName="Kshlerin" email="kianna.wiegand@framiwyman.info">
    <phone number="692-194-4746"/>
    <address>
      <street>9791 Nona Corner</street>
      <city>Harberhaven</city>
      <postcode>74062-8191</postcode>
      <state>RhodeIsland</state>
    </address>
    <company name="Rosenbaum-Aufderhar" catchPhrase="Realigned asynchronous encryption">
    </company>
  </contact>
  <contact firstName="Alexandre" lastName="Orn" email="thelma37@erdmancorwin.biz">
    <phone number="189.655.8677x027"/>
    <address>
      <street>11161 Schultz Via</street>
      <city>Feilstad</city>
      <postcode>98019</postcode>
      <state>NewJersey</state>
    </address>
    <company name="O'Hara-Prosacco" catchPhrase="Re-engineered solution-oriented algorithm">
      <director name="Dr. Berenice Auer V" />
    </company>
    <details>
<![CDATA[
Ut itaque et quaerat doloremque eum praesentium. Rerum in saepe dolorem. Explicabo qui consequuntur commodi minima rem.
Harum temporibus rerum dolores. Non molestiae id dolorem placeat.
Aut asperiores nihil eius repellendus. Vero nihil corporis voluptatem explicabo commodi. Occaecati omnis blanditiis beatae quod aspernatur eos.
]]>
    </details>
  </contact>
  <contact firstName="Katelynn" lastName="Kohler" email="reinger.trudie@stiedemannjakubowski.com">
    <phone number="(665)713-1657"/>
    <address>
      <street>6106 Nader Village Suite 753</street>
      <city>McLaughlinstad</city>
      <postcode>43189-8621</postcode>
      <state>Missouri</state>
    </address>
    <company name="Herman-Tremblay" catchPhrase="Object-based explicit service-desk">
      <offer>expedite viral synergies</offer>
      <director name="Arden Deckow" />
    </company>
  </contact>
  <contact firstName="Blanca" lastName="Stark" email="tad27@feest.net">
    <phone number="168.719.4692x87177"/>
    <address>
      <street>7546 Kuvalis Plaza</street>
      <city>South Wilfrid</city>
      <postcode>77069</postcode>
      <state>Georgia</state>
    </address>
    <company name="Upton, Braun and Rowe" catchPhrase="Visionary leadingedge pricingstructure">
    </company>
  </contact>
  <contact firstName="Rene" lastName="Spencer" email="anibal28@armstrong.info">
    <phone number="715.222.0095x175"/>
    <birth date="2008-08-07" place="Zulaufborough"/>
    <address>
      <street>478 Daisha Landing Apt. 510</street>
      <city>West Lizethhaven</city>
      <postcode>30566-5362</postcode>
      <state>WestVirginia</state>
    </address>
    <company name="Wiza Inc" catchPhrase="Persevering reciprocal approach">
      <offer>orchestrate dynamic networks</offer>
      <director name="Erwin Nienow" />
    </company>
    <details>
<![CDATA[
Dolorem consequatur voluptates unde optio unde. Accusantium dolorem est est architecto impedit. Corrupti et provident quo.
Reprehenderit dolores aut quidem suscipit repudiandae corporis error. Molestiae enim aperiam illo.
Et similique qui non expedita quia dolorum. Ex rem incidunt ea accusantium temporibus minus non.
]]>
    </details>
  </contact>
  <contact firstName="Alessandro" lastName="Hagenes" email="tbreitenberg@oharagorczany.com">
    <phone number="1-284-958-6768"/>
    <address>
      <street>1251 Koelpin Mission</street>
      <city>North Revastad</city>
      <postcode>81620</postcode>
      <state>Maryland</state>
    </address>
    <company name="Stiedemann-Bruen" catchPhrase="Re-engineered 24/7 success">
    </company>
  </contact>
  <contact firstName="Novella" lastName="Rutherford" email="claud65@bogisich.biz">
    <phone number="(091)825-7971"/>
    <address>
      <street>6396 Langworth Hills Apt. 446</street>
      <city>New Carlos</city>
      <postcode>89399-0268</postcode>
      <state>Wyoming</state>
    </address>
    <company name="Stroman-Legros" catchPhrase="Expanded 4thgeneration moratorium">
      <director name="Earlene Bayer" />
    </company>
  </contact>
  <contact firstName="Andreane" lastName="Mann" email="meggie17@ornbaumbach.com">
    <phone number="941-659-9982x5689"/>
    <birth date="1934-02-21" place="Stantonborough"/>
    <address>
      <street>2246 Kreiger Station Apt. 291</street>
      <city>Kaydenmouth</city>
      <postcode>11397-1072</postcode>
      <state>Wyoming</state>
    </address>
    <company name="Lebsack, Bernhard and Kiehn" catchPhrase="Persevering actuating framework">
      <offer>grow sticky portals</offer>
    </company>
    <details>
<![CDATA[
Quia dolor ut quia error libero. Enim facilis iusto earum et minus rerum assumenda. Quia doloribus et reprehenderit ut. Occaecati voluptatum dolor voluptatem vitae qui velit quia.
Fugiat non in itaque sunt nobis totam. Sed nesciunt est deleniti cumque alias. Repudiandae quo aut numquam modi dicta libero.
]]>
    </details>
  </contact>
</contacts>

Language specific formatters

Faker\Provider\ar_SA\Person

<?php

echo $faker->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

<?php

echo $faker->bankAccountNumber // "SA0218IBYZVZJSEC8536V4XC"

Faker\Provider\at_AT\Payment

<?php

echo $faker->vat;           // "AT U12345678" - Austrian Value Added Tax number
echo $faker->vat(false);    // "ATU12345678" - unspaced Austrian Value Added Tax number

Faker\Provider\bg_BG\Payment

<?php

echo $faker->vat;           // "BG 0123456789" - Bulgarian Value Added Tax number
echo $faker->vat(false);    // "BG0123456789" - unspaced Bulgarian Value Added Tax number

Faker\Provider\cs_CZ\Address

<?php

echo $faker->region; // "Libereck kraj"

Faker\Provider\cs_CZ\Company

<?php

// Generates a valid IO
echo $faker->ico; // "69663963"

Faker\Provider\cs_CZ\DateTime

<?php

echo $faker->monthNameGenitive; // "prosince"
echo $faker->formattedDate; // "12. listopadu 2015"

Faker\Provider\cs_CZ\Person

<?php

echo $faker->birthNumber; // "7304243452"

Faker\Provider\da_DK\Person

<?php

// Generates a random CPR number
echo $faker->cpr; // "051280-2387"

Faker\Provider\da_DK\Address

<?php

// Generates a random 'kommune' name
echo $faker->kommune; // "Frederiksberg"

// Generates a random region name
echo $faker->region; // "Region Sjlland"

Faker\Provider\da_DK\Company

<?php

// Generates a random CVR number
echo $faker->cvr; // "32458723"

// Generates a random P number
echo $faker->p; // "5398237590"

Faker\Provider\de_DE\Payment

<?php

echo $faker->bankAccountNumber; // "DE41849025553661169313"
echo $faker->bank; // "Volksbank Stuttgart"

Faker\Provider\en_HK\Address

<?php

// Generates a fake town name based on the words commonly found in Hong Kong
echo $faker->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

<?php

// Generates a Hong Kong mobile number (starting with 5, 6 or 9)
echo $faker->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

<?php

// Generates a random region name
echo $faker->region; // 'Katsina'

Faker\Provider\en_NG\Person

<?php

// Generates a random person name
echo $faker->name; // 'Oluwunmi Mayowa'

Faker\Provider\en_NZ\Phone

<?php

// Generates a cell (mobile) phone number
echo $faker->cellNumber; // "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

<?php

// Generate a random Employer Identification Number
echo $faker->ein; // '12-3456789'

Faker\Provider\en_US\Payment

<?php

echo $faker->bankAccountNumber;  // '51915734310'
echo $faker->bankRoutingNumber;  // '212240302'

Faker\Provider\en_US\Person

<?php

// Generates a random Social Security Number
echo $faker->ssn; // '123-45-6789'

Faker\Provider\en_ZA\Company

<?php

// Generates a random company registration number
echo $faker->companyNumber; // 1999/789634/01

Faker\Provider\en_ZA\Person

<?php

// Generates a random national identification number
echo $faker->idNumber; // 6606192211041

// Generates a random valid licence code
echo $faker->licenceCode; // EB

Faker\Provider\en_ZA\PhoneNumber

<?php

// Generates a special rate toll free phone number
echo $faker->tollFreeNumber; // 0800 555 5555

// Generates a mobile phone number
echo $faker->mobileNumber; // 082 123 5555

Faker\Provider\es_ES\Person

<?php

// Generates a Documento Nacional de Identidad (DNI) number
echo $faker->dni; // '77446565E'

// Generates a random valid licence code
echo $faker->licenceCode; // B

Faker\Provider\es_ES\Payment

<?php
// Generates a Cdigo de identificacin Fiscal (CIF) number
echo $faker->vat;           // "A35864370"

Faker\Provider\es_PE\Person

<?php

// Generates a Peruvian Documento Nacional de Identidad (DNI) number
echo $faker->dni; // '83367512'

Faker\Provider\fa_IR\Address

<?php

// Generates a random building name
echo $faker->building; // " "

// Returns a random city name
echo $faker->city // " "

Faker\Provider\fa_IR\Company

<?php

// Generates a random contract type
echo $faker->contract; // ""

Faker\Provider\fi_FI\Payment

<?php

// Generates a random bank account number
echo $faker->bankAccountNumber; // "FI8350799879879616"

Faker\Provider\fi_FI\Person

<?php

//Generates a valid Finnish personal identity number (in Finnish - Henkiltunnus)
echo $faker->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

<?php

echo $faker->vat;           // "BE 0123456789" - Belgian Value Added Tax number
echo $faker->vat(false);    // "BE0123456789" - unspaced Belgian Value Added Tax number

Faker\Provider\es_VE\Person

<?php

// Generate a Cdula de identidad number, you can pass one argument to add separator
echo $faker->nationalId; // 'V11223344'

Faker\Provider\es_VE\Company

<?php

// Generates a R.I.F. number, you can pass one argument to add separators
echo $faker->taxpayerIdentificationNumber; // 'J1234567891'

Faker\Provider\fr_FR\Address

<?php

// Generates a random department name
echo $faker->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

<?php

// Generates a random SIREN number
echo $faker->siren; // 082 250 104

// Generates a random SIRET number
echo $faker->siret; // 347 355 708 00224

Faker\Provider\fr_FR\Payment

<?php

// Generates a random VAT
echo $faker->vat; // FR 12 123 456 789

Faker\Provider\fr_FR\Person

<?php

// Generates a random NIR / Scurit Sociale number
echo $faker->nir; // 1 88 07 35 127 571 - 19

Faker\Provider\he_IL\Payment

<?php

echo $faker->bankAccountNumber // "IL392237392219429527697"

Faker\Provider\hr_HR\Payment

<?php

echo $faker->bankAccountNumber // "HR3789114847226078672"

Faker\Provider\hu_HU\Payment

<?php

// Generates a random bank account number
echo $faker->bankAccountNumber; // "HU09904437680048220079300783"

Faker\Provider\id_ID\Person

<?php

// Generates a random Nomor Induk Kependudukan (NIK)

// 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_IT\Company

<?php

// Generates a random Vat Id
echo $faker->vatId(); // "IT98746784967"

Faker\Provider\it_IT\Person

<?php

// Generates a random Tax Id code (Codice fiscale)
echo $faker->taxId(); // "DIXDPZ44E08F367A"

Faker\Provider\ja_JP\Person

<?php

// Generates a 'kana' name
echo $faker->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

<?php

// Generates a random bank account number
echo $faker->bankAccountNumber; // "GE33ZV9773853617253389"

Faker\Provider\kk_KZ\Company

<?php

// Generates an business identification number
echo $faker->businessIdentificationNumber; // "150140000019"

Faker\Provider\kk_KZ\Payment

<?php

// Generates a random bank name
echo $faker->bank; // ""

// Generates a random bank account number
echo $faker->bankAccountNumber; // "KZ1076321LO4H6X41I37"

Faker\Provider\kk_KZ\Person

<?php

// Generates an individual identification number
echo $faker->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

<?php

// Generates a metropolitan city
echo $faker->metropolitanCity; // ""

// Generates a borough
echo $faker->borough; // ""

Faker\Provider\lt_LT\Payment

<?php

echo $faker->bankAccountNumber // "LT300848876740317118"

Faker\Provider\lv_LV\Person

<?php

// Generates a random personal identity card number
echo $faker->personalIdentityNumber; // "140190-12301"

Faker\Provider\ms_MY\Address

<?php

// Generates a random Malaysian township
echo $faker->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

<?php

// Generates a random vehicle license plate number
echo $faker->jpjNumberPlate; // "WPL 5169"

Faker\Provider\ms_MY\Payment

<?php

// Generates a random Malaysian bank
echo $faker->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

<?php

// Generates a random personal identity card (myKad) number
echo $faker->myKadNumber($gender = null|'male'|'female', $hyphen = null|true|false); // "710703471796"

Faker\Provider\ms_MY\PhoneNumber

<?php

// Generates a random Malaysian mobile number
echo $faker->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

<?php

//Generates a Nepali district name
echo $faker->district;

//Generates a Nepali city name
echo $faker->cityName;

Faker\Provider\nl_BE\Payment

<?php

echo $faker->vat;           // "BE 0123456789" - Belgian Value Added Tax number
echo $faker->vat(false);    // "BE0123456789" - unspaced Belgian Value Added Tax number

Faker\Provider\nl_BE\Person

<?php

echo $faker->rrn();         // "83051711784" - Belgian Rijksregisternummer
echo $faker->rrn('female'); // "50032089858" - Belgian Rijksregisternummer for a female

Faker\Provider\nl_NL\Company

<?php

echo $faker->vat; // "NL123456789B01" - Dutch Value Added Tax number
echo $faker->btw; // "NL123456789B01" - Dutch Value Added Tax number (alias)

Faker\Provider\nl_NL\Person

<?php

echo $faker->idNumber; // "111222333" - Dutch Personal identification number (BSN)

Faker\Provider\nb_NO\Payment

<?php

// Generates a random bank account number
echo $faker->bankAccountNumber; // "NO3246764709816"

Faker\Provider\pl_PL\Person

<?php

// Generates a random PESEL number
echo $faker->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

<?php

// Generates a random REGON number
echo $faker->regon; // "714676680"
// Generates a random local REGON number
echo $faker->regonLocal; // "15346111382836"

Faker\Provider\pl_PL\Payment

<?php

// Generates a random bank name
echo $faker->bank; // "Narodowy Bank Polski"
// Generates a random bank account number
echo $faker->bankAccountNumber; // "PL14968907563953822118075816"

Faker\Provider\pt_PT\Person

<?php

// Generates a random taxpayer identification number (in portuguese - Nmero de Identificao Fiscal NIF)
echo $faker->taxpayerIdentificationNumber; // '165249277'

Faker\Provider\pt_BR\Address

<?php

// Generates a random region name
echo $faker->region; // 'Nordeste'

// Generates a random region abbreviation
echo $faker->regionAbbr; // 'NE'

Faker\Provider\pt_BR\PhoneNumber

<?php

echo $faker->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

<?php

// The name generator may include double first or double last names, plus title and suffix
echo $faker->name; // 'Sr. Luis Adriano Seplveda 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

<?php

// Generates a Brazilian formatted and valid CNPJ
echo $faker->cnpj;        // '23.663.478/0001-24'
echo $faker->cnpj(false); // '23663478000124'

Faker\Provider\ro_MD\Payment

<?php

// Generates a random bank account number
echo $faker->bankAccountNumber; // "MD83BQW1CKMUW34HBESDP3A8"

Faker\Provider\ro_RO\Payment

<?php

// Generates a random bank account number
echo $faker->bankAccountNumber; // "RO55WRJE3OE8X3YQI7J26U1E"

Faker\Provider\ro_RO\Person

<?php

// Generates a random male name prefix/title
echo $faker->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

<?php

// Generates a random toll-free phone number
echo $faker->tollFreePhoneNumber; // "0800123456"
// Generates a random premium-rate phone number
echo $faker->premiumRatePhoneNumber; // "0900123456"

Faker\Provider\ru_RU\Payment

<?php

// Generates a Russian bank name (based on list of real russian banks)
echo $faker->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

<?php

// Generates a random bank account number
echo $faker->bankAccountNumber; // "SE5018548608468284909192"

Faker\Provider\sv_SE\Person

<?php

//Generates a valid Swedish personal identity number (in Swedish - Personnummer)
echo $faker->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\zh_CN\Payment

<?php

// Generates a random bank name (based on list of real chinese banks)
echo $faker->bank; // ''

Faker\Provider\uk_UA\Payment

<?php

// Generates an Ukraine bank name (based on list of real Ukraine banks)
echo $faker->bank; // ""

Faker\Provider\zh_TW\Person

<?php

// Generates a random personal identify number
echo $faker->personalIdentityNumber; // A223456789

Faker\Provider\zh_TW\Company

<?php

// Generates a random VAT / Company Tax number
echo $faker->VAT; //23456789

Third-Party Libraries Extending/Based On Faker

License

Faker is released under the MIT Licence. See the bundled LICENSE file for details.

Faker open issues Ask a question     (View All Issues)
  • about 2 years Feature suggestion - support to neighborhood in Address
  • about 2 years Naming proposal: randomFoo → foo
  • about 2 years Invalid date/time values generated (DST)
  • about 2 years year rule with min option
  • about 2 years faker generates unsupported timezones
  • over 2 years imageUrl lorempixel is down
  • over 2 years Timezone conversion issue
  • over 2 years Faker sometimes generates invalid email addresses
  • over 2 years Doctrine Entities with Setter Association Behavior Failing
  • over 2 years License Contamination
  • almost 3 years CakePHP 3.x - InvalidArgumentException to relate entities
  • over 3 years Cannot instanciate abstract class Text
  • over 3 years Dates before the epoch
  • over 3 years Disable CakePHP Model Behavior before populating data
  • over 3 years Doctrine entities are created without calling their constructor
  • over 4 years Greek Random Letter
  • over 5 years Doctrine Populator execute does not return an array of pks
  • about 6 years Populating join tables
Faker open pull requests (View All Pulls)
  • Added few countries to he_IL Provider file Address.php
  • Add region and region abbreviation methods
  • Added Dutch text
  • improved Austrian names, states and realtext
  • Latvian first names
  • Latvia phone number format
  • Update zh_TW text provider
  • Init new Geo provider for geographical and spatial data. Move longitu…
  • Added some fixes to Armenian locale
  • Improve Swiss phone numbers
  • Fixed a lot of semicolon missings
  • Text Provider ensure text starts with an uppercase letter #527
  • Added unit test folder for en_UG provider and AddressTest.php
  • Added en_PH unit test folder + AddressTest.php
  • Added en_NZ unit test folder + PhoneNumberTest.php
  • en_GB Provider unit test folder added
  • en_CA unit test folder added
  • Added en_AU unit test folder
  • el_GR provider unit test folder added
  • add DNI generator to spanis person
  • Updated TLD list for South Africa locale
  • * Updated Phone Number Provider for the en_ZA locale
  • Change middleName method, added female middle names
  • Issue #668
  • Update Person.php
  • Added ar_JO unit test folder + InternetTest.php
  • Add en_IN localization
  • Add Thai providers
  • Fix pt br check digit
  • Add Mongolian Provider
  • Added en_IN unit test for Address.php
  • docs: Clarify that randomElements() does not repeat input elements
  • Add fa_IR Color
  • Fixed person national id for foreigners and new function for compani…
  • [WIP] VAT provider
  • Added (tk_TM) Turkmen lang support
  • Adds time zone support for provider methods returning DateTime instance
  • Add more support for fa_IR locale
  • Fix some data for ukrainian generator
  • Removed non NL names
  • Added de_CH Provider
  • +1 VAT Provider w/ 40+ countries rules, fix #591
  • Add International Mobile Equipment Identity (IMEI)
  • Basic Lithuanian provider
  • Text Provider ensure text starts with an uppercase letter
  • +1 Internet::html() provider, based on Lorem::text()
  • Support v1.3.*@dev Turkish language.
  • Fix Doctrine ODM Support
  • add new locale for en_SG
  • Doctrine orm polish
  • use Luhn to calculate ar_SA id numbers.
  • Add greek mobile and toll-free phone numbers
  • added Purok and Baguio City Barangays
  • add Algerian (ar_DZ) names provider
  • Added unsplash api for Random Image Holder and new updated bn_BD data and phone number function modification.
  • Add Propel2 ORM support for faker
  • SK personal code and ID card number generators
  • Add Indonesia vehicle license (police) number
  • Fix French Cell phone number format
  • Add a building number with letter to German speaking locales.
  • Removed fa_IR license contamination
  • Eliminated license contamination from kk_KZ locale
  • VAT and National identification number for the fi_FI provider
  • Add Indonesian text provider, a domain and an email
  • ka_GE: overall improvements to ka_GE locale
  • Add ISIN (International Securities Identification Number)
  • Add Romanian Text
  • Add phpdoc method dateTimeInInterval in Generator.php
  • Added support for Luxembourgish (lb_LU)
  • Added brazilian banks and improvements in pt_BR docs
  • Modified the phone number pattern to match right pattern for bn/BD loc…
  • Harmonize fr_*\Company
  • Fix: fix invalid parameter of mb_substr()
  • kk_KZ Company/person identification numbers unit tests
  • es_PE: Add Documento Nacional de Identificación (DNI) and first names.
  • Fix to Issue #935 - German Locale
  • Added Polish person titles.
  • Improved en_GB and ro_RO
  • el_CY Locale
  • Added missing grayscale option/flag to Image provider
  • Added brazilian banks and improvements in pt_BR docs
  • Adds generators for Norwegian (nb_NO) counties and "kommune", using existing static arrays in the class
  • HTML Lorem
  • Fix a mixup between male and female last names in Icelandic.
  • Remove duplicate
  • Fixed a security breach for ro_RO/Text.php
  • Brazilian open source text for text.php at Provider\pt_BR
  • fix [zh_CN]PhoneNumber illegal operator prefix
  • added PHP docs
  • es_ES: Generate VAT Number
  • Update Image.php
  • adding landline phone number for en_GB
  • Malaysian Localization Provider
  • Fix phpunit tests fail on 64-bit systems #982
  • Added 'bank' formatter to Payment provider which returns bank name.
  • Mexico
  • add georgian Personal number
  • added سجادی to last names
  • Remove trailing dot in username if any
  • #989 Fix country typo
  • Added Bosnian provider
  • Estonian locale
  • adding back CNP
  • Add nik to indonesia
  • Update Person.php
  • German Bank Names
  • Update es_ES/Company.php
  • Add bankAccountNumber implementations
  • Generates a random NIR number (fr_FR)
  • [fi_FI] Improve phone number generator
  • Add personalIdentityNumber() to fi_FI/Person.php
  • Update Text.php
  • [pl_PL] Added counties support (issue #1028).
  • Update Turkish Name Provider
  • Added id number generator to Person Provider for the en_ZA locale
  • ar_PS Arabic Palestinian Providers
  • make sure in case of female pesel 10th number always divides by 2
  • Improving tr_TR Providers
  • Spacing and line length updates
  • Updated spacing and line length
  • Reduced line lengths
  • Amended permissions for en_GB AddressTest.php
  • [de_DE] changes
  • Add Thai providers
  • Added Nepali Information and Edited some as well
  • Fix unused code
  • Removed legacy autoloader
  • Made unformatted and international formats configurable
  • Azerbaijani locale added
  • Update MasterCard BIN Range
  • Add biggest german cities
  • VAT and National identification number for the fi_FI provider
  • Added basic ar_DZ locale provider
  • fixed german localizations
  • [ru_RU] Add jobTitle
  • Introduced the ability to specify the timezone for dateTimeThis*() methods
  • Add strict to randomNumber example
  • Added missing $state property
  • Create Text.php for tr_TR
  • Added a generator so its possible to get a associative out from a associative array
  • Expand dictionaries for ru_RU locale
  • add Côte d'Ivoire french provider
  • Add es_MX provider
  • use secure https
  • Fix: Add class-level method annotations for DateTime provider
  • create Text.php for zh_CN
  • Implemented strict comparison on zh_TW/Person.php
  • fixed phone number length and spelling mistake of country name in the bd_BD localized version
  • Fix Image Faker
  • Add the option to generate HTML fragments and the body of an HTML doc…
  • remove bad phone number from ru_RU PhoneNumber
  • Add arabic persons name in English languages
  • Add real text for es_ES
  • Add more PhoneNumber options for es_ES
  • Fix spelling errors
  • Update names of Ukrainian cities
  • Fix duplication in uk_UA male first names
  • Add job title and more for fa_IR
  • refactoring
  • Modify wrong number format to correct numberformat
  • added Malaysia [ms_MY] locale
  • Implementation of the function that generates Brazilian area codes fixed.
  • Added LT surnames, street names.
  • Add Chinese (simplified) Lorem and Text provider
  • en_za id number outdated
  • Added New Provider for Afghanistan [fa_AF]
  • Add Thai Person provider and update formatter for Thai credit cards
  • Add German Email Providers
  • Added a Document Number for Dutch citizens
  • Added PDO support
  • Update French local with actual words, domains, ans regions
  • Adding the es_MX Provider
  • Added Bolivian providers
  • Add Estonian locale
  • Update Faker/src/Faker/Provider/de_DE/Company.php
  • Add the option to generate HTML fragments and the body of an HTML document
  • Added Malaysia Localized data and fix Singapore able to generate StreetName from Array
  • Add hi_IN Provider
  • Add YouTube provider link
  • Added randomHtmlFragment method to generate html strings without html…
  • Add German job titles
  • Fix the problem with image load.
  • Facebook doesn't allow names with 3 or more consecutive identical characters
  • Add en_GB safe phone number formatters
  • Fix some providers for bg_BG and add Address Provider.
  • Some changes in fa_IR
  • Add DateTime formatter for fr_FR and fr_BE
  • added jobTitle to fa_IR
  • List of banks in Brazil added
  • change PHPUnit namespace, set coverage setting
  • Added Color provider for fa_IR (Persian)
  • Removed unknown postcode
  • Adds valid 08 number formats for fr_FR
  • Added Chilean Localization
  • Taiwan ID. The initial letter must be a capital letter. p->P
Faker questions on Stackoverflow (View All Questions)
  • Should we be using Faker in Rails Factories?
  • How faker generate a yaml list that browser understand?
  • Generating test data of incremental dates faker laravel
  • laravel testing with faker big text
  • NameError: uninitialized constant Faker ; Ruby on Rails
  • Faker gem: possible to seed with stylized text?
  • Generating Paperclip image uploads with fake data - Ruby on Rails Populator / Faker Gems
  • Change Faker Locale in Laravel 5.2
  • Populate tables with Faker
  • php fzaninotto Faker - How to Generate Only 5 Digit Zip Code?
  • applying a function to faker
  • Generating test data with Faker
  • Expediency of using Faker in Minitest fixtures
  • Faker Package, Database Seeder Issues
  • WATIR: faker gem not working
  • Unexpected tIDENTIFIER using Faker gem
  • Faker is producing duplicate data when used in factory_girl
  • How to get future date in Faker
  • how to get city inside a especific country with Faker extension
  • PHP Faker. How to create N unique words?
  • faker (python) randomizes in shell, but not in DjangoModelFactory object
  • Parse error in Faker for Laravel 5.0
  • Set MySQL Timestamp field using Faker
  • Deployment on Laravel Forge throwing faker not found Exception
  • FactoryGirl + Faker - same data being generated for every object in db seed data
  • how to use biasedNumberBetween faker?
  • Faker Gem creating fake picture not working
  • How to install faker module on python (windows 7)
  • Rspec Factory Girl faker does not accept column
  • Rspec + FactoryGirl + Faker tests failing randomly
Faker list of languages used
Faker latest release notes
v1.7.0 v1.7.0
v1.6.0 v1.6.0
v1.5.0 v1.5.0
  • Added ability to print custom text on the images fetched by the Image provider #583 (fzaninotto)
  • Fixed typos in Preuvian (es_PE) Person provider #581 #580 (ysramirez)
  • Added instructions for installing with composer to readme.md #572 (totophe)
  • Added Kazakh (kk_KZ) locale #569 (YerlenZhubangaliyev)
  • Added Korean (ko_KR) locale #566 (pearlc)
  • Fixed file provider to ignore unreadable and special files #565 (svrnm)
  • Fixed Dutch (nl_NL) Address and Person providers #560 (killerog)
  • Fixed Dutch (nl_NL) Person provider #559 (pauledenburg)
  • Added Russian (ru_RU) Bank names provider #553 (wizardjedi)
  • Added mobile phone function in French (fr_FR) provider #552 (kletellier)
  • Added phpdoc for new magic methods in Generator to help IntelliSense completion #550 (stof)
  • Fixed File provider bug 'The first argument to copy() function cannot be a directory' #547 (svrnm)
  • Added new Brazilian (pt_BR) Providers #545 (igorsantos07)
  • Fixed ability to seed the generator #543 (schmengler)
  • Added streetAddress formatter to Russian (ru_RU) provider #542 (ZAYEC77)
  • Fixed Internet provider warning Could not create transliterator* #541 (fonsecas72)
  • Fixed Spanish for Argentina (es_AR) Address provider #540 (ivanmirson)
  • Fixed region names in French for Belgium (fr_BE) address provider #536 (miclf)
  • Fixed broken Doctrine2 link in README #534 (JonathanKryza)
  • Added link to faker-context Behat extension in readme #532 (denheck)
  • Added PHP 7.0 nightly to Travis build targets #525 (TomasVotruba)
  • Added Dutch (nl_NL) color names #523 (belendel)
  • Fixed Chinese (zh_CN) Address provider (remove Taipei) #522 (asika32764)
  • Fixed phonenumber formats in Dutch (nl_NL) PhoneNumber provider #521 (SpaceK33z)
  • Fixed Russian (ru_RU) Address provider #518 (glagola)
  • Added Italian (it_IT) Text provider #517 (endelwar)
  • Added Norwegian (no_NO) locale #515 (phaza)
  • Added VAT number to Bulgarian (bg_BG) Payment provider #512 (ronanguilloux)
  • Fixed UserAgent provider outdated user agents #511 (ajbdev)
  • Fixed image() formatter to make it work with temp dir of any (decent) OS #507 (ronanguilloux)
  • Added Persian (fa_IR) locale #500 (zoli)
  • Added Currency Code formatter #497 (stelgenhof)
  • Added VAT number to Belgium (be_BE) Payment provider #495 (ronanguilloux)
  • Fixed imageUrl formatter bug where it would always return the same image #494 (fzaninotto)
  • Added more Indonesian (id_ID) providers #493 (deerawan)
  • Added Indonesian (id_ID) locale #492 (stoutZero)
  • Fixed unique generator performance #491 (ikwattro)
  • Added transliterator to email and username #490 (fzaninotto)
  • Added Hungarian (hu_HU) Text provider #486 (lintaba)
  • Fixed CakePHP Entity Popolator (some cases where no entities prev. inserted) #483 (jadb)
  • Added Color and DateTime Turkish (tr_TR) Providers #481 (behramcelen)
  • Added Latvian (lv_LV) personalIdentityNumber formatter #472 (MatissJanis)
  • Added VAT number to Austrian (at_AT) Payment provider #470 (ronanguilloux)
  • Fixed missing @return phpDoc in Payment provider #469 (ronanguilloux)
  • Added SWIFT/BIC payment type formatter to the Payment provider #465 (ronanguilloux)
  • Fixed small typo in Base provider exception #460 (miclf)
  • Added Georgian (ka_Ge) locale #457 (lperto)
  • Added PSR-4 Autoloading #455 (GrahamCampbell)
  • Added Uganda (en_UG) locale #454 (tharoldD)
  • Added regexify formatter, generating a random string based on a regular expression #453 (fzaninotto)
  • Added shuffle formatter, to shuffle an array or a string #452 (fzaninotto)
  • Added ISBN-10 & ISBN-13 codes formatters to Barcode provider #451 (gietos)
  • Fixed Russian (ru_RU) middle names (different for different genders) #450 (gietos)
  • Fixed Ukranian (uk_UA) Person provider #448 (aivus)
  • Added Vietnamese (vi_VN) locale #447 (huy95)
  • Added type hint to the Documentor constructor #446 (JeroenDeDauw)
  • Fixed Russian (ru_RU) Person provider (joined names) #445 (aivus)
  • Added English (en_GB) mobileNumber methods #438 (daveblake)
  • Added Traditional Chinese (zh_TW) Realtext provider #434 (tzhuan)
  • Fixed first name in Spanish for Argentina (es_AR) Person provider #433 (fzaninotto)
  • Fixed Canadian (en_CA) state abbreviation for Nunavut #430 (julien-c)
  • Added CakePHP ORM entity populator #428 (jadb)
  • Added Traditional Chinese (zh_TW) locale #427 (tzhuan)
  • Fixed typo in Doctrine Populator phpDoc #425 (ihsanudin)
  • Added Chinese (zh_CN) Internet provider #424 (Lisso-Me)
  • Added Country ISO 3166-1 alpha-3 code to the Miscellaneous provider#422 (gido)
  • Added English (en_GB) Person provider #421 (AlexCutts)
  • Added missing tests for the Color Provider #420 (bessl)
  • Added Nepali (ne_NP) locale #419 (ankitpokhrel)
  • Fixed latitude and longitude formatters bug (numeric value out of range for 32bits) #416 (fzaninotto)
  • Added a dedicated calculator Luhn calculator service #414 (fzaninotto)
  • Fixed Russian (ru_RU) Person provider (removed lowercase duplications) #413 (Ragazzo)
  • Fixed barcode formatter (improved speed, added tests) #412 (fzaninotto)
  • Added ipv4 and barcode formatters tests #410 (bessl)
  • Fixed typos in various comments blocks #409 (bessl)
  • Fixed InternetTest (replaced regex with PHP filter) #406 (bessl)
  • Added password formatter to the Internet provider#402 (fzaninotto)
  • Added Company and Internet Austrian (de_AT) Providers #400 (bessl)
  • Added third-party libraries section in README #399 (fzaninotto)
  • Added Spanish for Venezuela (es_VE) locale #398 (DIOHz0r)
  • Added PhoneNumber Autrian (de_AT) Provider, and missing test for the 'locale' method. #395 (bessl)
  • Removed wrongly localized Lorem provider #394 (fzaninotto)
  • Fixed Miscellaneous provider (made the locale formatter static) #390 (bessl)
  • Added a unit test file for the Miscellaneous Provider #389 (bessl)
  • Added warning in README about using rand()` and the seed functions #386 (paulvalla)
  • Fixed French (fr_FR) Person provider (Uppercased a first name) #385 (netcarver)
  • Added Russian (ru_RU) and Ukrainian (uk_UA) Text providers #383 (terion-name)
  • Added more street prefixes to French (fr_FR) Address provider #381 (ronanguilloux)
  • Added PHP 5.6 to CI targets #378 (GrahamCampbell)
  • Fixed spaces remaining at the end of liine in various files #377 (GrahamCampbell)
  • Fixed UserAgent provider (added space before processor on linux platform) #374 (TomK)
  • Added Company generator for Russian (ru_RU) locale #371 (kix)
  • Fixed Russian (ru_RU) Color provider (uppercase letters) #370 (semanser)
  • Added more Polish (pl_PL) phone numbers #369 (piotrantosik)
  • Fixed Ruby Faker link in readme #368 (philsturgeon)
  • Added more Japanese (ja_JP) names in Person provider #366 (kumamidori)
  • Added Slovenian (sl_SL) locale #363 (alesf)
  • Fixed German (de_DE) Person provider (first names) #362 (mikehaertl)
  • Fixed Ukrainian (uk_UA) Person providr (there is no such letter "" in Ukrainian) #359 (nazar-pc)
  • Fixed Chinese (zh_CN) PhoneNumber provider (the length of mobile phone number is 11) #358 (byan)
  • Added Arabic (ar_\JO) Locale #357 (zrashwani)
  • Fixed Czech (cs_CZ) Person provider (missing lowercase in last name) #355 (halaxa)
  • Fixed French for Belgium (fr_BE) Address Provider (doubled city names) #354 (miclf)
  • Added Biased Integer Provider #332 (TimWolla)
  • Added Swedish (sv_SE) locale #316 (ulrikjohansson)
  • Added English for New Zealand (en_NZ) locale #283 (JasonMortonNZ)
  • Added mention of external Provider for cron expressions to readme#498 (swekaj)
Other projects in PHP