This commit is contained in:
Torsten 2018-08-07 10:42:11 +02:00
parent 98419bd18d
commit 8a69e45efa
4919 changed files with 28311 additions and 224136 deletions

492
pfosten/vendor/fzaninotto/faker/readme.md vendored Executable file → Normal file
View file

@ -31,6 +31,7 @@ Faker requires PHP >= 5.3.3.
- [Barcode](#fakerproviderbarcode)
- [Miscellaneous](#fakerprovidermiscellaneous)
- [Biased](#fakerproviderbiased)
- [Html Lorem](#fakerproviderhtmllorem)
- [Modifiers](#modifiers)
- [Localization](#localization)
- [Populating Entities Using an ORM or an ODM](#populating-entities-using-an-orm-or-an-odm)
@ -103,7 +104,7 @@ Each of the generator properties (like `name`, `address`, and `lorem`) are calle
randomDigit // 7
randomDigitNotNull // 5
randomNumber($nbDigits = NULL) // 79907610
randomNumber($nbDigits = NULL, $strict = false) // 79907610
randomFloat($nbMaxDecimals = NULL, $min = 0, $max = NULL) // 48.8932
numberBetween($min = 1000, $max = 9000) // 8567
randomLetter // 'b'
@ -179,17 +180,17 @@ Each of the generator properties (like `name`, `address`, and `lorem`) are calle
### `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')
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 = 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')
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'
@ -199,6 +200,8 @@ Each of the generator properties (like `name`, `address`, and `lorem`) are calle
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'
@ -262,9 +265,12 @@ Each of the generator properties (like `name`, `address`, and `lorem`) are calle
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', true, 'Faker') // 'tmp/13b73edae8443990be1aa8f1a483bc27.jpg' it's a cat with Faker text
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`
@ -288,6 +294,7 @@ Each of the generator properties (like `name`, `address`, and `lorem`) are calle
countryCode // UK
languageCode // en
currencyCode // EUR
emoji // 😁
### `Faker\Provider\Biased`
@ -295,6 +302,11 @@ Each of the generator properties (like `name`, `address`, and `lorem`) are calle
// 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.
@ -359,9 +371,15 @@ try {
}
```
If you would like to use a modifier with a value not generated by Faker, use the `passthrough()` method. `passthrough()` simply returns whatever value it was given.
```php
$faker->optional()->passthrough(mt_rand(5, 15));
```
## 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).
`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
<?php
@ -385,7 +403,7 @@ You can check available Faker locales in the source code, [under the `Provider`
## Populating Entities Using an ORM or an ODM
Faker provides adapters for Object-Relational and Object-Document Mappers (currently, [Propel](http://www.propelorm.org), [Doctrine2](http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/), [CakePHP](http://cakephp.org), [Spot2](https://github.com/vlucas/spot2) and [Mandango](https://github.com/mandango/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).
Faker provides adapters for Object-Relational and Object-Document Mappers (currently, [Propel](http://www.propelorm.org), [Doctrine2](http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/), [CakePHP](http://cakephp.org), [Spot2](https://github.com/vlucas/spot2), [Mandango](https://github.com/mandango/mandango) and [Eloquent](https://laravel.com/docs/master/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.
@ -550,7 +568,7 @@ $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 ?>"/>
<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 ?>"/>
@ -586,7 +604,7 @@ Running this script produces a document looking like:
```xml
<?xml version="1.0" encoding="UTF-8"?>
<contacts>
<contact firstName="Ona" lastName="Bednar" email="schamberger.frank@wuckert.com"/>
<contact firstName="Ona" lastName="Bednar" email="schamberger.frank@wuckert.com">
<phone number="1-265-479-1196x714"/>
<address>
<street>182 Harrison Cove</street>
@ -604,7 +622,7 @@ Illum commodi molestiae aut repellat id. Et sit consequuntur aut et ullam asperi
]]>
</details>
</contact>
<contact firstName="Aurelie" lastName="Paucek" email="alfonzo55@durgan.com"/>
<contact firstName="Aurelie" lastName="Paucek" email="alfonzo55@durgan.com">
<phone number="863.712.1363x9425"/>
<address>
<street>90111 Hegmann Inlet</street>
@ -615,7 +633,7 @@ Illum commodi molestiae aut repellat id. Et sit consequuntur aut et ullam asperi
<company name="Krajcik-Grimes" catchPhrase="Switchable cohesive instructionset">
</company>
</contact>
<contact firstName="Clifton" lastName="Kshlerin" email="kianna.wiegand@framiwyman.info"/>
<contact firstName="Clifton" lastName="Kshlerin" email="kianna.wiegand@framiwyman.info">
<phone number="692-194-4746"/>
<address>
<street>9791 Nona Corner</street>
@ -626,7 +644,7 @@ Illum commodi molestiae aut repellat id. Et sit consequuntur aut et ullam asperi
<company name="Rosenbaum-Aufderhar" catchPhrase="Realigned asynchronous encryption">
</company>
</contact>
<contact firstName="Alexandre" lastName="Orn" email="thelma37@erdmancorwin.biz"/>
<contact firstName="Alexandre" lastName="Orn" email="thelma37@erdmancorwin.biz">
<phone number="189.655.8677x027"/>
<address>
<street>11161 Schultz Via</street>
@ -645,7 +663,7 @@ Aut asperiores nihil eius repellendus. Vero nihil corporis voluptatem explicabo
]]>
</details>
</contact>
<contact firstName="Katelynn" lastName="Kohler" email="reinger.trudie@stiedemannjakubowski.com"/>
<contact firstName="Katelynn" lastName="Kohler" email="reinger.trudie@stiedemannjakubowski.com">
<phone number="(665)713-1657"/>
<address>
<street>6106 Nader Village Suite 753</street>
@ -658,7 +676,7 @@ Aut asperiores nihil eius repellendus. Vero nihil corporis voluptatem explicabo
<director name="Arden Deckow" />
</company>
</contact>
<contact firstName="Blanca" lastName="Stark" email="tad27@feest.net"/>
<contact firstName="Blanca" lastName="Stark" email="tad27@feest.net">
<phone number="168.719.4692x87177"/>
<address>
<street>7546 Kuvalis Plaza</street>
@ -669,7 +687,7 @@ Aut asperiores nihil eius repellendus. Vero nihil corporis voluptatem explicabo
<company name="Upton, Braun and Rowe" catchPhrase="Visionary leadingedge pricingstructure">
</company>
</contact>
<contact firstName="Rene" lastName="Spencer" email="anibal28@armstrong.info"/>
<contact firstName="Rene" lastName="Spencer" email="anibal28@armstrong.info">
<phone number="715.222.0095x175"/>
<birth date="2008-08-07" place="Zulaufborough"/>
<address>
@ -690,7 +708,7 @@ Et similique qui non expedita quia dolorum. Ex rem incidunt ea accusantium tempo
]]>
</details>
</contact>
<contact firstName="Alessandro" lastName="Hagenes" email="tbreitenberg@oharagorczany.com"/>
<contact firstName="Alessandro" lastName="Hagenes" email="tbreitenberg@oharagorczany.com">
<phone number="1-284-958-6768"/>
<address>
<street>1251 Koelpin Mission</street>
@ -701,7 +719,7 @@ Et similique qui non expedita quia dolorum. Ex rem incidunt ea accusantium tempo
<company name="Stiedemann-Bruen" catchPhrase="Re-engineered 24/7 success">
</company>
</contact>
<contact firstName="Novella" lastName="Rutherford" email="claud65@bogisich.biz"/>
<contact firstName="Novella" lastName="Rutherford" email="claud65@bogisich.biz">
<phone number="(091)825-7971"/>
<address>
<street>6396 Langworth Hills Apt. 446</street>
@ -713,7 +731,7 @@ Et similique qui non expedita quia dolorum. Ex rem incidunt ea accusantium tempo
<director name="Earlene Bayer" />
</company>
</contact>
<contact firstName="Andreane" lastName="Mann" email="meggie17@ornbaumbach.com"/>
<contact firstName="Andreane" lastName="Mann" email="meggie17@ornbaumbach.com">
<phone number="941-659-9982x5689"/>
<birth date="1934-02-21" place="Stantonborough"/>
<address>
@ -745,6 +763,15 @@ Fugiat non in itaque sunt nobis totam. Sed nesciunt est deleniti cumque alias. R
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
<?php
echo $faker->bankAccountNumber // "SA0218IBYZVZJSEC8536V4XC"
```
### `Faker\Provider\at_AT\Payment`
@ -832,6 +859,66 @@ echo $faker->cvr; // "32458723"
echo $faker->p; // "5398237590"
```
### `Faker\Provider\de_DE\Payment`
```php
<?php
echo $faker->bankAccountNumber; // "DE41849025553661169313"
echo $faker->bank; // "Volksbank Stuttgart"
```
### `Faker\Provider\en_HK\Address`
```php
<?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
<?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
<?php
// Generates a random region name
echo $faker->region; // 'Katsina'
```
### `Faker\Provider\en_NG\Person`
```php
<?php
// Generates a random person name
echo $faker->name; // 'Oluwunmi Mayowa'
```
### `Faker\Provider\en_NZ\Phone`
```php
@ -847,6 +934,15 @@ echo $faker->tollFreeNumber; // "0800 123 456"
echo $faker->areaCode; // "03"
```
### `Faker\Provider\en_US\Company`
```php
<?php
// Generate a random Employer Identification Number
echo $faker->ein; // '12-3456789'
```
### `Faker\Provider\en_US\Payment`
```php
@ -856,6 +952,15 @@ echo $faker->bankAccountNumber; // '51915734310'
echo $faker->bankRoutingNumber; // '212240302'
```
### `Faker\Provider\en_US\Person`
```php
<?php
// Generates a random Social Security Number
echo $faker->ssn; // '123-45-6789'
```
### `Faker\Provider\en_ZA\Company`
```php
@ -865,6 +970,18 @@ echo $faker->bankRoutingNumber; // '212240302'
echo $faker->companyNumber; // 1999/789634/01
```
### `Faker\Provider\en_ZA\Person`
```php
<?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
@ -884,6 +1001,68 @@ echo $faker->mobileNumber; // 082 123 5555
// 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
<?php
// Generates a Código de identificación Fiscal (CIF) number
echo $faker->vat; // "A35864370"
```
### `Faker\Provider\es_PE\Person`
```php
<?php
// Generates a Peruvian Documento Nacional de Identidad (DNI) number
echo $faker->dni; // '83367512'
```
### `Faker\Provider\fa_IR\Address`
```php
<?php
// Generates a random building name
echo $faker->building; // "ساختمان آفتاب"
// Returns a random city name
echo $faker->city // "استان زنجان"
```
### `Faker\Provider\fa_IR\Company`
```php
<?php
// Generates a random contract type
echo $faker->contract; // "رسمی"
```
### `Faker\Provider\fi_FI\Payment`
```php
<?php
// Generates a random bank account number
echo $faker->bankAccountNumber; // "FI8350799879879616"
```
### `Faker\Provider\fi_FI\Person`
```php
<?php
//Generates a valid Finnish personal identity number (in Finnish - Henkilötunnus)
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`
@ -895,6 +1074,24 @@ 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
<?php
// Generate a Cédula de identidad number, you can pass one argument to add separator
echo $faker->nationalId; // 'V11223344'
```
### `Faker\Provider\es_VE\Company`
```php
<?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
@ -911,6 +1108,9 @@ $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`
@ -925,6 +1125,52 @@ echo $faker->siren; // 082 250 104
echo $faker->siret; // 347 355 708 00224
```
### `Faker\Provider\fr_FR\Payment`
```php
<?php
// Generates a random VAT
echo $faker->vat; // FR 12 123 456 789
```
### `Faker\Provider\fr_FR\Person`
```php
<?php
// Generates a random NIR / Sécurité Sociale number
echo $faker->nir; // 1 88 07 35 127 571 - 19
```
### `Faker\Provider\fr_FR\PhoneNumber`
```php
<?php
// Generates phone numbers
echo $faker->phoneNumber; // +33 (0)1 67 97 01 31
echo $faker->mobileNumber; // +33 6 21 12 72 84
echo $faker->serviceNumber // 08 98 04 84 46
```
### `Faker\Provider\he_IL\Payment`
```php
<?php
echo $faker->bankAccountNumber // "IL392237392219429527697"
```
### `Faker\Provider\hr_HR\Payment`
```php
<?php
echo $faker->bankAccountNumber // "HR3789114847226078672"
```
### `Faker\Provider\hu_HU\Payment`
```php
@ -934,6 +1180,18 @@ echo $faker->siret; // 347 355 708 00224
echo $faker->bankAccountNumber; // "HU09904437680048220079300783"
```
### `Faker\Provider\id_ID\Person`
```php
<?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
@ -958,10 +1216,16 @@ echo $faker->taxId(); // "DIXDPZ44E08F367A"
<?php
// Generates a 'kana' name
echo $faker->kanaName; // "アオタ ミノル"
echo $faker->kanaName($gender = null|'male'|'female') // "アオタ ミノル"
// Generates a 'kana' first name
echo $faker->firstKanaName; // "ハルカ"
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; // "ナカジマ"
@ -1004,6 +1268,9 @@ echo $faker->bankAccountNumber; // "KZ1076321LO4H6X41I37"
// 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`
@ -1018,6 +1285,26 @@ echo $faker->metropolitanCity; // "서울특별시"
echo $faker->borough; // "강남구"
```
### `Faker\Provider\ko_KR\PhoneNumber`
```php
<?php
// Generates a local area phone numer
echo $faker->localAreaPhoneNumber; // "02-1234-4567"
// Generates a cell phone number
echo $faker->cellPhoneNumber; // "010-9876-5432"
```
### `Faker\Provider\lt_LT\Payment`
```php
<?php
echo $faker->bankAccountNumber // "LT300848876740317118"
```
### `Faker\Provider\lv_LV\Person`
```php
@ -1027,6 +1314,69 @@ echo $faker->borough; // "강남구"
echo $faker->personalIdentityNumber; // "140190-12301"
```
### `Faker\Provider\ms_MY\Address`
```php
<?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
<?php
// Generates a random vehicle license plate number
echo $faker->jpjNumberPlate; // "WPL 5169"
```
### `Faker\Provider\ms_MY\Payment`
```php
<?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
<?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
<?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
@ -1048,6 +1398,15 @@ 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
<?php
echo $faker->rrn(); // "83051711784" - Belgian Rijksregisternummer
echo $faker->rrn('female'); // "50032089858" - Belgian Rijksregisternummer for a female
```
### `Faker\Provider\nl_NL\Company`
```php
@ -1057,7 +1416,15 @@ echo $faker->vat; // "NL123456789B01" - Dutch Value Added Tax number
echo $faker->btw; // "NL123456789B01" - Dutch Value Added Tax number (alias)
```
### `Faker\Provider\no_NO\Payment`
### `Faker\Provider\nl_NL\Person`
```php
<?php
echo $faker->idNumber; // "111222333" - Dutch Personal identification number (BSN)
```
### `Faker\Provider\nb_NO\Payment`
```php
<?php
@ -1141,8 +1508,8 @@ 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)
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`
@ -1157,6 +1524,7 @@ echo $faker->name; // 'Sr. Luis Adriano Sepúlveda Filho'
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`
@ -1164,7 +1532,7 @@ echo $faker->rg; // '84.405.736-3'
```php
<?php
// Generates a Brazilian formated and valid CNPJ
// Generates a Brazilian formatted and valid CNPJ
echo $faker->cnpj; // '23.663.478/0001-24'
echo $faker->cnpj(false); // '23663478000124'
```
@ -1196,19 +1564,22 @@ echo $faker->bankAccountNumber; // "RO55WRJE3OE8X3YQI7J26U1E"
echo $faker->prefixMale; // "ing."
// Generates a random female name prefix/title
echo $faker->prefixFemale; // "d-na."
// Generates a random male fist name
// Generates a random male first name
echo $faker->firstNameMale; // "Adrian"
// Generates a random female fist name
// Generates a random female first 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
// $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`
@ -1229,6 +1600,12 @@ echo $faker->premiumRatePhoneNumber; // "0900123456"
// 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`
@ -1251,6 +1628,15 @@ 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\tr_TR\Person`
```php
<?php
//Generates a valid Turkish identity number (in Turkish - T.C. Kimlik No)
echo $faker->tcNo // '55300634882'
```
### `Faker\Provider\zh_CN\Payment`
@ -1262,6 +1648,34 @@ echo $faker->personalIdentityNumber('female') // '950910-0781'
echo $faker->bank; // '中国建设银行'
```
### `Faker\Provider\uk_UA\Payment`
```php
<?php
// Generates an Ukraine bank name (based on list of real Ukraine banks)
echo $faker->bank; // "Ощадбанк"
```
### `Faker\Provider\zh_TW\Person`
```php
<?php
// Generates a random personal identify number
echo $faker->personalIdentityNumber; // A223456789
```
### `Faker\Provider\zh_TW\Company`
```php
<?php
// Generates a random VAT / Company Tax number
echo $faker->VAT; //23456789
```
## Third-Party Libraries Extending/Based On Faker
* Symfony2 bundles:
@ -1281,6 +1695,12 @@ echo $faker->bank; // '中国建设银行'
* [nelmio/alice](https://packagist.org/packages/nelmio/alice): Fixtures/object generator with a yaml DSL that can use Faker as data generator.
* [CakePHP 2.x Fake Seeder Plugin](https://github.com/ravage84/cakephp-fake-seeder) A CakePHP 2.x shell to seed your database with fake and/or fixed data.
* [images-generator](https://github.com/bruceheller/images-generator): An image generator provider using GD for placeholder type pictures
* [pattern-lab/plugin-php-faker](https://github.com/pattern-lab/plugin-php-faker): Pattern Lab is a Styleguide, Component Library, and Prototyping tool. This creates unique content each time Pattern Lab is generated.
* [guidocella/eloquent-populator](https://github.com/guidocella/eloquent-populator): Adapter for Laravel's Eloquent ORM.
* [tamperdata/exiges](https://github.com/tamperdata/exiges): Faker provider for generating random temperatures
* [jzonta/FakerRestaurant](https://github.com/jzonta/FakerRestaurant): Faker for Food and Beverage names generate
* [aalaap/faker-youtube](https://github.com/aalaap/faker-youtube): Faker for YouTube URLs in various formats
* [pelmered/fake-car](https://github.com/pelmered/fake-car): Faker for cars and car data
## License