{"id":13399792,"url":"https://github.com/fzaninotto/Faker","last_synced_at":"2025-03-14T04:32:03.376Z","repository":{"id":1752587,"uuid":"2579314","full_name":"fzaninotto/Faker","owner":"fzaninotto","description":"Faker is a PHP library that generates fake data for you","archived":true,"fork":false,"pushed_at":"2024-03-20T13:44:54.000Z","size":10094,"stargazers_count":26796,"open_issues_count":228,"forks_count":3588,"subscribers_count":551,"default_branch":"master","last_synced_at":"2025-03-10T01:56:39.760Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fzaninotto.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2011-10-14T22:49:02.000Z","updated_at":"2025-03-07T22:54:07.000Z","dependencies_parsed_at":"2022-07-12T14:56:42.397Z","dependency_job_id":"d9647ecd-e26b-44a5-aec7-12e194747519","html_url":"https://github.com/fzaninotto/Faker","commit_stats":{"total_commits":1866,"total_committers":528,"mean_commits":3.534090909090909,"dds":0.8542336548767417,"last_synced_commit":"5ffe7db6c80f441f150fc88008d64e64af66634b"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fzaninotto%2FFaker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fzaninotto%2FFaker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fzaninotto%2FFaker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fzaninotto%2FFaker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fzaninotto","download_url":"https://codeload.github.com/fzaninotto/Faker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242946367,"owners_count":20210845,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T19:00:42.967Z","updated_at":"2025-03-14T04:31:58.364Z","avatar_url":"https://github.com/fzaninotto.png","language":"PHP","readme":"# Faker\n\n[![Monthly Downloads](https://poser.pugx.org/fzaninotto/faker/d/monthly.png)](https://packagist.org/packages/fzaninotto/faker)\n[![Continuous Integration](https://github.com/fzaninotto/Faker/workflows/Continuous%20Integration/badge.svg?branch=master)](https://github.com/fzaninotto/Faker/actions)\n[![codecov](https://codecov.io/gh/fzaninotto/Faker/branch/master/graph/badge.svg)](https://codecov.io/gh/fzaninotto/Faker)\n[![SensioLabsInsight](https://insight.sensiolabs.com/projects/eceb78a9-38d4-4ad5-8b6b-b52f323e3549/mini.png)](https://insight.sensiolabs.com/projects/eceb78a9-38d4-4ad5-8b6b-b52f323e3549)\n\nFaker 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.\n\nFaker is heavily inspired by Perl's [Data::Faker](http://search.cpan.org/~jasonk/Data-Faker-0.07/), and by ruby's [Faker](https://rubygems.org/gems/faker).\n\nFaker requires PHP \u003e= 5.3.3.\n\n**Faker is archived**. Read the reasons behind this decision here: [https://marmelab.com/blog/2020/10/21/sunsetting-faker.html](https://marmelab.com/blog/2020/10/21/sunsetting-faker.html) \n\n# Table of Contents\n\n- [Installation](#installation)\n- [Basic Usage](#basic-usage)\n- [Formatters](#formatters)\n\t- [Base](#fakerproviderbase)\n\t- [Lorem Ipsum Text](#fakerproviderlorem)\n\t- [Person](#fakerprovideren_usperson)\n\t- [Address](#fakerprovideren_usaddress)\n\t- [Phone Number](#fakerprovideren_usphonenumber)\n\t- [Company](#fakerprovideren_uscompany)\n\t- [Real Text](#fakerprovideren_ustext)\n\t- [Date and Time](#fakerproviderdatetime)\n\t- [Internet](#fakerproviderinternet)\n\t- [User Agent](#fakerprovideruseragent)\n\t- [Payment](#fakerproviderpayment)\n\t- [Color](#fakerprovidercolor)\n\t- [File](#fakerproviderfile)\n\t- [Image](#fakerproviderimage)\n\t- [Uuid](#fakerprovideruuid)\n\t- [Barcode](#fakerproviderbarcode)\n\t- [Miscellaneous](#fakerprovidermiscellaneous)\n\t- [Biased](#fakerproviderbiased)\n\t- [Html Lorem](#fakerproviderhtmllorem)\n- [Modifiers](#modifiers)\n- [Localization](#localization)\n- [Populating Entities Using an ORM or an ODM](#populating-entities-using-an-orm-or-an-odm)\n- [Seeding the Generator](#seeding-the-generator)\n- [Faker Internals: Understanding Providers](#faker-internals-understanding-providers)\n- [Real Life Usage](#real-life-usage)\n- [Language specific formatters](#language-specific-formatters)\n- [Third-Party Libraries Extending/Based On Faker](#third-party-libraries-extendingbased-on-faker)\n- [License](#license)\n\n\n## Installation\n\n```sh\ncomposer require fzaninotto/faker\n```\n\n## Basic Usage\n\n### Autoloading\n\nFaker supports both `PSR-0` as `PSR-4` autoloaders.\n```php\n\u003c?php\n# When installed via composer\nrequire_once 'vendor/autoload.php';\n```\n\nYou can also load `Fakers` shipped `PSR-0` autoloader\n```php\n\u003c?php\n# Load Fakers own autoloader\nrequire_once '/path/to/Faker/src/autoload.php';\n```\n\n*alternatively, you can use any another PSR-4 compliant autoloader*\n\n### Create fake data\nUse `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.\n\n```php\n\u003c?php\n// use the factory to create a Faker\\Generator instance\n$faker = Faker\\Factory::create();\n\n// generate data by accessing properties\necho $faker-\u003ename;\n  // 'Lucy Cechtelar';\necho $faker-\u003eaddress;\n  // \"426 Jordy Lodge\n  // Cartwrightshire, SC 88120-6700\"\necho $faker-\u003etext;\n  // Dolores sit sint laboriosam dolorem culpa et autem. Beatae nam sunt fugit\n  // et sit et mollitia sed.\n  // Fuga deserunt tempora facere magni omnis. Omnis quia temporibus laudantium\n  // sit minima sint.\n```\n\nEven if this example shows a property access, each call to `$faker-\u003ename` yields a different (random) result. This is because Faker uses `__get()` magic, and forwards `Faker\\Generator-\u003e$property` calls to `Faker\\Generator-\u003eformat($property)`.\n\n```php\n\u003c?php\nfor ($i = 0; $i \u003c 10; $i++) {\n  echo $faker-\u003ename, \"\\n\";\n}\n  // Adaline Reichel\n  // Dr. Santa Prosacco DVM\n  // Noemy Vandervort V\n  // Lexi O'Conner\n  // Gracie Weber\n  // Roscoe Johns\n  // Emmett Lebsack\n  // Keegan Thiel\n  // Wellington Koelpin II\n  // Ms. Karley Kiehn V\n```\n\n**Tip**: For a quick generation of fake data, you can also use Faker as a command line tool thanks to [faker-cli](https://github.com/bit3/faker-cli).\n\n## Formatters\n\nEach 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.\n\n### `Faker\\Provider\\Base`\n\n    randomDigit             // 7\n    randomDigitNot(5)       // 0, 1, 2, 3, 4, 6, 7, 8, or 9\n    randomDigitNotNull      // 5\n    randomNumber($nbDigits = NULL, $strict = false) // 79907610\n    randomFloat($nbMaxDecimals = NULL, $min = 0, $max = NULL) // 48.8932\n    numberBetween($min = 1000, $max = 9000) // 8567\n    randomLetter            // 'b'\n    // returns randomly ordered subsequence of a provided array\n    randomElements($array = array ('a','b','c'), $count = 1) // array('c')\n    randomElement($array = array ('a','b','c')) // 'b'\n    shuffle('hello, world') // 'rlo,h eoldlw'\n    shuffle(array(1, 2, 3)) // array(2, 1, 3)\n    numerify('Hello ###') // 'Hello 609'\n    lexify('Hello ???') // 'Hello wgt'\n    bothify('Hello ##??') // 'Hello 42jz'\n    asciify('Hello ***') // 'Hello R6+'\n    regexify('[A-Z0-9._%+-]+@[A-Z0-9.-]+\\.[A-Z]{2,4}'); // sm0@y8k96a.ej\n\n### `Faker\\Provider\\Lorem`\n\n    word                                             // 'aut'\n    words($nb = 3, $asText = false)                  // array('porro', 'sed', 'magni')\n    sentence($nbWords = 6, $variableNbWords = true)  // 'Sit vitae voluptas sint non voluptates.'\n    sentences($nb = 3, $asText = false)              // array('Optio quos qui illo error.', 'Laborum vero a officia id corporis.', 'Saepe provident esse hic eligendi.')\n    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.'\n    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.')\n    text($maxNbChars = 200)                          // 'Fuga totam reiciendis qui architecto fugiat nemo. Consequatur recusandae qui cupiditate eos quod.'\n\n### `Faker\\Provider\\en_US\\Person`\n\n    title($gender = null|'male'|'female')     // 'Ms.'\n    titleMale                                 // 'Mr.'\n    titleFemale                               // 'Ms.'\n    suffix                                    // 'Jr.'\n    name($gender = null|'male'|'female')      // 'Dr. Zane Stroman'\n    firstName($gender = null|'male'|'female') // 'Maynard'\n    firstNameMale                             // 'Maynard'\n    firstNameFemale                           // 'Rachel'\n    lastName                                  // 'Zulauf'\n\n### `Faker\\Provider\\en_US\\Address`\n\n    cityPrefix                          // 'Lake'\n    secondaryAddress                    // 'Suite 961'\n    state                               // 'NewMexico'\n    stateAbbr                           // 'OH'\n    citySuffix                          // 'borough'\n    streetSuffix                        // 'Keys'\n    buildingNumber                      // '484'\n    city                                // 'West Judge'\n    streetName                          // 'Keegan Trail'\n    streetAddress                       // '439 Karley Loaf Suite 897'\n    postcode                            // '17916'\n    address                             // '8888 Cummings Vista Apt. 101, Susanbury, NY 95473'\n    country                             // 'Falkland Islands (Malvinas)'\n    latitude($min = -90, $max = 90)     // 77.147489\n    longitude($min = -180, $max = 180)  // 86.211205\n\n### `Faker\\Provider\\en_US\\PhoneNumber`\n\n    phoneNumber             // '201-886-0269 x3767'\n    tollFreePhoneNumber     // '(888) 937-7238'\n    e164PhoneNumber     // '+27113456789'\n\n### `Faker\\Provider\\en_US\\Company`\n\n    catchPhrase             // 'Monitored regional contingency'\n    bs                      // 'e-enable robust architectures'\n    company                 // 'Bogan-Treutel'\n    companySuffix           // 'and Sons'\n    jobTitle                // 'Cashier'\n\n### `Faker\\Provider\\en_US\\Text`\n\n    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.\"\n\n### `Faker\\Provider\\DateTime`\n\n    unixTime($max = 'now')                // 58781813\n    dateTime($max = 'now', $timezone = null) // DateTime('2008-04-25 08:37:17', 'UTC')\n    dateTimeAD($max = 'now', $timezone = null) // DateTime('1800-04-29 20:38:49', 'Europe/Paris')\n    iso8601($max = 'now')                 // '1978-12-09T10:10:29+0000'\n    date($format = 'Y-m-d', $max = 'now') // '1979-06-09'\n    time($format = 'H:i:s', $max = 'now') // '20:49:42'\n    dateTimeBetween($startDate = '-30 years', $endDate = 'now', $timezone = null) // DateTime('2003-03-15 02:00:49', 'Africa/Lagos')\n    dateTimeInInterval($startDate = '-30 years', $interval = '+ 5 days', $timezone = null) // DateTime('2003-03-15 02:00:49', 'Antartica/Vostok')\n    dateTimeThisCentury($max = 'now', $timezone = null)     // DateTime('1915-05-30 19:28:21', 'UTC')\n    dateTimeThisDecade($max = 'now', $timezone = null)      // DateTime('2007-05-29 22:30:48', 'Europe/Paris')\n    dateTimeThisYear($max = 'now', $timezone = null)        // DateTime('2011-02-27 20:52:14', 'Africa/Lagos')\n    dateTimeThisMonth($max = 'now', $timezone = null)       // DateTime('2011-10-23 13:46:23', 'Antarctica/Vostok')\n    amPm($max = 'now')                    // 'pm'\n    dayOfMonth($max = 'now')              // '04'\n    dayOfWeek($max = 'now')               // 'Friday'\n    month($max = 'now')                   // '06'\n    monthName($max = 'now')               // 'January'\n    year($max = 'now')                    // '1993'\n    century                               // 'VI'\n    timezone                              // 'Europe/Paris'\n\nMethods 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)`.\n\n### `Faker\\Provider\\Internet`\n\n    email                   // 'tkshlerin@collins.com'\n    safeEmail               // 'king.alford@example.org'\n    freeEmail               // 'bradley72@gmail.com'\n    companyEmail            // 'russel.durward@mcdermott.org'\n    freeEmailDomain         // 'yahoo.com'\n    safeEmailDomain         // 'example.org'\n    userName                // 'wade55'\n    password                // 'k\u0026|X+a45*2['\n    domainName              // 'wolffdeckow.net'\n    domainWord              // 'feeney'\n    tld                     // 'biz'\n    url                     // 'http://www.skilesdonnelly.biz/aut-accusantium-ut-architecto-sit-et.html'\n    slug                    // 'aut-repellat-commodi-vel-itaque-nihil-id-saepe-nostrum'\n    ipv4                    // '109.133.32.252'\n    localIpv4               // '10.242.58.8'\n    ipv6                    // '8e65:933d:22ee:a232:f1c1:2741:1f10:117c'\n    macAddress              // '43:85:B7:08:10:CA'\n\n### `Faker\\Provider\\UserAgent`\n\n    userAgent              // 'Mozilla/5.0 (Windows CE) AppleWebKit/5350 (KHTML, like Gecko) Chrome/13.0.888.0 Safari/5350'\n    chrome                 // 'Mozilla/5.0 (Macintosh; PPC Mac OS X 10_6_5) AppleWebKit/5312 (KHTML, like Gecko) Chrome/14.0.894.0 Safari/5312'\n    firefox                // 'Mozilla/5.0 (X11; Linuxi686; rv:7.0) Gecko/20101231 Firefox/3.6'\n    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'\n    opera                  // 'Opera/8.25 (Windows NT 5.1; en-US) Presto/2.9.188 Version/10.00'\n    internetExplorer       // 'Mozilla/5.0 (compatible; MSIE 7.0; Windows 98; Win 9x 4.90; Trident/3.0)'\n\n### `Faker\\Provider\\Payment`\n\n    creditCardType          // 'MasterCard'\n    creditCardNumber        // '4485480221084675'\n    creditCardExpirationDate // 04/13\n    creditCardExpirationDateString // '04/13'\n    creditCardDetails       // array('MasterCard', '4485480221084675', 'Aleksander Nowak', '04/13')\n    // Generates a random IBAN. Set $countryCode to null for a random country\n    iban($countryCode)      // 'IT31A8497112740YZ575DJ28BP4'\n    swiftBicNumber          // 'RZTIAT22263'\n\n### `Faker\\Provider\\Color`\n\n    hexcolor               // '#fa3cc2'\n    rgbcolor               // '0,255,122'\n    rgbColorAsArray        // array(0,255,122)\n    rgbCssColor            // 'rgb(0,255,122)'\n    safeColorName          // 'fuchsia'\n    colorName              // 'Gainsbor'\n    hslColor               // '340,50,20'\n    hslColorAsArray        // array(340,50,20)\n\n### `Faker\\Provider\\File`\n\n    fileExtension          // 'avi'\n    mimeType               // 'video/x-msvideo'\n    // Copy a random file from the source to the target directory and returns the fullpath or filename\n    file($sourceDir = '/tmp', $targetDir = '/tmp') // '/path/to/targetDir/13b73edae8443990be1aa8f1a483bc27.jpg'\n    file($sourceDir, $targetDir, false) // '13b73edae8443990be1aa8f1a483bc27.jpg'\n\n### `Faker\\Provider\\Image`\n\n    // Image generation provided by LoremPixel (http://lorempixel.com/)\n    imageUrl($width = 640, $height = 480) // 'http://lorempixel.com/640/480/'\n    imageUrl($width, $height, 'cats')     // 'http://lorempixel.com/800/600/cats/'\n    imageUrl($width, $height, 'cats', true, 'Faker') // 'http://lorempixel.com/800/400/cats/Faker'\n    imageUrl($width, $height, 'cats', true, 'Faker', true) // 'http://lorempixel.com/gray/800/400/cats/Faker/' Monochrome image\n    image($dir = '/tmp', $width = 640, $height = 480) // '/tmp/13b73edae8443990be1aa8f1a483bc27.jpg'\n    image($dir, $width, $height, 'cats')  // 'tmp/13b73edae8443990be1aa8f1a483bc27.jpg' it's a cat!\n    image($dir, $width, $height, 'cats', false) // '13b73edae8443990be1aa8f1a483bc27.jpg' it's a filename without path\n    image($dir, $width, $height, 'cats', true, false) // it's a no randomize images (default: `true`)\n    image($dir, $width, $height, 'cats', true, true, 'Faker') // 'tmp/13b73edae8443990be1aa8f1a483bc27.jpg' it's a cat with 'Faker' text. Default, `null`.\n\n### `Faker\\Provider\\Uuid`\n\n    uuid                   // '7e57d004-2b97-0e7a-b45f-5387367791cd'\n\n### `Faker\\Provider\\Barcode`\n\n    ean13          // '4006381333931'\n    ean8           // '73513537'\n    isbn13         // '9790404436093'\n    isbn10         // '4881416324'\n\n### `Faker\\Provider\\Miscellaneous`\n\n    boolean // false\n    boolean($chanceOfGettingTrue = 50) // true\n    md5           // 'de99a620c50f2990e87144735cd357e7'\n    sha1          // 'f08e7f04ca1a413807ebc47551a40a20a0b4de5c'\n    sha256        // '0061e4c60dac5c1d82db0135a42e00c89ae3a333e7c26485321f24348c7e98a5'\n    locale        // en_UK\n    countryCode   // UK\n    languageCode  // en\n    currencyCode  // EUR\n    emoji         // 😁\n\n### `Faker\\Provider\\Biased`\n\n    // get a random number between 10 and 20,\n    // with more chances to be close to 20\n    biasedNumberBetween($min = 10, $max = 20, $function = 'sqrt')\n\n### `Faker\\Provider\\HtmlLorem`\n\n    //Generate HTML document which is no more than 2 levels deep, and no more than 3 elements wide at any level.\n    randomHtml(2,3)   // \u003chtml\u003e\u003chead\u003e\u003ctitle\u003eAut illo dolorem et accusantium eum.\u003c/title\u003e\u003c/head\u003e\u003cbody\u003e\u003cform action=\"example.com\" method=\"POST\"\u003e\u003clabel for=\"username\"\u003esequi\u003c/label\u003e\u003cinput type=\"text\" id=\"username\"\u003e\u003clabel for=\"password\"\u003eet\u003c/label\u003e\u003cinput type=\"password\" id=\"password\"\u003e\u003c/form\u003e\u003cb\u003eId aut saepe non mollitia voluptas voluptas.\u003c/b\u003e\u003ctable\u003e\u003cthead\u003e\u003ctr\u003e\u003ctr\u003eNon consequatur.\u003c/tr\u003e\u003ctr\u003eIncidunt est.\u003c/tr\u003e\u003ctr\u003eAut voluptatem.\u003c/tr\u003e\u003ctr\u003eOfficia voluptas rerum quo.\u003c/tr\u003e\u003ctr\u003eAsperiores similique.\u003c/tr\u003e\u003c/tr\u003e\u003c/thead\u003e\u003ctbody\u003e\u003ctr\u003e\u003ctd\u003eSapiente dolorum dolorem sint laboriosam commodi qui.\u003c/td\u003e\u003ctd\u003eCommodi nihil nesciunt eveniet quo repudiandae.\u003c/td\u003e\u003ctd\u003eVoluptates explicabo numquam distinctio necessitatibus repellat.\u003c/td\u003e\u003ctd\u003eProvident ut doloremque nam eum modi aspernatur.\u003c/td\u003e\u003ctd\u003eIusto inventore.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eAnimi nihil ratione id mollitia libero ipsa quia tempore.\u003c/td\u003e\u003ctd\u003eVelit est officia et aut tenetur dolorem sed mollitia expedita.\u003c/td\u003e\u003ctd\u003eModi modi repudiandae pariatur voluptas rerum ea incidunt non molestiae eligendi eos deleniti.\u003c/td\u003e\u003ctd\u003eExercitationem voluptatibus dolor est iste quod molestiae.\u003c/td\u003e\u003ctd\u003eQuia reiciendis.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eInventore impedit exercitationem voluptatibus rerum cupiditate.\u003c/td\u003e\u003ctd\u003eQui.\u003c/td\u003e\u003ctd\u003eAliquam.\u003c/td\u003e\u003ctd\u003eAutem nihil aut et.\u003c/td\u003e\u003ctd\u003eDolor ut quia error.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eEnim facilis iusto earum et minus rerum assumenda quis quia.\u003c/td\u003e\u003ctd\u003eReprehenderit ut sapiente occaecati voluptatum dolor voluptatem vitae qui velit.\u003c/td\u003e\u003ctd\u003eQuod fugiat non.\u003c/td\u003e\u003ctd\u003eSunt nobis totam mollitia sed nesciunt est deleniti cumque.\u003c/td\u003e\u003ctd\u003eRepudiandae quo.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eModi dicta libero quisquam doloremque qui autem.\u003c/td\u003e\u003ctd\u003eVoluptatem aliquid saepe laudantium facere eos sunt dolor.\u003c/td\u003e\u003ctd\u003eEst eos quis laboriosam officia expedita repellendus quia natus.\u003c/td\u003e\u003ctd\u003eEt neque delectus quod fugit enim repudiandae qui.\u003c/td\u003e\u003ctd\u003eFugit soluta sit facilis facere repellat culpa magni voluptatem maiores tempora.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eEnim dolores doloremque.\u003c/td\u003e\u003ctd\u003eAssumenda voluptatem eum perferendis exercitationem.\u003c/td\u003e\u003ctd\u003eQuasi in fugit deserunt ea perferendis sunt nemo consequatur dolorum soluta.\u003c/td\u003e\u003ctd\u003eMaxime repellat qui numquam voluptatem est modi.\u003c/td\u003e\u003ctd\u003eAlias rerum rerum hic hic eveniet.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eTempore voluptatem.\u003c/td\u003e\u003ctd\u003eEaque.\u003c/td\u003e\u003ctd\u003eEt sit quas fugit iusto.\u003c/td\u003e\u003ctd\u003eNemo nihil rerum dignissimos et esse.\u003c/td\u003e\u003ctd\u003eRepudiandae ipsum numquam.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eNemo sunt quia.\u003c/td\u003e\u003ctd\u003eSint tempore est neque ducimus harum sed.\u003c/td\u003e\u003ctd\u003eDicta placeat atque libero nihil.\u003c/td\u003e\u003ctd\u003eEt qui aperiam temporibus facilis eum.\u003c/td\u003e\u003ctd\u003eUt dolores qui enim et maiores nesciunt.\u003c/td\u003e\u003c/tr\u003e\u003ctr\u003e\u003ctd\u003eDolorum totam sint debitis saepe laborum.\u003c/td\u003e\u003ctd\u003eQuidem corrupti ea.\u003c/td\u003e\u003ctd\u003eCum voluptas quod.\u003c/td\u003e\u003ctd\u003ePossimus consequatur quasi dolorem ut et.\u003c/td\u003e\u003ctd\u003eEt velit non hic labore repudiandae quis.\u003c/td\u003e\u003c/tr\u003e\u003c/tbody\u003e\u003c/table\u003e\u003c/body\u003e\u003c/html\u003e\n\n## Modifiers\n\nFaker provides three special providers, `unique()`, `optional()`, and `valid()`, to be called before any provider.\n\n```php\n// unique() forces providers to return unique values\n$values = array();\nfor ($i = 0; $i \u003c 10; $i++) {\n  // get a random digit, but always a new one, to avoid duplicates\n  $values []= $faker-\u003eunique()-\u003erandomDigit;\n}\nprint_r($values); // [4, 1, 8, 5, 0, 2, 6, 9, 7, 3]\n\n// providers with a limited range will throw an exception when no new unique value can be generated\n$values = array();\ntry {\n  for ($i = 0; $i \u003c 10; $i++) {\n    $values []= $faker-\u003eunique()-\u003erandomDigitNotNull;\n  }\n} catch (\\OverflowException $e) {\n  echo \"There are only 9 unique digits not null, Faker can't generate 10 of them!\";\n}\n\n// you can reset the unique modifier for all providers by passing true as first argument\n$faker-\u003eunique($reset = true)-\u003erandomDigitNotNull; // will not throw OverflowException since unique() was reset\n// tip: unique() keeps one array of values per provider\n\n// optional() sometimes bypasses the provider to return a default value instead (which defaults to NULL)\n$values = array();\nfor ($i = 0; $i \u003c 10; $i++) {\n  // get a random digit, but also null sometimes\n  $values []= $faker-\u003eoptional()-\u003erandomDigit;\n}\nprint_r($values); // [1, 4, null, 9, 5, null, null, 4, 6, null]\n\n// optional() accepts a weight argument to specify the probability of receiving the default value.\n// 0 will always return the default value; 1 will always return the provider. Default weight is 0.5 (50% chance).\n$faker-\u003eoptional($weight = 0.1)-\u003erandomDigit; // 90% chance of NULL\n$faker-\u003eoptional($weight = 0.9)-\u003erandomDigit; // 10% chance of NULL\n\n// optional() accepts a default argument to specify the default value to return.\n// Defaults to NULL.\n$faker-\u003eoptional($weight = 0.5, $default = false)-\u003erandomDigit; // 50% chance of FALSE\n$faker-\u003eoptional($weight = 0.9, $default = 'abc')-\u003eword; // 10% chance of 'abc'\n\n// valid() only accepts valid values according to the passed validator functions\n$values = array();\n$evenValidator = function($digit) {\n\treturn $digit % 2 === 0;\n};\nfor ($i = 0; $i \u003c 10; $i++) {\n\t$values []= $faker-\u003evalid($evenValidator)-\u003erandomDigit;\n}\nprint_r($values); // [0, 4, 8, 4, 2, 6, 0, 8, 8, 6]\n\n// just like unique(), valid() throws an overflow exception when it can't generate a valid value\n$values = array();\ntry {\n  $faker-\u003evalid($evenValidator)-\u003erandomElement([1, 3, 5, 7, 9]);\n} catch (\\OverflowException $e) {\n  echo \"Can't pick an even number in that set!\";\n}\n```\n\nIf 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.\n\n```php\n$faker-\u003eoptional()-\u003epassthrough(mt_rand(5, 15));\n```\n\n## Localization\n\n`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).\n\n```php\n\u003c?php\n$faker = Faker\\Factory::create('fr_FR'); // create a French faker\nfor ($i = 0; $i \u003c 10; $i++) {\n  echo $faker-\u003ename, \"\\n\";\n}\n  // Luce du Coulon\n  // Auguste Dupont\n  // Roger Le Voisin\n  // Alexandre Lacroix\n  // Jacques Humbert-Roy\n  // Thérèse Guillet-Andre\n  // Gilles Gros-Bodin\n  // Amélie Pires\n  // Marcel Laporte\n  // Geneviève Marchal\n```\n\nYou can check available Faker locales in the source code, [under the `Provider` directory](https://github.com/fzaninotto/Faker/tree/master/src/Faker/Provider). 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!\n\n## Populating Entities Using an ORM or an ODM\n\nFaker 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).\n\nTo 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.\n\nNote that some of the `populators` could require additional parameters. As example the `doctrine` populator has an option to specify\nits batchSize on how often it will flush the UnitOfWork to the database.\n\nHere is an example showing how to populate 5 `Author` and 10 `Book` objects:\n\n```php\n\u003c?php\n$generator = \\Faker\\Factory::create();\n$populator = new \\Faker\\ORM\\Propel\\Populator($generator);\n$populator-\u003eaddEntity('Author', 5);\n$populator-\u003eaddEntity('Book', 10);\n$insertedPKs = $populator-\u003eexecute();\n```\n\nThe 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()`:\n\n```php\n\u003c?php\n$populator-\u003eaddEntity('Book', 5, array(\n  'ISBN' =\u003e function() use ($generator) { return $generator-\u003eean13(); }\n));\n```\n\nIn this example, Faker will guess a formatter for all columns except `ISBN`, for which the given anonymous function will be used.\n\n**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:\n\n```php\n\u003c?php\n$populator-\u003eaddEntity('Book', 5, array(\n  'CreatedAt' =\u003e null,\n  'UpdatedAt' =\u003e null,\n));\n```\n\nOf course, Faker does not populate autoincremented primary keys. In addition, `Faker\\ORM\\Propel\\Populator::execute()` returns the list of inserted PKs, indexed by class:\n\n```php\n\u003c?php\nprint_r($insertedPKs);\n// array(\n//   'Author' =\u003e (34, 35, 36, 37, 38),\n//   'Book'   =\u003e (456, 457, 458, 459, 470, 471, 472, 473, 474, 475)\n// )\n```\n\n**Note:** Due to the fact that `Faker` returns all the primary keys inserted, the memory consumption will go up drastically when you do batch inserts due to the big list of data.\n\nIn 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.\n\nLastly, if you want to execute an arbitrary function on an entity before insertion, use the fourth argument of the `addEntity()` method:\n\n```php\n\u003c?php\n$populator-\u003eaddEntity('Book', 5, array(), array(\n  function($book) { $book-\u003epublish(); },\n));\n```\n\n## Seeding the Generator\n\nYou 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.\n\n```php\n\u003c?php\n$faker = Faker\\Factory::create();\n$faker-\u003eseed(1234);\n\necho $faker-\u003ename; // 'Jess Mraz I';\n```\n\n\u003e **Tip**: DateTime formatters won't reproduce the same fake data if you don't fix the `$max` value:\n\u003e\n\u003e ```php\n\u003e \u003c?php\n\u003e // even when seeded, this line will return different results because $max varies\n\u003e $faker-\u003edateTime(); // equivalent to $faker-\u003edateTime($max = 'now')\n\u003e // make sure you fix the $max parameter\n\u003e $faker-\u003edateTime('2014-02-25 08:37:17'); // will return always the same date when seeded\n\u003e ```\n\u003e\n\u003e **Tip**: Formatters won't reproduce the same fake data if you use the `rand()` php function. Use `$faker` or `mt_rand()` instead:\n\u003e\n\u003e ```php\n\u003e \u003c?php\n\u003e // bad\n\u003e $faker-\u003erealText(rand(10,20));\n\u003e // good\n\u003e $faker-\u003erealText($faker-\u003enumberBetween(10,20));\n\u003e ```\n\n\n\n## Faker Internals: Understanding Providers\n\nA `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:\n\n```php\n\u003c?php\n$faker = new Faker\\Generator();\n$faker-\u003eaddProvider(new Faker\\Provider\\en_US\\Person($faker));\n$faker-\u003eaddProvider(new Faker\\Provider\\en_US\\Address($faker));\n$faker-\u003eaddProvider(new Faker\\Provider\\en_US\\PhoneNumber($faker));\n$faker-\u003eaddProvider(new Faker\\Provider\\en_US\\Company($faker));\n$faker-\u003eaddProvider(new Faker\\Provider\\Lorem($faker));\n$faker-\u003eaddProvider(new Faker\\Provider\\Internet($faker));\n````\n\nWhenever 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-\u003ename` 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.\n\nThat 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.\n\nHere is an example provider for populating Book data:\n\n```php\n\u003c?php\n\nnamespace Faker\\Provider;\n\nclass Book extends \\Faker\\Provider\\Base\n{\n  public function title($nbWords = 5)\n  {\n    $sentence = $this-\u003egenerator-\u003esentence($nbWords);\n    return substr($sentence, 0, strlen($sentence) - 1);\n  }\n\n  public function ISBN()\n  {\n    return $this-\u003egenerator-\u003eean13();\n  }\n}\n```\n\nTo register this provider, just add a new instance of `\\Faker\\Provider\\Book` to an existing generator:\n\n```php\n\u003c?php\n$faker-\u003eaddProvider(new \\Faker\\Provider\\Book($faker));\n```\n\nNow you can use the two new formatters like any other Faker formatter:\n\n```php\n\u003c?php\n$book = new Book();\n$book-\u003esetTitle($faker-\u003etitle);\n$book-\u003esetISBN($faker-\u003eISBN);\n$book-\u003esetSummary($faker-\u003etext);\n$book-\u003esetPrice($faker-\u003erandomNumber(2));\n```\n\n**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.\n\n## Real Life Usage\n\nThe following script generates a valid XML document:\n\n```php\n\u003c?php\nrequire_once '/path/to/Faker/src/autoload.php';\n$faker = Faker\\Factory::create();\n?\u003e\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003ccontacts\u003e\n\u003c?php for ($i = 0; $i \u003c 10; $i++): ?\u003e\n  \u003ccontact firstName=\"\u003c?php echo $faker-\u003efirstName ?\u003e\" lastName=\"\u003c?php echo $faker-\u003elastName ?\u003e\" email=\"\u003c?php echo $faker-\u003eemail ?\u003e\"\u003e\n    \u003cphone number=\"\u003c?php echo $faker-\u003ephoneNumber ?\u003e\"/\u003e\n\u003c?php if ($faker-\u003eboolean(25)): ?\u003e\n    \u003cbirth date=\"\u003c?php echo $faker-\u003edateTimeThisCentury-\u003eformat('Y-m-d') ?\u003e\" place=\"\u003c?php echo $faker-\u003ecity ?\u003e\"/\u003e\n\u003c?php endif; ?\u003e\n    \u003caddress\u003e\n      \u003cstreet\u003e\u003c?php echo $faker-\u003estreetAddress ?\u003e\u003c/street\u003e\n      \u003ccity\u003e\u003c?php echo $faker-\u003ecity ?\u003e\u003c/city\u003e\n      \u003cpostcode\u003e\u003c?php echo $faker-\u003epostcode ?\u003e\u003c/postcode\u003e\n      \u003cstate\u003e\u003c?php echo $faker-\u003estate ?\u003e\u003c/state\u003e\n    \u003c/address\u003e\n    \u003ccompany name=\"\u003c?php echo $faker-\u003ecompany ?\u003e\" catchPhrase=\"\u003c?php echo $faker-\u003ecatchPhrase ?\u003e\"\u003e\n\u003c?php if ($faker-\u003eboolean(33)): ?\u003e\n      \u003coffer\u003e\u003c?php echo $faker-\u003ebs ?\u003e\u003c/offer\u003e\n\u003c?php endif; ?\u003e\n\u003c?php if ($faker-\u003eboolean(33)): ?\u003e\n      \u003cdirector name=\"\u003c?php echo $faker-\u003ename ?\u003e\" /\u003e\n\u003c?php endif; ?\u003e\n    \u003c/company\u003e\n\u003c?php if ($faker-\u003eboolean(15)): ?\u003e\n    \u003cdetails\u003e\n\u003c![CDATA[\n\u003c?php echo $faker-\u003etext(400) ?\u003e\n]]\u003e\n    \u003c/details\u003e\n\u003c?php endif; ?\u003e\n  \u003c/contact\u003e\n\u003c?php endfor; ?\u003e\n\u003c/contacts\u003e\n```\n\nRunning this script produces a document looking like:\n\n```xml\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003ccontacts\u003e\n  \u003ccontact firstName=\"Ona\" lastName=\"Bednar\" email=\"schamberger.frank@wuckert.com\"\u003e\n    \u003cphone number=\"1-265-479-1196x714\"/\u003e\n    \u003caddress\u003e\n      \u003cstreet\u003e182 Harrison Cove\u003c/street\u003e\n      \u003ccity\u003eNorth Lloyd\u003c/city\u003e\n      \u003cpostcode\u003e45577\u003c/postcode\u003e\n      \u003cstate\u003eAlabama\u003c/state\u003e\n    \u003c/address\u003e\n    \u003ccompany name=\"Veum, Funk and Shanahan\" catchPhrase=\"Function-based stable solution\"\u003e\n      \u003coffer\u003eorchestrate compelling web-readiness\u003c/offer\u003e\n    \u003c/company\u003e\n    \u003cdetails\u003e\n\u003c![CDATA[\nAlias accusantium voluptatum autem nobis cumque neque modi. Voluptatem error molestiae consequatur alias.\nIllum commodi molestiae aut repellat id. Et sit consequuntur aut et ullam asperiores. Cupiditate culpa voluptatem et mollitia dolor. Nisi praesentium qui ut.\n]]\u003e\n    \u003c/details\u003e\n  \u003c/contact\u003e\n  \u003ccontact firstName=\"Aurelie\" lastName=\"Paucek\" email=\"alfonzo55@durgan.com\"\u003e\n    \u003cphone number=\"863.712.1363x9425\"/\u003e\n    \u003caddress\u003e\n      \u003cstreet\u003e90111 Hegmann Inlet\u003c/street\u003e\n      \u003ccity\u003eSouth Geovanymouth\u003c/city\u003e\n      \u003cpostcode\u003e69961-9311\u003c/postcode\u003e\n      \u003cstate\u003eColorado\u003c/state\u003e\n    \u003c/address\u003e\n    \u003ccompany name=\"Krajcik-Grimes\" catchPhrase=\"Switchable cohesive instructionset\"\u003e\n    \u003c/company\u003e\n  \u003c/contact\u003e\n  \u003ccontact firstName=\"Clifton\" lastName=\"Kshlerin\" email=\"kianna.wiegand@framiwyman.info\"\u003e\n    \u003cphone number=\"692-194-4746\"/\u003e\n    \u003caddress\u003e\n      \u003cstreet\u003e9791 Nona Corner\u003c/street\u003e\n      \u003ccity\u003eHarberhaven\u003c/city\u003e\n      \u003cpostcode\u003e74062-8191\u003c/postcode\u003e\n      \u003cstate\u003eRhodeIsland\u003c/state\u003e\n    \u003c/address\u003e\n    \u003ccompany name=\"Rosenbaum-Aufderhar\" catchPhrase=\"Realigned asynchronous encryption\"\u003e\n    \u003c/company\u003e\n  \u003c/contact\u003e\n  \u003ccontact firstName=\"Alexandre\" lastName=\"Orn\" email=\"thelma37@erdmancorwin.biz\"\u003e\n    \u003cphone number=\"189.655.8677x027\"/\u003e\n    \u003caddress\u003e\n      \u003cstreet\u003e11161 Schultz Via\u003c/street\u003e\n      \u003ccity\u003eFeilstad\u003c/city\u003e\n      \u003cpostcode\u003e98019\u003c/postcode\u003e\n      \u003cstate\u003eNewJersey\u003c/state\u003e\n    \u003c/address\u003e\n    \u003ccompany name=\"O'Hara-Prosacco\" catchPhrase=\"Re-engineered solution-oriented algorithm\"\u003e\n      \u003cdirector name=\"Dr. Berenice Auer V\" /\u003e\n    \u003c/company\u003e\n    \u003cdetails\u003e\n\u003c![CDATA[\nUt itaque et quaerat doloremque eum praesentium. Rerum in saepe dolorem. Explicabo qui consequuntur commodi minima rem.\nHarum temporibus rerum dolores. Non molestiae id dolorem placeat.\nAut asperiores nihil eius repellendus. Vero nihil corporis voluptatem explicabo commodi. Occaecati omnis blanditiis beatae quod aspernatur eos.\n]]\u003e\n    \u003c/details\u003e\n  \u003c/contact\u003e\n  \u003ccontact firstName=\"Katelynn\" lastName=\"Kohler\" email=\"reinger.trudie@stiedemannjakubowski.com\"\u003e\n    \u003cphone number=\"(665)713-1657\"/\u003e\n    \u003caddress\u003e\n      \u003cstreet\u003e6106 Nader Village Suite 753\u003c/street\u003e\n      \u003ccity\u003eMcLaughlinstad\u003c/city\u003e\n      \u003cpostcode\u003e43189-8621\u003c/postcode\u003e\n      \u003cstate\u003eMissouri\u003c/state\u003e\n    \u003c/address\u003e\n    \u003ccompany name=\"Herman-Tremblay\" catchPhrase=\"Object-based explicit service-desk\"\u003e\n      \u003coffer\u003eexpedite viral synergies\u003c/offer\u003e\n      \u003cdirector name=\"Arden Deckow\" /\u003e\n    \u003c/company\u003e\n  \u003c/contact\u003e\n  \u003ccontact firstName=\"Blanca\" lastName=\"Stark\" email=\"tad27@feest.net\"\u003e\n    \u003cphone number=\"168.719.4692x87177\"/\u003e\n    \u003caddress\u003e\n      \u003cstreet\u003e7546 Kuvalis Plaza\u003c/street\u003e\n      \u003ccity\u003eSouth Wilfrid\u003c/city\u003e\n      \u003cpostcode\u003e77069\u003c/postcode\u003e\n      \u003cstate\u003eGeorgia\u003c/state\u003e\n    \u003c/address\u003e\n    \u003ccompany name=\"Upton, Braun and Rowe\" catchPhrase=\"Visionary leadingedge pricingstructure\"\u003e\n    \u003c/company\u003e\n  \u003c/contact\u003e\n  \u003ccontact firstName=\"Rene\" lastName=\"Spencer\" email=\"anibal28@armstrong.info\"\u003e\n    \u003cphone number=\"715.222.0095x175\"/\u003e\n    \u003cbirth date=\"2008-08-07\" place=\"Zulaufborough\"/\u003e\n    \u003caddress\u003e\n      \u003cstreet\u003e478 Daisha Landing Apt. 510\u003c/street\u003e\n      \u003ccity\u003eWest Lizethhaven\u003c/city\u003e\n      \u003cpostcode\u003e30566-5362\u003c/postcode\u003e\n      \u003cstate\u003eWestVirginia\u003c/state\u003e\n    \u003c/address\u003e\n    \u003ccompany name=\"Wiza Inc\" catchPhrase=\"Persevering reciprocal approach\"\u003e\n      \u003coffer\u003eorchestrate dynamic networks\u003c/offer\u003e\n      \u003cdirector name=\"Erwin Nienow\" /\u003e\n    \u003c/company\u003e\n    \u003cdetails\u003e\n\u003c![CDATA[\nDolorem consequatur voluptates unde optio unde. Accusantium dolorem est est architecto impedit. Corrupti et provident quo.\nReprehenderit dolores aut quidem suscipit repudiandae corporis error. Molestiae enim aperiam illo.\nEt similique qui non expedita quia dolorum. Ex rem incidunt ea accusantium temporibus minus non.\n]]\u003e\n    \u003c/details\u003e\n  \u003c/contact\u003e\n  \u003ccontact firstName=\"Alessandro\" lastName=\"Hagenes\" email=\"tbreitenberg@oharagorczany.com\"\u003e\n    \u003cphone number=\"1-284-958-6768\"/\u003e\n    \u003caddress\u003e\n      \u003cstreet\u003e1251 Koelpin Mission\u003c/street\u003e\n      \u003ccity\u003eNorth Revastad\u003c/city\u003e\n      \u003cpostcode\u003e81620\u003c/postcode\u003e\n      \u003cstate\u003eMaryland\u003c/state\u003e\n    \u003c/address\u003e\n    \u003ccompany name=\"Stiedemann-Bruen\" catchPhrase=\"Re-engineered 24/7 success\"\u003e\n    \u003c/company\u003e\n  \u003c/contact\u003e\n  \u003ccontact firstName=\"Novella\" lastName=\"Rutherford\" email=\"claud65@bogisich.biz\"\u003e\n    \u003cphone number=\"(091)825-7971\"/\u003e\n    \u003caddress\u003e\n      \u003cstreet\u003e6396 Langworth Hills Apt. 446\u003c/street\u003e\n      \u003ccity\u003eNew Carlos\u003c/city\u003e\n      \u003cpostcode\u003e89399-0268\u003c/postcode\u003e\n      \u003cstate\u003eWyoming\u003c/state\u003e\n    \u003c/address\u003e\n    \u003ccompany name=\"Stroman-Legros\" catchPhrase=\"Expanded 4thgeneration moratorium\"\u003e\n      \u003cdirector name=\"Earlene Bayer\" /\u003e\n    \u003c/company\u003e\n  \u003c/contact\u003e\n  \u003ccontact firstName=\"Andreane\" lastName=\"Mann\" email=\"meggie17@ornbaumbach.com\"\u003e\n    \u003cphone number=\"941-659-9982x5689\"/\u003e\n    \u003cbirth date=\"1934-02-21\" place=\"Stantonborough\"/\u003e\n    \u003caddress\u003e\n      \u003cstreet\u003e2246 Kreiger Station Apt. 291\u003c/street\u003e\n      \u003ccity\u003eKaydenmouth\u003c/city\u003e\n      \u003cpostcode\u003e11397-1072\u003c/postcode\u003e\n      \u003cstate\u003eWyoming\u003c/state\u003e\n    \u003c/address\u003e\n    \u003ccompany name=\"Lebsack, Bernhard and Kiehn\" catchPhrase=\"Persevering actuating framework\"\u003e\n      \u003coffer\u003egrow sticky portals\u003c/offer\u003e\n    \u003c/company\u003e\n    \u003cdetails\u003e\n\u003c![CDATA[\nQuia 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.\nFugiat non in itaque sunt nobis totam. Sed nesciunt est deleniti cumque alias. Repudiandae quo aut numquam modi dicta libero.\n]]\u003e\n    \u003c/details\u003e\n  \u003c/contact\u003e\n\u003c/contacts\u003e\n```\n\n## Language specific formatters\n\n### `Faker\\Provider\\ar_SA\\Person`\n\n```php\n\u003c?php\n\necho $faker-\u003eidNumber;      // ID number\necho $faker-\u003enationalIdNumber // Citizen ID number\necho $faker-\u003eforeignerIdNumber // Foreigner ID number\necho $faker-\u003ecompanyIdNumber // Company ID number\n```\n\n### `Faker\\Provider\\ar_SA\\Payment`\n\n```php\n\u003c?php\n\necho $faker-\u003ebankAccountNumber // \"SA0218IBYZVZJSEC8536V4XC\"\n```\n\n### `Faker\\Provider\\at_AT\\Payment`\n\n```php\n\u003c?php\n\necho $faker-\u003evat;           // \"AT U12345678\" - Austrian Value Added Tax number\necho $faker-\u003evat(false);    // \"ATU12345678\" - unspaced Austrian Value Added Tax number\n```\n\n### `Faker\\Provider\\bg_BG\\Payment`\n\n```php\n\u003c?php\n\necho $faker-\u003evat;           // \"BG 0123456789\" - Bulgarian Value Added Tax number\necho $faker-\u003evat(false);    // \"BG0123456789\" - unspaced Bulgarian Value Added Tax number\n```\n\n### `Faker\\Provider\\cs_CZ\\Address`\n\n```php\n\u003c?php\n\necho $faker-\u003eregion; // \"Liberecký kraj\"\n```\n\n### `Faker\\Provider\\cs_CZ\\Company`\n\n```php\n\u003c?php\n\n// Generates a valid IČO\necho $faker-\u003eico; // \"69663963\"\n```\n\n### `Faker\\Provider\\cs_CZ\\DateTime`\n\n```php\n\u003c?php\n\necho $faker-\u003emonthNameGenitive; // \"prosince\"\necho $faker-\u003eformattedDate; // \"12. listopadu 2015\"\n```\n\n### `Faker\\Provider\\cs_CZ\\Person`\n\n```php\n\u003c?php\n\necho $faker-\u003ebirthNumber; // \"7304243452\"\n```\n\n### `Faker\\Provider\\da_DK\\Person`\n\n```php\n\u003c?php\n\n// Generates a random CPR number\necho $faker-\u003ecpr; // \"051280-2387\"\n```\n\n### `Faker\\Provider\\da_DK\\Address`\n\n```php\n\u003c?php\n\n// Generates a random 'kommune' name\necho $faker-\u003ekommune; // \"Frederiksberg\"\n\n// Generates a random region name\necho $faker-\u003eregion; // \"Region Sjælland\"\n```\n\n### `Faker\\Provider\\da_DK\\Company`\n\n```php\n\u003c?php\n\n// Generates a random CVR number\necho $faker-\u003ecvr; // \"32458723\"\n\n// Generates a random P number\necho $faker-\u003ep; // \"5398237590\"\n```\n\n### `Faker\\Provider\\de_CH\\Person`\n```php\n\u003c?php\n\n// Generates a random AVS13/AHV13 social security number\necho $faker-\u003eavs13; // \"756.1234.5678.97\" OR\necho $faker-\u003eahv13; // \"756.1234.5678.97\"\n```\n\n### `Faker\\Provider\\de_DE\\Payment`\n\n```php\n\u003c?php\n\necho $faker-\u003ebankAccountNumber; // \"DE41849025553661169313\"\necho $faker-\u003ebank; // \"Volksbank Stuttgart\"\n\n```\n\n### `Faker\\Provider\\en_HK\\Address`\n\n```php\n\u003c?php\n\n// Generates a fake town name based on the words commonly found in Hong Kong\necho $faker-\u003etown; // \"Yuen Long\"\n\n// Generates a fake village name based on the words commonly found in Hong Kong\necho $faker-\u003evillage; // \"O Tau\"\n\n// Generates a fake estate name based on the words commonly found in Hong Kong\necho $faker-\u003eestate; // \"Ching Lai Court\"\n\n```\n\n### `Faker\\Provider\\en_HK\\Phone`\n\n```php\n\u003c?php\n\n// Generates a Hong Kong mobile number (starting with 5, 6 or 9)\necho $faker-\u003emobileNumber; // \"92150087\"\n\n// Generates a Hong Kong landline number (starting with 2 or 3)\necho $faker-\u003elandlineNumber; // \"32750132\"\n\n// Generates a Hong Kong fax number (starting with 7)\necho $faker-\u003efaxNumber; // \"71937729\"\n\n```\n\n### `Faker\\Provider\\en_NG\\Address`\n\n```php\n\u003c?php\n\n// Generates a random region name\necho $faker-\u003eregion; // 'Katsina'\n```\n\n### `Faker\\Provider\\en_NG\\Person`\n\n```php\n\u003c?php\n\n// Generates a random person name\necho $faker-\u003ename; // 'Oluwunmi Mayowa'\n```\n\n### `Faker\\Provider\\en_NZ\\Phone`\n\n```php\n\u003c?php\n\n// Generates a cell (mobile) phone number\necho $faker-\u003emobileNumber; // \"021 123 4567\"\n\n// Generates a toll free number\necho $faker-\u003etollFreeNumber; // \"0800 123 456\"\n\n// Area Code\necho $faker-\u003eareaCode; // \"03\"\n```\n\n### `Faker\\Provider\\en_US\\Company`\n\n```php\n\u003c?php\n\n// Generate a random Employer Identification Number\necho $faker-\u003eein; // '12-3456789'\n```\n\n### `Faker\\Provider\\en_US\\Payment`\n\n```php\n\u003c?php\n\necho $faker-\u003ebankAccountNumber;  // '51915734310'\necho $faker-\u003ebankRoutingNumber;  // '212240302'\n```\n\n### `Faker\\Provider\\en_US\\Person`\n\n```php\n\u003c?php\n\n// Generates a random Social Security Number\necho $faker-\u003essn; // '123-45-6789'\n```\n\n### `Faker\\Provider\\en_ZA\\Company`\n\n```php\n\u003c?php\n\n// Generates a random company registration number\necho $faker-\u003ecompanyNumber; // 1999/789634/01\n```\n\n### `Faker\\Provider\\en_ZA\\Person`\n\n```php\n\u003c?php\n\n// Generates a random national identification number\necho $faker-\u003eidNumber; // 6606192211041\n\n// Generates a random valid licence code\necho $faker-\u003elicenceCode; // EB\n```\n\n### `Faker\\Provider\\en_ZA\\PhoneNumber`\n\n```php\n\u003c?php\n\n// Generates a special rate toll free phone number\necho $faker-\u003etollFreeNumber; // 0800 555 5555\n\n// Generates a mobile phone number\necho $faker-\u003emobileNumber; // 082 123 5555\n```\n\n### `Faker\\Provider\\es_ES\\Person`\n\n```php\n\u003c?php\n\n// Generates a Documento Nacional de Identidad (DNI) number\necho $faker-\u003edni; // '77446565E'\n\n// Generates a random valid licence code\necho $faker-\u003elicenceCode; // B\n```\n\n### `Faker\\Provider\\es_ES\\Payment`\n\n```php\n\u003c?php\n// Generates a Código de identificación Fiscal (CIF) number\necho $faker-\u003evat;           // \"A35864370\"\n```\n\n### `Faker\\Provider\\es_ES\\PhoneNumber`\n\n```php\n\u003c?php\n\n// Generates a special rate toll free phone number\necho $faker-\u003etollFreeNumber; // 900 123 456\n\n// Generates a mobile phone number\necho $faker-\u003emobileNumber; // +34 612 12 24\n```\n\n### `Faker\\Provider\\es_PE\\Person`\n\n```php\n\u003c?php\n\n// Generates a Peruvian Documento Nacional de Identidad (DNI) number\necho $faker-\u003edni; // '83367512'\n```\n\n### `Faker\\Provider\\fa_IR\\Person`\n\n```php\n\u003c?php\n\n// Generates a valid nationalCode\necho $faker-\u003enationalCode; // \"0078475759\"\n```\n\n### `Faker\\Provider\\fa_IR\\Address`\n\n```php\n\u003c?php\n\n// Generates a random building name\necho $faker-\u003ebuilding; // \"ساختمان آفتاب\"\n\n// Returns a random city name\necho $faker-\u003ecity // \"استان زنجان\"\n```\n\n### `Faker\\Provider\\fa_IR\\Company`\n\n```php\n\u003c?php\n\n// Generates a random contract type\necho $faker-\u003econtract; // \"رسمی\"\n```\n\n### `Faker\\Provider\\fi_FI\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random bank account number\necho $faker-\u003ebankAccountNumber; // \"FI8350799879879616\"\n```\n\n### `Faker\\Provider\\fi_FI\\Person`\n\n```php\n\u003c?php\n\n//Generates a valid Finnish personal identity number (in Finnish - Henkilötunnus)\necho $faker-\u003epersonalIdentityNumber() // '170974-007J'\n\n//Since the numbers are different for male and female persons, optionally you can specify gender.\necho $faker-\u003epersonalIdentityNumber(\\DateTime::createFromFormat('Y-m-d', '2015-12-14'), 'female') // '141215A520B'\n```\n\n### `Faker\\Provider\\fr_BE\\Payment`\n\n```php\n\u003c?php\n\necho $faker-\u003evat;           // \"BE 0123456789\" - Belgian Value Added Tax number\necho $faker-\u003evat(false);    // \"BE0123456789\" - unspaced Belgian Value Added Tax number\n```\n\n### `Faker\\Provider\\es_VE\\Person`\n\n```php\n\u003c?php\n\n// Generate a Cédula de identidad number, you can pass one argument to add separator\necho $faker-\u003enationalId; // 'V11223344'\n```\n\n### `Faker\\Provider\\es_VE\\Company`\n\n```php\n\u003c?php\n\n// Generates a R.I.F. number, you can pass one argument to add separators\necho $faker-\u003etaxpayerIdentificationNumber; // 'J1234567891'\n```\n\n### `Faker\\Provider\\fr_CH\\Person`\n```php\n\u003c?php\n\n// Generates a random AVS13/AHV13 social security number\necho $faker-\u003eavs13; // \"756.1234.5678.97\"\n```\n\n### `Faker\\Provider\\fr_FR\\Address`\n\n```php\n\u003c?php\n\n// Generates a random department name\necho $faker-\u003edepartmentName; // \"Haut-Rhin\"\n\n// Generates a random department number\necho $faker-\u003edepartmentNumber; // \"2B\"\n\n// Generates a random department info (department number =\u003e department name)\n$faker-\u003edepartment; // array('18' =\u003e 'Cher');\n\n// Generates a random region\necho $faker-\u003eregion; // \"Saint-Pierre-et-Miquelon\"\n\n// Generates a random appartement,stair\necho $faker-\u003esecondaryAddress; // \"Bat. 961\"\n```\n\n### `Faker\\Provider\\fr_FR\\Company`\n\n```php\n\u003c?php\n\n// Generates a random SIREN number\necho $faker-\u003esiren; // 082 250 104\n\n// Generates a random SIRET number\necho $faker-\u003esiret; // 347 355 708 00224\n```\n\n### `Faker\\Provider\\fr_FR\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random VAT\necho $faker-\u003evat; // FR 12 123 456 789\n```\n\n### `Faker\\Provider\\fr_FR\\Person`\n\n```php\n\u003c?php\n\n// Generates a random NIR / Sécurité Sociale number\necho $faker-\u003enir; // 1 88 07 35 127 571 - 19\n```\n\n### `Faker\\Provider\\fr_FR\\PhoneNumber`\n\n```php\n\u003c?php\n\n// Generates phone numbers\necho $faker-\u003ephoneNumber; // +33 (0)1 67 97 01 31\necho $faker-\u003emobileNumber; // +33 6 21 12 72 84\necho $faker-\u003eserviceNumber // 08 98 04 84 46\n```\n\n\n### `Faker\\Provider\\he_IL\\Payment`\n\n```php\n\u003c?php\n\necho $faker-\u003ebankAccountNumber // \"IL392237392219429527697\"\n```\n\n### `Faker\\Provider\\hr_HR\\Payment`\n\n```php\n\u003c?php\n\necho $faker-\u003ebankAccountNumber // \"HR3789114847226078672\"\n```\n\n### `Faker\\Provider\\hu_HU\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random bank account number\necho $faker-\u003ebankAccountNumber; // \"HU09904437680048220079300783\"\n```\n\n### `Faker\\Provider\\id_ID\\Person`\n\n```php\n\u003c?php\n\n// Generates a random Nomor Induk Kependudukan (NIK)\n\n// first argument is gender, either Person::GENDER_MALE or Person::GENDER_FEMALE, if none specified random gender is used\n// second argument is birth date (DateTime object), if none specified, random birth date is used\necho $faker-\u003enik(); // \"8522246001570940\"\n```\n\n### `Faker\\Provider\\it_CH\\Person`\n```php\n\u003c?php\n\n// Generates a random AVS13/AHV13 social security number\necho $faker-\u003eavs13; // \"756.1234.5678.97\"\n```\n\n### `Faker\\Provider\\it_IT\\Company`\n\n```php\n\u003c?php\n\n// Generates a random Vat Id\necho $faker-\u003evatId(); // \"IT98746784967\"\n```\n\n### `Faker\\Provider\\it_IT\\Person`\n\n```php\n\u003c?php\n\n// Generates a random Tax Id code (Codice fiscale)\necho $faker-\u003etaxId(); // \"DIXDPZ44E08F367A\"\n```\n\n### `Faker\\Provider\\ja_JP\\Person`\n\n```php\n\u003c?php\n\n// Generates a 'kana' name\necho $faker-\u003ekanaName($gender = null|'male'|'female') // \"アオタ ミノル\"\n\n// Generates a 'kana' first name\necho $faker-\u003efirstKanaName($gender = null|'male'|'female') // \"ヒデキ\"\n\n// Generates a 'kana' first name on the male\necho $faker-\u003efirstKanaNameMale // \"ヒデキ\"\n\n// Generates a 'kana' first name on the female\necho $faker-\u003efirstKanaNameFemale // \"マアヤ\"\n\n// Generates a 'kana' last name\necho $faker-\u003elastKanaName; // \"ナカジマ\"\n```\n\n### `Faker\\Provider\\ka_GE\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random bank account number\necho $faker-\u003ebankAccountNumber; // \"GE33ZV9773853617253389\"\n```\n\n### `Faker\\Provider\\kk_KZ\\Company`\n\n```php\n\u003c?php\n\n// Generates an business identification number\necho $faker-\u003ebusinessIdentificationNumber; // \"150140000019\"\n```\n\n### `Faker\\Provider\\kk_KZ\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random bank name\necho $faker-\u003ebank; // \"Қазкоммерцбанк\"\n\n// Generates a random bank account number\necho $faker-\u003ebankAccountNumber; // \"KZ1076321LO4H6X41I37\"\n```\n\n### `Faker\\Provider\\kk_KZ\\Person`\n\n```php\n\u003c?php\n\n// Generates an individual identification number\necho $faker-\u003eindividualIdentificationNumber; // \"780322300455\"\n\n// Generates an individual identification number based on his/her birth date\necho $faker-\u003eindividualIdentificationNumber(new \\DateTime('1999-03-01')); // \"990301300455\"\n```\n\n### `Faker\\Provider\\ko_KR\\Address`\n\n```php\n\u003c?php\n\n// Generates a metropolitan city\necho $faker-\u003emetropolitanCity; // \"서울특별시\"\n\n// Generates a borough\necho $faker-\u003eborough; // \"강남구\"\n```\n\n### `Faker\\Provider\\ko_KR\\PhoneNumber`\n\n```php\n\u003c?php\n\n// Generates a local area phone numer\necho $faker-\u003elocalAreaPhoneNumber; // \"02-1234-4567\"\n\n// Generates a cell phone number\necho $faker-\u003ecellPhoneNumber; // \"010-9876-5432\"\n```\n\n### `Faker\\Provider\\lt_LT\\Payment`\n\n```php\n\u003c?php\n\necho $faker-\u003ebankAccountNumber // \"LT300848876740317118\"\n```\n\n### `Faker\\Provider\\lv_LV\\Person`\n\n```php\n\u003c?php\n\n// Generates a random personal identity card number\necho $faker-\u003epersonalIdentityNumber; // \"140190-12301\"\n```\n\n### `Faker\\Provider\\ms_MY\\Address`\n\n```php\n\u003c?php\n\n// Generates a random Malaysian township\necho $faker-\u003etownship; // \"Taman Bahagia\"\n\n// Generates a random Malaysian town address with matching postcode and state\necho $faker-\u003etownState; // \"55100 Bukit Bintang, Kuala Lumpur\"\n```\n\n### `Faker\\Provider\\ms_MY\\Miscellaneous`\n\n```php\n\u003c?php\n\n// Generates a random vehicle license plate number\necho $faker-\u003ejpjNumberPlate; // \"WPL 5169\"\n```\n\n### `Faker\\Provider\\ms_MY\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random Malaysian bank\necho $faker-\u003ebank; // \"Maybank\"\n\n// Generates a random Malaysian bank account number (10-16 digits)\necho $faker-\u003ebankAccountNumber; // \"1234567890123456\"\n\n// Generates a random Malaysian insurance company\necho $faker-\u003einsurance; // \"AIA Malaysia\"\n\n// Generates a random Malaysian bank SWIFT Code\necho $faker-\u003eswiftCode; // \"MBBEMYKLXXX\"\n```\n\n### `Faker\\Provider\\ms_MY\\Person`\n\n```php\n\u003c?php\n\n// Generates a random personal identity card (myKad) number\necho $faker-\u003emyKadNumber($gender = null|'male'|'female', $hyphen = null|true|false); // \"710703471796\"\n```\n\n### `Faker\\Provider\\ms_MY\\PhoneNumber`\n\n```php\n\u003c?php\n\n// Generates a random Malaysian mobile number\necho $faker-\u003emobileNumber($countryCodePrefix = null|true|false, $formatting = null|true|false); // \"+6012-705 3767\"\n\n// Generates a random Malaysian landline number\necho $faker-\u003efixedLineNumber($countryCodePrefix = null|true|false, $formatting = null|true|false); // \"03-7112 0455\"\n\n// Generates a random Malaysian voip number\necho $faker-\u003evoipNumber($countryCodePrefix = null|true|false, $formatting = null|true|false); // \"015-458 7099\"\n```\n\n### `Faker\\Provider\\ne_NP\\Address`\n\n```php\n\u003c?php\n\n//Generates a Nepali district name\necho $faker-\u003edistrict;\n\n//Generates a Nepali city name\necho $faker-\u003ecityName;\n```\n\n### `Faker\\Provider\\nl_BE\\Payment`\n\n```php\n\u003c?php\n\necho $faker-\u003evat;           // \"BE 0123456789\" - Belgian Value Added Tax number\necho $faker-\u003evat(false);    // \"BE0123456789\" - unspaced Belgian Value Added Tax number\n```\n\n### `Faker\\Provider\\nl_BE\\Person`\n\n```php\n\u003c?php\n\necho $faker-\u003errn();         // \"83051711784\" - Belgian Rijksregisternummer\necho $faker-\u003errn('female'); // \"50032089858\" - Belgian Rijksregisternummer for a female\n```\n\n### `Faker\\Provider\\nl_NL\\Company`\n\n```php\n\u003c?php\n\necho $faker-\u003ejobTitle; // \"Houtbewerker\"\necho $faker-\u003evat; // \"NL123456789B01\" - Dutch Value Added Tax number\necho $faker-\u003ebtw; // \"NL123456789B01\" - Dutch Value Added Tax number (alias)\n```\n\n### `Faker\\Provider\\nl_NL\\Person`\n\n```php\n\u003c?php\n\necho $faker-\u003eidNumber; // \"111222333\" - Dutch Personal identification number (BSN)\n```\n\n### `Faker\\Provider\\nb_NO\\MobileNumber`\n\n```php\n\u003c?php\n\n// Generates a random Norwegian mobile phone number\necho $faker-\u003emobileNumber; // \"+4799988777\"\necho $faker-\u003emobileNumber; // \"999 88 777\"\necho $faker-\u003emobileNumber; // \"99988777\"\n```\n\n### `Faker\\Provider\\nb_NO\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random bank account number\necho $faker-\u003ebankAccountNumber; // \"NO3246764709816\"\n```\n\n### `Faker\\Provider\\pl_PL\\Person`\n\n```php\n\u003c?php\n\n// Generates a random PESEL number\necho $faker-\u003epesel; // \"40061451555\"\n// Generates a random personal identity card number\necho $faker-\u003epersonalIdentityNumber; // \"AKX383360\"\n// Generates a random taxpayer identification number (NIP)\necho $faker-\u003etaxpayerIdentificationNumber; // '8211575109'\n```\n\n### `Faker\\Provider\\pl_PL\\Company`\n\n```php\n\u003c?php\n\n// Generates a random REGON number\necho $faker-\u003eregon; // \"714676680\"\n// Generates a random local REGON number\necho $faker-\u003eregonLocal; // \"15346111382836\"\n```\n\n### `Faker\\Provider\\pl_PL\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random bank name\necho $faker-\u003ebank; // \"Narodowy Bank Polski\"\n// Generates a random bank account number\necho $faker-\u003ebankAccountNumber; // \"PL14968907563953822118075816\"\n```\n\n### `Faker\\Provider\\pt_PT\\Person`\n\n```php\n\u003c?php\n\n// Generates a random taxpayer identification number (in portuguese - Número de Identificação Fiscal NIF)\necho $faker-\u003etaxpayerIdentificationNumber; // '165249277'\n```\n\n### `Faker\\Provider\\pt_BR\\Address`\n\n```php\n\u003c?php\n\n// Generates a random region name\necho $faker-\u003eregion; // 'Nordeste'\n\n// Generates a random region abbreviation\necho $faker-\u003eregionAbbr; // 'NE'\n```\n\n### `Faker\\Provider\\pt_BR\\PhoneNumber`\n\n```php\n\u003c?php\n\necho $faker-\u003eareaCode;  // 21\necho $faker-\u003ecellphone; // 9432-5656\necho $faker-\u003elandline;  // 2654-3445\necho $faker-\u003ephone;     // random landline, 8-digit or 9-digit cellphone number\n\n// Using the phone functions with a false argument returns unformatted numbers\necho $faker-\u003ecellphone(false); // 74336667\n\n// cellphone() has a special second argument to add the 9th digit. Ignored if generated a Radio number\necho $faker-\u003ecellphone(true, true); // 98983-3945 or 7343-1290\n\n// Using the \"Number\" suffix adds area code to the phone\necho $faker-\u003ecellphoneNumber;       // (11) 98309-2935\necho $faker-\u003elandlineNumber(false); // 3522835934\necho $faker-\u003ephoneNumber;           // formatted, random landline or cellphone (obeying the 9th digit rule)\necho $faker-\u003ephoneNumberCleared;    // not formatted, random landline or cellphone (obeying the 9th digit rule)\n```\n\n### `Faker\\Provider\\pt_BR\\Person`\n\n```php\n\u003c?php\n\n// The name generator may include double first or double last names, plus title and suffix\necho $faker-\u003ename; // 'Sr. Luis Adriano Sepúlveda Filho'\n\n// Valid document generators have a boolean argument to remove formatting\necho $faker-\u003ecpf;        // '145.343.345-76'\necho $faker-\u003ecpf(false); // '45623467866'\necho $faker-\u003erg;         // '84.405.736-3'\necho $faker-\u003erg(false);  // '844057363'\n```\n\n### `Faker\\Provider\\pt_BR\\Company`\n\n```php\n\u003c?php\n\n// Generates a Brazilian formatted and valid CNPJ\necho $faker-\u003ecnpj;        // '23.663.478/0001-24'\necho $faker-\u003ecnpj(false); // '23663478000124'\n```\n\n### `Faker\\Provider\\ro_MD\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random bank account number\necho $faker-\u003ebankAccountNumber; // \"MD83BQW1CKMUW34HBESDP3A8\"\n```\n\n### `Faker\\Provider\\ro_RO\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random bank account number\necho $faker-\u003ebankAccountNumber; // \"RO55WRJE3OE8X3YQI7J26U1E\"\n```\n\n### `Faker\\Provider\\ro_RO\\Person`\n\n```php\n\u003c?php\n\n// Generates a random male name prefix/title\necho $faker-\u003eprefixMale; // \"ing.\"\n// Generates a random female name prefix/title\necho $faker-\u003eprefixFemale; // \"d-na.\"\n// Generates a random male first name\necho $faker-\u003efirstNameMale; // \"Adrian\"\n// Generates a random female first name\necho $faker-\u003efirstNameFemale; // \"Miruna\"\n\n\n// Generates a random Personal Numerical Code (CNP)\necho $faker-\u003ecnp; // \"2800523081231\"\n// Valid option values:\n//    $gender: null (random), male, female\n//    $dateOfBirth (1800+): null (random), Y-m-d, Y-m (random day), Y (random month and day)\n//          i.e. '1981-06-16', '2015-03', '1900'\n//    $county: 2 letter ISO 3166-2:RO county codes and B1, B2, B3, B4, B5, B6 for Bucharest's 6 sectors\n//    $isResident true/false flag if the person resides in Romania\necho $faker-\u003ecnp($gender = null, $dateOfBirth = null, $county = null, $isResident = true);\n\n```\n\n### `Faker\\Provider\\ro_RO\\PhoneNumber`\n\n```php\n\u003c?php\n\n// Generates a random toll-free phone number\necho $faker-\u003etollFreePhoneNumber; // \"0800123456\"\n// Generates a random premium-rate phone number\necho $faker-\u003epremiumRatePhoneNumber; // \"0900123456\"\n```\n\n### `Faker\\Provider\\ru_RU\\Payment`\n\n```php\n\u003c?php\n\n// Generates a Russian bank name (based on list of real russian banks)\necho $faker-\u003ebank; // \"ОТП Банк\"\n\n//Generate a Russian Tax Payment Number for Company\necho $faker-\u003einn; //  7813540735\n\n//Generate a Russian Tax Code for Company\necho $faker-\u003ekpp; // 781301001\n```\n\n### `Faker\\Provider\\sv_SE\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random bank account number\necho $faker-\u003ebankAccountNumber; // \"SE5018548608468284909192\"\n```\n\n### `Faker\\Provider\\sv_SE\\Person`\n\n```php\n\u003c?php\n\n//Generates a valid Swedish personal identity number (in Swedish - Personnummer)\necho $faker-\u003epersonalIdentityNumber() // '950910-0799'\n\n//Since the numbers are different for male and female persons, optionally you can specify gender.\necho $faker-\u003epersonalIdentityNumber('female') // '950910-0781'\n```\n### `Faker\\Provider\\tr_TR\\Person`\n\n```php\n\u003c?php\n\n//Generates a valid Turkish identity number (in Turkish - T.C. Kimlik No)\necho $faker-\u003etcNo // '55300634882'\n\n```\n\n\n### `Faker\\Provider\\zh_CN\\Payment`\n\n```php\n\u003c?php\n\n// Generates a random bank name (based on list of real chinese banks)\necho $faker-\u003ebank; // '中国建设银行'\n```\n\n### `Faker\\Provider\\uk_UA\\Payment`\n\n```php\n\u003c?php\n\n// Generates an Ukraine bank name (based on list of real Ukraine banks)\necho $faker-\u003ebank; // \"Ощадбанк\"\n```\n\n### `Faker\\Provider\\zh_TW\\Person`\n\n```php\n\u003c?php\n\n// Generates a random personal identify number\necho $faker-\u003epersonalIdentityNumber; // A223456789\n```\n\n### `Faker\\Provider\\zh_TW\\Company`\n\n```php\n\u003c?php\n\n// Generates a random VAT / Company Tax number\necho $faker-\u003eVAT; //23456789\n```\n\n\n## Third-Party Libraries Extending/Based On Faker\n\n* Symfony bundles:\n  * [`willdurand/faker-bundle`](https://github.com/willdurand/BazingaFakerBundle): Put the awesome Faker library into the Symfony2 DIC and populate your database with fake data.\n  * [`hautelook/alice-bundle`](https://github.com/hautelook/AliceBundle), [`h4cc/alice-fixtures-bundle`](https://github.com/h4cc/AliceFixturesBundle): Bundles for using [`nelmio/alice`](https://packagist.org/packages/nelmio/alice) and Faker with data fixtures. Able to use Doctrine ORM as well as Doctrine MongoDB ODM.\n* [`emanueleminotto/faker-service-provider`](https://github.com/EmanueleMinotto/FakerServiceProvider): Faker Service Provider for Silex\n* [`bit3/faker-cli`](https://github.com/bit3/faker-cli): Command Line Tool for the Faker PHP library\n* [`league/factory-muffin`](https://github.com/thephpleague/factory-muffin): enable the rapid creation of objects (PHP port of factory-girl)\n* [`fzaninotto/company-name-generator`](https://github.com/fzaninotto/CompanyNameGenerator): Generate names for English tech companies with class\n* [`emanueleminotto/faker-placehold-it-provider`](https://github.com/EmanueleMinotto/PlaceholdItProvider): Generate images using placehold.it\n* [`spyrit/datalea`](https://github.com/spyrit/datalea) A highly customizable random test data generator web app\n* [`frequenc1/newage-ipsum`](https://github.com/frequenc1/newage-ipsum): A new aged ipsum provider for the faker library inspired by http://sebpearce.com/bullshit/\n* [`prewk/xml-faker`](https://github.com/prewk/xml-faker): Create fake XML with Faker\n* [`denheck/faker-context`](https://github.com/denheck/faker-context): Behat context using Faker to generate testdata\n* [`swekaj/cron-expression-generator`](https://github.com/swekaj/CronExpressionGenerator): Faker provider for generating random, valid cron expressions.\n* [`pragmafabrik/pomm-faker`](https://github.com/pragmafabrik/Pomm2Faker): Faker client for Pomm database framework (PostgreSQL)\n* [`nelmio/alice`](https://github.com/nelmio/alice): Fixtures/object generator with a yaml DSL that can use Faker as data generator.\n* [`ravage84/cakephp-fake-seeder`](https://github.com/ravage84/cakephp-fake-seeder) A CakePHP 2.x shell to seed your database with fake and/or fixed data.\n* [`bheller/images-generator`](https://github.com/bruceheller/images-generator): An image generator provider using GD for placeholder type pictures\n* [`pattern-lab/plugin-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.\n* [`guidocella/eloquent-populator`](https://github.com/guidocella/eloquent-populator): Adapter for Laravel's Eloquent ORM.\n* [`tamperdata/exiges`](https://github.com/tamperdata/exiges): Faker provider for generating random temperatures\n* [`jzonta/faker-restaurant`](https://github.com/jzonta/FakerRestaurant): Faker for Food and Beverage names generate\n* [`aalaap/faker-youtube`](https://github.com/aalaap/faker-youtube): Faker for YouTube URLs in various formats\n* [`pelmered/fake-car`](https://github.com/pelmered/fake-car): Faker for cars and car data\n* [`bluemmb/faker-picsum-photos-provider`](https://github.com/bluemmb/Faker-PicsumPhotos): Generate images using [picsum.photos](http://picsum.photos/)\n* [`er1z/fakemock`](https://github.com/er1z/fakemock): Generate mocks using class-configuration and detection via Faker's guesser and Symfony asserts\n* [`xvladqt/faker-lorem-flickr`](https://github.com/xvladxtremal/Faker-LoremFlickr): Generate images using [loremflickr.com](http://loremflickr.com/)\n* [`metrakit/faker-eddy-malou`](https://github.com/Metrakit/faker-eddy-malou): Generate French Eddy Malou sentences \u0026 paragraphs\n* [`drupol/belgian-national-number-faker`](https://github.com/drupol/belgian-national-number-faker): Generate fake Belgian national numbers\n* [`elgentos/masquerade`](https://github.com/elgentos/masquerade): Configuration-based, platform-agnostic, locale-compatible data faker tool (out-of-the-box support for Magento 2)\n* [`ottaviano/faker-gravatar`](https://github.com/ottaviano/faker-gravatar): Generate avatars using [Gravatar](https://en.gravatar.com/site/implement/images/)\n* [`finwe/phpstan-faker`](https://github.com/finwe/phpstan-faker): PHPStan extension for Faker methods\n\n## License\n\nFaker is released under the MIT License. See the bundled LICENSE file for details.\n","funding_links":[],"categories":["PHP","Usage","Testing","测试","测试 Testing","[PHP](#php)","Categories","Open Source","Table of Contents","测试( Testing )","Developments","插件推荐"],"sub_categories":["Testing Libraries / Helpers","Testing","Framework \u0026 Libraries"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffzaninotto%2FFaker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffzaninotto%2FFaker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffzaninotto%2FFaker/lists"}