mead cff8596724 init		4 anni fa
..
src	cff8596724 init	4 anni fa
test	cff8596724 init	4 anni fa
.travis.yml	cff8596724 init	4 anni fa
CHANGELOG.md	cff8596724 init	4 anni fa
CONTRIBUTING.md	cff8596724 init	4 anni fa
LICENSE	cff8596724 init	4 anni fa
Makefile	cff8596724 init	4 anni fa
composer.json	cff8596724 init	4 anni fa
phpunit.xml.dist	cff8596724 init	4 anni fa
readme.md	cff8596724 init	4 anni fa

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.

Installation
Basic Usage
Formatters
- Base
- Lorem Ipsum Text
- Person
- Address
- Phone Number
- Company
- Real Text
- Date and Time
- Internet
- User Agent
- Payment
- Color
- File
- Image
- Uuid
- Barcode
- Miscellaneous
- Biased
Modifiers
Localization
Populating Entities Using an ORM or an ODM
Seeding the Generator
Faker Internals: Understanding Providers
Real Life Usage
Language specific formatters
Third-Party Libraries Extending/Based On Faker
License

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) // 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 = date_default_timezone_get()) // DateTime('2008-04-25 08:37:17', 'UTC')
dateTimeAD($max = 'now', $timezone = date_default_timezone_get()) // 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 = date_default_timezone_get()) // DateTime('2003-03-15 02:00:49', 'Africa/Lagos')
dateTimeInInterval($startDate = '-30 years', $interval = '+ 5 days', $timezone = date_default_timezone_get()) // DateTime('2003-03-15 02:00:49', 'Antartica/Vostok')
dateTimeThisCentury($max = 'now')     // DateTime('1915-05-30 19:28:21')
dateTimeThisDecade($max = 'now')      // DateTime('2007-05-29 22:30:48')
dateTimeThisYear($max = 'now')        // DateTime('2011-02-27 20:52:14')
dateTimeThisMonth($max = 'now')       // DateTime('2011-10-23 13:46:23')
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'

`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'
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', true, 'Faker') // 'tmp/13b73edae8443990be1aa8f1a483bc27.jpg' it's a cat with Faker text

`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

`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')

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_EN).

<?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
  // 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 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 and Mandango 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
> <?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 <?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 <?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 <?php $faker->addProvider(new \Faker\Provider\Book($faker));


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

php <?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 <?php require_once '/path/to/Faker/src/autoload.php'; $faker = Faker\Factory::create(); ?> <?xml version="1.0" encoding="UTF-8"?> <?php for ($i=0; $i < 10; $i++): ?>

<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>

</details>

<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>

<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>

<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>

</details>

<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>

<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>

<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>

</details>

<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>

<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>

<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>

</details>


## Language specific formatters

### `Faker\Provider\ar_SA\Person`

php <?php

echo $faker->idNumber; // ID number echo $faker->nationalIdNumber // Citizen ID number echo $faker->foreignerIdNumber // Foreigner ID number


### `Faker\Provider\at_AT\Payment`

php <?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 <?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 <?php

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


### `Faker\Provider\cs_CZ\Company`

php <?php

// Generates a valid IČO echo $faker->ico; // "69663963"


### `Faker\Provider\cs_CZ\DateTime`

php <?php

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


### `Faker\Provider\cs_CZ\Person`

php <?php

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


### `Faker\Provider\da_DK\Person`

php <?php

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


### `Faker\Provider\da_DK\Address`

php <?php

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

// Generates a random region name echo $faker->region; // "Region Sjælland"


### `Faker\Provider\da_DK\Company`

php <?php

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

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


### `Faker\Provider\en_NZ\Phone`

php <?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\Payment`

php <?php

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


### `Faker\Provider\en_ZA\Company`

php <?php

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


### `Faker\Provider\en_ZA\PhoneNumber`

php <?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 <?php

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


### `Faker\Provider\fr_BE\Payment`

php <?php

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


### `Faker\Provider\fr_FR\Address`

php <?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"


### `Faker\Provider\fr_FR\Company`

php <?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\hu_HU\Payment`

php <?php

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


### `Faker\Provider\it_IT\Company`

php <?php

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


### `Faker\Provider\it_IT\Person`

php <?php

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


### `Faker\Provider\ja_JP\Person`

php <?php

// Generates a 'kana' name echo $faker->kanaName; // "アオタミノル"

// Generates a 'kana' first name echo $faker->firstKanaName; // "ハルカ"

// Generates a 'kana' last name echo $faker->lastKanaName; // "ナカジマ"


### `Faker\Provider\ka_GE\Payment`

php <?php

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


### `Faker\Provider\kk_KZ\Company`

php <?php

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


### `Faker\Provider\kk_KZ\Payment`

php <?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 <?php

// Generates an individual identification number echo $faker->individualIdentificationNumber; // "780322300455"


### `Faker\Provider\ko_KR\Address`

php <?php

// Generates a metropolitan city echo $faker->metropolitanCity; // "서울특별시"

// Generates a borough echo $faker->borough; // "강남구"


### `Faker\Provider\lv_LV\Person`

php <?php

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


### `Faker\Provider\ne_NP\Address`

php <?php

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

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


### `Faker\Provider\nl_BE\Payment`

php <?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_NL\Company`

php <?php

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


### `Faker\Provider\no_NO\Payment`

php <?php

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


### `Faker\Provider\pl_PL\Person`

php <?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 <?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 <?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 <?php

// Generates a random taxpayer identification number (in portuguese - Número de Identificação Fiscal NIF) echo $faker->taxpayerIdentificationNumber; // '165249277'


### `Faker\Provider\pt_BR\Address`

php <?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 <?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 (obbeying the 9th digit rule) echo $faker->phoneNumberCleared; // not formatted, random landline or cellphone (obbeying the 9th digit rule)


### `Faker\Provider\pt_BR\Person`

php <?php

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


### `Faker\Provider\pt_BR\Company`

php <?php

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


### `Faker\Provider\ro_MD\Payment`

php <?php

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


### `Faker\Provider\ro_RO\Payment`

php <?php

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


### `Faker\Provider\ro_RO\Person`

php <?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 fist name echo $faker->firstNameMale; // "Adrian" // Generates a random female fist name echo $faker->firstNameFemale; // "Miruna"

// Generates a random Personal Numerical Code (CNP) echo $faker->cnp; // "2800523081231" echo $faker->cnp($gender = NULL, $century = NULL, $county = NULL);

// Valid option values: // $gender: m, f, 1, 2 // $century: 1800, 1900, 2000, 1, 2, 3, 4, 5, 6 // $county: 2 letter ISO 3166-2:RO county codes and B1-B6 for Bucharest's 6 sectors


### `Faker\Provider\ro_RO\PhoneNumber`

php <?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 <?php

// Generates a Russian bank name (based on list of real russian banks) echo $faker->bank; // "ОТП Банк"


### `Faker\Provider\sv_SE\Payment`

php <?php

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


### `Faker\Provider\sv_SE\Person`

php <?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 <?php

// Generates a random bank name (based on list of real chinese banks) echo $faker->bank; // '中国建设银行' ```

Third-Party Libraries Extending/Based On Faker

Symfony2 bundles:
- BazingaFakerBundle: Put the awesome Faker library into the Symfony2 DIC and populate your database with fake data.
- AliceBundle, AliceFixturesBundle: Bundles for using Alice and Faker with data fixtures. Able to use Doctrine ORM as well as Doctrine MongoDB ODM.
FakerServiceProvider: Faker Service Provider for Silex
faker-cli: Command Line Tool for the Faker PHP library
Factory Muffin: enable the rapid creation of objects (PHP port of factory-girl)
CompanyNameGenerator: Generate names for English tech companies with class
PlaceholdItProvider: Generate images using placehold.it
datalea A highly customizable random test data generator web app
newage-ipsum: A new aged ipsum provider for the faker library inspired by http://sebpearce.com/bullshit/
xml-faker: Create fake XML with Faker
faker-context: Behat context using Faker to generate testdata
CronExpressionGenerator: Faker provider for generating random, valid cron expressions.
pragmafabrik/Pomm2Faker: Faker client for Pomm database framework (PostgreSQL)
nelmio/alice: Fixtures/object generator with a yaml DSL that can use Faker as data generator.
CakePHP 2.x Fake Seeder Plugin A CakePHP 2.x shell to seed your database with fake and/or fixed data.
images-generator: An image generator provider using GD for placeholder type pictures

License

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

readme.md

Faker

Table of Contents

Installation

Basic Usage

Formatters

Faker\Provider\Base

Faker\Provider\Lorem

Faker\Provider\en_US\Person

Faker\Provider\en_US\Address

Faker\Provider\en_US\PhoneNumber

Faker\Provider\en_US\Company

Faker\Provider\en_US\Text

Faker\Provider\DateTime

Faker\Provider\Internet

Faker\Provider\UserAgent

Faker\Provider\Payment

Faker\Provider\Color

Faker\Provider\File

Faker\Provider\Image

Faker\Provider\Uuid

Faker\Provider\Barcode

Faker\Provider\Miscellaneous

Faker\Provider\Biased

Modifiers

Localization

Populating Entities Using an ORM or an ODM

Seeding the Generator

Third-Party Libraries Extending/Based On Faker

License

`Faker\Provider\Base`

`Faker\Provider\Lorem`

`Faker\Provider\en_US\Person`

`Faker\Provider\en_US\Address`

`Faker\Provider\en_US\PhoneNumber`

`Faker\Provider\en_US\Company`

`Faker\Provider\en_US\Text`

`Faker\Provider\DateTime`

`Faker\Provider\Internet`

`Faker\Provider\UserAgent`

`Faker\Provider\Payment`

`Faker\Provider\Color`

`Faker\Provider\File`

`Faker\Provider\Image`

`Faker\Provider\Uuid`

`Faker\Provider\Barcode`

`Faker\Provider\Miscellaneous`

`Faker\Provider\Biased`