README

Faker 是一个 PHP 库，用于为您生成虚假数据。无论您需要初始化数据库、创建漂亮的 XML 文档、填充持久层进行压力测试，还是对从生产服务中获取的数据进行匿名化处理，Faker 都适用于您。

Faker 受 Perl 的 Data::Faker 和 Ruby 的 Faker 非常大的启发。

Faker 需要 PHP >= 5.3.3。

Faker 已存档。在此处阅读此决定的理由：[https://marmelab.com/blog/2020/10/21/sunsetting-faker.html](https://marmelab.com/blog/2020/10/21/sunsetting-faker.html)

安装
基本用法
格式化器
- 基础
- 洛伦兹文本
- 人
- 地址
- 电话号码
- 公司
- 真实文本
- 日期和时间
- 互联网
- 用户代理
- 支付
- 颜色
- 文件
- 图片
- Uuid
- 条形码
- 杂项
- 偏见
- Html 洛伦兹
修饰符
本地化
使用 ORM 或 ODM 填充实体
初始化生成器
Faker 内部：理解提供者
实际应用
语言特定格式化器
基于 Faker 扩展/基于 Faker 的第三方库
许可

安装

composer require fzaninotto/faker

基本用法

自动加载

Faker 支持 PSR-0 和 PSR-4 自动加载器。

<?php
# When installed via composer
require_once 'vendor/autoload.php';

您也可以加载 Fakers 中的 PSR-0 自动加载器

<?php
# Load Fakers own autoloader
require_once '/path/to/Faker/src/autoload.php';

或者，您也可以使用任何其他 PSR-4 兼容的自动加载器

创建虚假数据

使用 Faker\Factory::create() 创建并初始化一个 faker 生成器，该生成器可以通过访问以数据类型命名的属性来生成数据。

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

// generate data by accessing properties
echo $faker->name;
  // 'Lucy Cechtelar';
echo $faker->address;
  // "426 Jordy Lodge
  // Cartwrightshire, SC 88120-6700"
echo $faker->text;
  // Dolores sit sint laboriosam dolorem culpa et autem. Beatae nam sunt fugit
  // et sit et mollitia sed.
  // Fuga deserunt tempora facere magni omnis. Omnis quia temporibus laudantium
  // sit minima sint.

即使这个例子显示了属性访问，对 $faker->name 的每次调用都会产生不同的（随机）结果。这是因为 Faker 使用了 __get() 魔法，并将 Faker\Generator->$property 调用转发到 Faker\Generator->format($property)。

<?php
for ($i = 0; $i < 10; $i++) {
  echo $faker->name, "\n";
}
  // Adaline Reichel
  // Dr. Santa Prosacco DVM
  // Noemy Vandervort V
  // Lexi O'Conner
  // Gracie Weber
  // Roscoe Johns
  // Emmett Lebsack
  // Keegan Thiel
  // Wellington Koelpin II
  // Ms. Karley Kiehn V

提示：对于快速生成虚假数据，您也可以通过 faker-cli 将 Faker 作为命令行工具使用。

格式化器

每个生成器属性（如 name、address 和 lorem）都称为“格式化器”。一个 faker 生成器包含许多格式化器，它们打包在“提供者”中。以下是默认区域设置的捆绑格式化器列表。

`Faker\Provider\Base`

randomDigit             // 7
randomDigitNot(5)       // 0, 1, 2, 3, 4, 6, 7, 8, or 9
randomDigitNotNull      // 5
randomNumber($nbDigits = NULL, $strict = false) // 79907610
randomFloat($nbMaxDecimals = NULL, $min = 0, $max = NULL) // 48.8932
numberBetween($min = 1000, $max = 9000) // 8567
randomLetter            // 'b'
// returns randomly ordered subsequence of a provided array
randomElements($array = array ('a','b','c'), $count = 1) // array('c')
randomElement($array = array ('a','b','c')) // 'b'
shuffle('hello, world') // 'rlo,h eoldlw'
shuffle(array(1, 2, 3)) // array(2, 1, 3)
numerify('Hello ###') // 'Hello 609'
lexify('Hello ???') // 'Hello wgt'
bothify('Hello ##??') // 'Hello 42jz'
asciify('Hello ***') // 'Hello R6+'
regexify('[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}'); // [email protected]

`Faker\Provider\Lorem`

word                                             // 'aut'
words($nb = 3, $asText = false)                  // array('porro', 'sed', 'magni')
sentence($nbWords = 6, $variableNbWords = true)  // 'Sit vitae voluptas sint non voluptates.'
sentences($nb = 3, $asText = false)              // array('Optio quos qui illo error.', 'Laborum vero a officia id corporis.', 'Saepe provident esse hic eligendi.')
paragraph($nbSentences = 3, $variableNbSentences = true) // 'Ut ab voluptas sed a nam. Sint autem inventore aut officia aut aut blanditiis. Ducimus eos odit amet et est ut eum.'
paragraphs($nb = 3, $asText = false)             // array('Quidem ut sunt et quidem est accusamus aut. Fuga est placeat rerum ut. Enim ex eveniet facere sunt.', 'Aut nam et eum architecto fugit repellendus illo. Qui ex esse veritatis.', 'Possimus omnis aut incidunt sunt. Asperiores incidunt iure sequi cum culpa rem. Rerum exercitationem est rem.')
text($maxNbChars = 200)                          // 'Fuga totam reiciendis qui architecto fugiat nemo. Consequatur recusandae qui cupiditate eos quod.'

`Faker\Provider\en_US\Person`

title($gender = null|'male'|'female')     // 'Ms.'
titleMale                                 // 'Mr.'
titleFemale                               // 'Ms.'
suffix                                    // 'Jr.'
name($gender = null|'male'|'female')      // 'Dr. Zane Stroman'
firstName($gender = null|'male'|'female') // 'Maynard'
firstNameMale                             // 'Maynard'
firstNameFemale                           // 'Rachel'
lastName                                  // 'Zulauf'

`Faker\Provider\en_US\Address`

cityPrefix                          // 'Lake'
secondaryAddress                    // 'Suite 961'
state                               // 'NewMexico'
stateAbbr                           // 'OH'
citySuffix                          // 'borough'
streetSuffix                        // 'Keys'
buildingNumber                      // '484'
city                                // 'West Judge'
streetName                          // 'Keegan Trail'
streetAddress                       // '439 Karley Loaf Suite 897'
postcode                            // '17916'
address                             // '8888 Cummings Vista Apt. 101, Susanbury, NY 95473'
country                             // 'Falkland Islands (Malvinas)'
latitude($min = -90, $max = 90)     // 77.147489
longitude($min = -180, $max = 180)  // 86.211205

`Faker\Provider\en_US\PhoneNumber`

phoneNumber             // '201-886-0269 x3767'
tollFreePhoneNumber     // '(888) 937-7238'
e164PhoneNumber     // '+27113456789'

`Faker\Provider\en_US\Company`

catchPhrase             // 'Monitored regional contingency'
bs                      // 'e-enable robust architectures'
company                 // 'Bogan-Treutel'
companySuffix           // 'and Sons'
jobTitle                // 'Cashier'

`Faker\Provider\en_US\Text`

realText($maxNbChars = 200, $indexSize = 2) // "And yet I wish you could manage it?) 'And what are they made of?' Alice asked in a shrill, passionate voice. 'Would YOU like cats if you were never even spoke to Time!' 'Perhaps not,' Alice replied."

`Faker\Provider\DateTime`

unixTime($max = 'now')                // 58781813
dateTime($max = 'now', $timezone = null) // DateTime('2008-04-25 08:37:17', 'UTC')
dateTimeAD($max = 'now', $timezone = null) // DateTime('1800-04-29 20:38:49', 'Europe/Paris')
iso8601($max = 'now')                 // '1978-12-09T10:10:29+0000'
date($format = 'Y-m-d', $max = 'now') // '1979-06-09'
time($format = 'H:i:s', $max = 'now') // '20:49:42'
dateTimeBetween($startDate = '-30 years', $endDate = 'now', $timezone = null) // DateTime('2003-03-15 02:00:49', 'Africa/Lagos')
dateTimeInInterval($startDate = '-30 years', $interval = '+ 5 days', $timezone = null) // DateTime('2003-03-15 02:00:49', 'Antartica/Vostok')
dateTimeThisCentury($max = 'now', $timezone = null)     // DateTime('1915-05-30 19:28:21', 'UTC')
dateTimeThisDecade($max = 'now', $timezone = null)      // DateTime('2007-05-29 22:30:48', 'Europe/Paris')
dateTimeThisYear($max = 'now', $timezone = null)        // DateTime('2011-02-27 20:52:14', 'Africa/Lagos')
dateTimeThisMonth($max = 'now', $timezone = null)       // DateTime('2011-10-23 13:46:23', 'Antarctica/Vostok')
amPm($max = 'now')                    // 'pm'
dayOfMonth($max = 'now')              // '04'
dayOfWeek($max = 'now')               // 'Friday'
month($max = 'now')                   // '06'
monthName($max = 'now')               // 'January'
year($max = 'now')                    // '1993'
century                               // 'VI'
timezone                              // 'Europe/Paris'

接受 $timezone 参数的方法默认使用 date_default_timezone_get()。您可以向每个方法传递一个自定义时区字符串，或使用 $faker::setDefaultTimezone($timezone) 一次性为所有时间方法定义一个自定义时区。

`Faker\Provider\Internet`

email                   // '[email protected]'
safeEmail               // '[email protected]'
freeEmail               // '[email protected]'
companyEmail            // '[email protected]'
freeEmailDomain         // 'yahoo.com'
safeEmailDomain         // 'example.org'
userName                // 'wade55'
password                // 'k&|X+a45*2['
domainName              // 'wolffdeckow.net'
domainWord              // 'feeney'
tld                     // 'biz'
url                     // 'http://www.skilesdonnelly.biz/aut-accusantium-ut-architecto-sit-et.html'
slug                    // 'aut-repellat-commodi-vel-itaque-nihil-id-saepe-nostrum'
ipv4                    // '109.133.32.252'
localIpv4               // '10.242.58.8'
ipv6                    // '8e65:933d:22ee:a232:f1c1:2741:1f10:117c'
macAddress              // '43:85:B7:08:10:CA'

`Faker\Provider\UserAgent`

userAgent              // 'Mozilla/5.0 (Windows CE) AppleWebKit/5350 (KHTML, like Gecko) Chrome/13.0.888.0 Safari/5350'
chrome                 // 'Mozilla/5.0 (Macintosh; PPC Mac OS X 10_6_5) AppleWebKit/5312 (KHTML, like Gecko) Chrome/14.0.894.0 Safari/5312'
firefox                // 'Mozilla/5.0 (X11; Linuxi686; rv:7.0) Gecko/20101231 Firefox/3.6'
safari                 // 'Mozilla/5.0 (Macintosh; U; PPC Mac OS X 10_7_1 rv:3.0; en-US) AppleWebKit/534.11.3 (KHTML, like Gecko) Version/4.0 Safari/534.11.3'
opera                  // 'Opera/8.25 (Windows NT 5.1; en-US) Presto/2.9.188 Version/10.00'
internetExplorer       // 'Mozilla/5.0 (compatible; MSIE 7.0; Windows 98; Win 9x 4.90; Trident/3.0)'

`Faker\Provider\Payment`

creditCardType          // 'MasterCard'
creditCardNumber        // '4485480221084675'
creditCardExpirationDate // 04/13
creditCardExpirationDateString // '04/13'
creditCardDetails       // array('MasterCard', '4485480221084675', 'Aleksander Nowak', '04/13')
// Generates a random IBAN. Set $countryCode to null for a random country
iban($countryCode)      // 'IT31A8497112740YZ575DJ28BP4'
swiftBicNumber          // 'RZTIAT22263'

`Faker\Provider\Color`

hexcolor               // '#fa3cc2'
rgbcolor               // '0,255,122'
rgbColorAsArray        // array(0,255,122)
rgbCssColor            // 'rgb(0,255,122)'
safeColorName          // 'fuchsia'
colorName              // 'Gainsbor'
hslColor               // '340,50,20'
hslColorAsArray        // array(340,50,20)

`Faker\Provider\File`

fileExtension          // 'avi'
mimeType               // 'video/x-msvideo'
// Copy a random file from the source to the target directory and returns the fullpath or filename
file($sourceDir = '/tmp', $targetDir = '/tmp') // '/path/to/targetDir/13b73edae8443990be1aa8f1a483bc27.jpg'
file($sourceDir, $targetDir, false) // '13b73edae8443990be1aa8f1a483bc27.jpg'

`Faker\Provider\Image`

// Image generation provided by LoremPixel (http://lorempixel.com/)
imageUrl($width = 640, $height = 480) // 'http://lorempixel.com/640/480/'
imageUrl($width, $height, 'cats')     // 'http://lorempixel.com/800/600/cats/'
imageUrl($width, $height, 'cats', true, 'Faker') // 'http://lorempixel.com/800/400/cats/Faker'
imageUrl($width, $height, 'cats', true, 'Faker', true) // 'http://lorempixel.com/gray/800/400/cats/Faker/' Monochrome image
image($dir = '/tmp', $width = 640, $height = 480) // '/tmp/13b73edae8443990be1aa8f1a483bc27.jpg'
image($dir, $width, $height, 'cats')  // 'tmp/13b73edae8443990be1aa8f1a483bc27.jpg' it's a cat!
image($dir, $width, $height, 'cats', false) // '13b73edae8443990be1aa8f1a483bc27.jpg' it's a filename without path
image($dir, $width, $height, 'cats', true, false) // it's a no randomize images (default: `true`)
image($dir, $width, $height, 'cats', true, true, 'Faker') // 'tmp/13b73edae8443990be1aa8f1a483bc27.jpg' it's a cat with 'Faker' text. Default, `null`.

`Faker\Provider\Uuid`

uuid                   // '7e57d004-2b97-0e7a-b45f-5387367791cd'

`Faker\Provider\Barcode`

ean13          // '4006381333931'
ean8           // '73513537'
isbn13         // '9790404436093'
isbn10         // '4881416324'

`Faker\Provider\Miscellaneous`

boolean // false
boolean($chanceOfGettingTrue = 50) // true
md5           // 'de99a620c50f2990e87144735cd357e7'
sha1          // 'f08e7f04ca1a413807ebc47551a40a20a0b4de5c'
sha256        // '0061e4c60dac5c1d82db0135a42e00c89ae3a333e7c26485321f24348c7e98a5'
locale        // en_UK
countryCode   // UK
languageCode  // en
currencyCode  // EUR
emoji         // 😁

`Faker\Provider\Biased`

// get a random number between 10 and 20,
// with more chances to be close to 20
biasedNumberBetween($min = 10, $max = 20, $function = 'sqrt')

`Faker\Provider\HtmlLorem`

//Generate HTML document which is no more than 2 levels deep, and no more than 3 elements wide at any level.
randomHtml(2,3)   // <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>

修饰符

Faker 提供了三个特殊提供者，unique()、optional() 和 valid()，可以在调用任何提供者之前使用。

// unique() forces providers to return unique values
$values = array();
for ($i = 0; $i < 10; $i++) {
  // get a random digit, but always a new one, to avoid duplicates
  $values []= $faker->unique()->randomDigit;
}
print_r($values); // [4, 1, 8, 5, 0, 2, 6, 9, 7, 3]

// providers with a limited range will throw an exception when no new unique value can be generated
$values = array();
try {
  for ($i = 0; $i < 10; $i++) {
    $values []= $faker->unique()->randomDigitNotNull;
  }
} catch (\OverflowException $e) {
  echo "There are only 9 unique digits not null, Faker can't generate 10 of them!";
}

// you can reset the unique modifier for all providers by passing true as first argument
$faker->unique($reset = true)->randomDigitNotNull; // will not throw OverflowException since unique() was reset
// tip: unique() keeps one array of values per provider

// optional() sometimes bypasses the provider to return a default value instead (which defaults to NULL)
$values = array();
for ($i = 0; $i < 10; $i++) {
  // get a random digit, but also null sometimes
  $values []= $faker->optional()->randomDigit;
}
print_r($values); // [1, 4, null, 9, 5, null, null, 4, 6, null]

// optional() accepts a weight argument to specify the probability of receiving the default value.
// 0 will always return the default value; 1 will always return the provider. Default weight is 0.5 (50% chance).
$faker->optional($weight = 0.1)->randomDigit; // 90% chance of NULL
$faker->optional($weight = 0.9)->randomDigit; // 10% chance of NULL

// optional() accepts a default argument to specify the default value to return.
// Defaults to NULL.
$faker->optional($weight = 0.5, $default = false)->randomDigit; // 50% chance of FALSE
$faker->optional($weight = 0.9, $default = 'abc')->word; // 10% chance of 'abc'

// valid() only accepts valid values according to the passed validator functions
$values = array();
$evenValidator = function($digit) {
	return $digit % 2 === 0;
};
for ($i = 0; $i < 10; $i++) {
	$values []= $faker->valid($evenValidator)->randomDigit;
}
print_r($values); // [0, 4, 8, 4, 2, 6, 0, 8, 8, 6]

// just like unique(), valid() throws an overflow exception when it can't generate a valid value
$values = array();
try {
  $faker->valid($evenValidator)->randomElement([1, 3, 5, 7, 9]);
} catch (\OverflowException $e) {
  echo "Can't pick an even number in that set!";
}

如果您想使用一个值不是由 Faker 生成的修饰符，请使用 passthrough() 方法。 passthrough() 简单返回其给出的任何值。

$faker->optional()->passthrough(mt_rand(5, 15));

本地化

Faker\Factory 可以接受一个区域设置作为参数，以返回本地化数据。如果没有找到本地化提供者，则工厂回退到默认区域设置（en_US）。

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

您可以在源代码中检查可用的 Faker 区域设置，在 Provider 目录下。Faker 的本地化是一个持续的过程，我们需要您的帮助。不要犹豫，为您的区域创建本地化提供者并提交 PR！

使用 ORM 或 ODM 填充实体

Faker 提供了对象关系映射（ORM）和对象文档映射（ODM）的适配器（目前支持 Propel、Doctrine2、CakePHP、Spot2、Mandango 和 Eloquent）。这些适配器简化了通过 ORM 库提供的实体类（或通过 ODM 库提供的文档类）填充数据库（或文档存储）的过程。

要填充实体，创建一个新的填充器类（使用生成器实例作为参数），然后列出所有需要生成的实体类及其数量。要启动实际的数据填充，请调用 execute() 方法。

请注意，某些 populators 可能需要额外的参数。例如，doctrine 填充器有一个选项可以指定其 batchSize，以确定多久将 UnitOfWork 刷新到数据库中。

以下是一个示例，说明如何填充 5 个 Author 和 10 个 Book 对象

<?php
$generator = \Faker\Factory::create();
$populator = new \Faker\ORM\Propel\Populator($generator);
$populator->addEntity('Author', 5);
$populator->addEntity('Book', 10);
$insertedPKs = $populator->execute();

填充器使用名称和列类型猜测器来填充每个列的相关数据。例如，Faker 使用 firstName 格式化程序填充名为 first_name 的列，并使用 dateTime 格式化程序填充具有 TIMESTAMP 类型的列。因此，生成的实体是一致的。如果 Faker 误解了列名，您仍然可以指定一个自定义闭包来填充特定的列，使用 addEntity() 的第三个参数。

<?php
$populator->addEntity('Book', 5, array(
  'ISBN' => function() use ($generator) { return $generator->ean13(); }
));

在这个例子中，Faker 会猜测所有列（除了 ISBN）的格式化程序，对于 ISBN，将使用给定的匿名函数。

提示：要忽略某些列，请指定 null 作为 addEntity() 的第三个参数中的列名。这通常对于由行为添加的列是必要的。

<?php
$populator->addEntity('Book', 5, array(
  'CreatedAt' => null,
  'UpdatedAt' => null,
));

当然，Faker 不填充自动增长的键。此外，Faker\ORM\Propel\Populator::execute() 返回插入的 PK 列表，按类索引。

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

注意：由于 Faker 返回所有插入的主键，因此当进行批量插入时，由于数据列表很大，内存消耗会急剧增加。

在之前的例子中，Book 和 Author 模型之间存在关系。由于 Author 实体首先被填充，Faker 足够智能，可以将填充的 Book 实体与填充的其中一个 Author 实体相关联。

最后，如果您想在插入之前对实体执行任意函数，请使用 addEntity() 方法的第四个参数。

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

种子生成器

您可能希望始终得到相同的数据生成结果 - 例如，当使用 Faker 进行单元测试时。生成器提供了一个 seed() 方法，该方法对随机数生成器进行种子。使用相同的种子两次调用相同的脚本会产生相同的结果。

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

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

提示：如果未修复 $max 值，DateTime 格式化程序不会产生相同的伪造数据。
<?php
// even when seeded, this line will return different results because $max varies
$faker->dateTime(); // equivalent to $faker->dateTime($max = 'now')
// make sure you fix the $max parameter
$faker->dateTime('2014-02-25 08:37:17'); // will return always the same date when seeded
提示：如果使用 rand() php 函数，格式化程序不会产生相同的伪造数据。请使用 $faker 或 mt_rand() 代替。
<?php
// bad
$faker->realText(rand(10,20));
// good
$faker->realText($faker->numberBetween(10,20));

Faker 内部：了解提供者

一个单独的 Faker\Generator 并不能完成太多生成任务。它需要 Faker\Provider 对象来将数据生成委托给它们。实际上，Faker\Factory::create() 创建了一个包含默认提供者的 Faker\Generator。以下是内部的工作原理：

<?php
$faker = new Faker\Generator();
$faker->addProvider(new Faker\Provider\en_US\Person($faker));
$faker->addProvider(new Faker\Provider\en_US\Address($faker));
$faker->addProvider(new Faker\Provider\en_US\PhoneNumber($faker));
$faker->addProvider(new Faker\Provider\en_US\Company($faker));
$faker->addProvider(new Faker\Provider\Lorem($faker));
$faker->addProvider(new Faker\Provider\Internet($faker));

每次尝试访问 $faker 对象的属性时，生成器都会在其附加的所有提供者中查找具有相同名称的方法。例如，调用 $faker->name 将触发对 Faker\Provider\Person::name() 的调用。由于 Faker 从最后一个提供者开始，你可以轻松地覆盖现有的格式化程序：只需添加一个包含你想要覆盖的格式化程序名称方法的提供者即可。

这意味着你可以轻松地向 Faker\Generator 实例添加自己的提供者。提供者通常是一个扩展 \Faker\Provider\Base 的类。这个父类允许你使用 lexify() 或 randomNumber() 等方法；它还通过受保护的 $generator 属性为你提供了访问其他提供者格式化程序的能力。新的格式化程序是提供者类中的公共方法。

以下是一个用于填充书籍数据的示例提供者

<?php

namespace Faker\Provider;

class Book extends \Faker\Provider\Base
{
  public function title($nbWords = 5)
  {
    $sentence = $this->generator->sentence($nbWords);
    return substr($sentence, 0, strlen($sentence) - 1);
  }

  public function ISBN()
  {
    return $this->generator->ean13();
  }
}

要注册此提供者，只需将 \Faker\Provider\Book 的新实例添加到现有生成器中

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

现在你可以像使用任何其他 Faker 格式化程序一样使用这两个新的格式化程序

<?php
$book = new Book();
$book->setTitle($faker->title);
$book->setISBN($faker->ISBN);
$book->setSummary($faker->text);
$book->setPrice($faker->randomNumber(2));

提示：提供者也可以是普通的 PHP 对象。在这种情况下，提供者的所有公共方法都对生成器可用。

实际应用

以下脚本生成一个有效的 XML 文档

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

运行此脚本产生如下文档：

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

特定语言的格式化程序

`Faker\Provider\ar_SA\Person`

<?php

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

`Faker\Provider\ar_SA\Payment`

<?php

echo $faker->bankAccountNumber // "SA0218IBYZVZJSEC8536V4XC"

`Faker\Provider\at_AT\Payment`

<?php

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

`Faker\Provider\bg_BG\Payment`

<?php

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

`Faker\Provider\cs_CZ\Address`

<?php

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

`Faker\Provider\cs_CZ\Company`

<?php

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

`Faker\Provider\cs_CZ\DateTime`

<?php

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

`Faker\Provider\cs_CZ\Person`

<?php

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

`Faker\Provider\da_DK\Person`

<?php

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

`Faker\Provider\da_DK\Address`

<?php

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

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

`Faker\Provider\da_DK\Company`

<?php

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

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

`Faker\Provider\de_CH\Person`

<?php

// Generates a random AVS13/AHV13 social security number
echo $faker->avs13; // "756.1234.5678.97" OR
echo $faker->ahv13; // "756.1234.5678.97"

`Faker\Provider\de_DE\Payment`

<?php

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

`Faker\Provider\en_HK\Address`

<?php

// Generates a fake town name based on the words commonly found in Hong Kong
echo $faker->town; // "Yuen Long"

// Generates a fake village name based on the words commonly found in Hong Kong
echo $faker->village; // "O Tau"

// Generates a fake estate name based on the words commonly found in Hong Kong
echo $faker->estate; // "Ching Lai Court"

`Faker\Provider\en_HK\Phone`

<?php

// Generates a Hong Kong mobile number (starting with 5, 6 or 9)
echo $faker->mobileNumber; // "92150087"

// Generates a Hong Kong landline number (starting with 2 or 3)
echo $faker->landlineNumber; // "32750132"

// Generates a Hong Kong fax number (starting with 7)
echo $faker->faxNumber; // "71937729"

`Faker\Provider\en_NG\Address`

<?php

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

`Faker\Provider\en_NG\Person`

<?php

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

`Faker\Provider\en_NZ\Phone`

<?php

// Generates a cell (mobile) phone number
echo $faker->mobileNumber; // "021 123 4567"

// Generates a toll free number
echo $faker->tollFreeNumber; // "0800 123 456"

// Area Code
echo $faker->areaCode; // "03"

`Faker\Provider\en_US\Company`

<?php

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

`Faker\Provider\en_US\Payment`

<?php

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

`Faker\Provider\en_US\Person`

<?php

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

`Faker\Provider\en_ZA\Company`

<?php

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

`Faker\Provider\en_ZA\Person`

<?php

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

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

`Faker\Provider\en_ZA\PhoneNumber`

<?php

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

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

`Faker\Provider\es_ES\Person`

<?php

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

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

`Faker\Provider\es_ES\Payment`

<?php
// Generates a Código de identificación Fiscal (CIF) number
echo $faker->vat;           // "A35864370"

`Faker\Provider\es_ES\PhoneNumber`

<?php

// Generates a special rate toll free phone number
echo $faker->tollFreeNumber; // 900 123 456

// Generates a mobile phone number
echo $faker->mobileNumber; // +34 612 12 24

`Faker\Provider\es_PE\Person`

<?php

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

`Faker\Provider\fa_IR\Person`

<?php

// Generates a valid nationalCode
echo $faker->nationalCode; // "0078475759"

`Faker\Provider\fa_IR\Address`

<?php

// Generates a random building name
echo $faker->building; // "ساختمان آفتاب"

// Returns a random city name
echo $faker->city // "استان زنجان"

`Faker\Provider\fa_IR\Company`

<?php

// Generates a random contract type
echo $faker->contract; // "رسمی"

`Faker\Provider\fi_FI\Payment`

<?php

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

`Faker\Provider\fi_FI\Person`

<?php

//Generates a valid Finnish personal identity number (in Finnish - 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`

<?php

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

`Faker\Provider\es_VE\Person`

<?php

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

`Faker\Provider\es_VE\Company`

<?php

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

`Faker\Provider\fr_CH\Person`

<?php

// Generates a random AVS13/AHV13 social security number
echo $faker->avs13; // "756.1234.5678.97"

`Faker\Provider\fr_FR\Address`

<?php

// Generates a random department name
echo $faker->departmentName; // "Haut-Rhin"

// Generates a random department number
echo $faker->departmentNumber; // "2B"

// Generates a random department info (department number => department name)
$faker->department; // array('18' => 'Cher');

// Generates a random region
echo $faker->region; // "Saint-Pierre-et-Miquelon"

// Generates a random appartement,stair
echo $faker->secondaryAddress; // "Bat. 961"

`Faker\Provider\fr_FR\Company`

<?php

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

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

`Faker\Provider\fr_FR\Payment`

<?php

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

`Faker\Provider\fr_FR\Person`

<?php

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

`Faker\Provider\fr_FR\PhoneNumber`

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

echo $faker->bankAccountNumber // "IL392237392219429527697"

`Faker\Provider\hr_HR\Payment`

<?php

echo $faker->bankAccountNumber // "HR3789114847226078672"

`Faker\Provider\hu_HU\Payment`

<?php

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

`Faker\Provider\id_ID\Person`

<?php

// Generates a random Nomor Induk Kependudukan (NIK)

// first argument is gender, either Person::GENDER_MALE or Person::GENDER_FEMALE, if none specified random gender is used
// second argument is birth date (DateTime object), if none specified, random birth date is used
echo $faker->nik(); // "8522246001570940"

`Faker\Provider\it_CH\Person`

<?php

// Generates a random AVS13/AHV13 social security number
echo $faker->avs13; // "756.1234.5678.97"

`Faker\Provider\it_IT\Company`

<?php

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

`Faker\Provider\it_IT\Person`

<?php

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

`Faker\Provider\ja_JP\Person`

<?php

// Generates a 'kana' name
echo $faker->kanaName($gender = null|'male'|'female') // "アオタ ミノル"

// Generates a 'kana' first name
echo $faker->firstKanaName($gender = null|'male'|'female') // "ヒデキ"

// Generates a 'kana' first name on the male
echo $faker->firstKanaNameMale // "ヒデキ"

// Generates a 'kana' first name on the female
echo $faker->firstKanaNameFemale // "マアヤ"

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

`Faker\Provider\ka_GE\Payment`

<?php

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

`Faker\Provider\kk_KZ\Company`

<?php

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

`Faker\Provider\kk_KZ\Payment`

<?php

// Generates a random bank name
echo $faker->bank; // "Қазкоммерцбанк"

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

`Faker\Provider\kk_KZ\Person`

<?php

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

// Generates an individual identification number based on his/her birth date
echo $faker->individualIdentificationNumber(new \DateTime('1999-03-01')); // "990301300455"

`Faker\Provider\ko_KR\Address`

<?php

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

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

`Faker\Provider\ko_KR\PhoneNumber`

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

echo $faker->bankAccountNumber // "LT300848876740317118"

`Faker\Provider\lv_LV\Person`

<?php

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

`Faker\Provider\ms_MY\Address`

<?php

// Generates a random Malaysian township
echo $faker->township; // "Taman Bahagia"

// Generates a random Malaysian town address with matching postcode and state
echo $faker->townState; // "55100 Bukit Bintang, Kuala Lumpur"

`Faker\Provider\ms_MY\Miscellaneous`

<?php

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

`Faker\Provider\ms_MY\Payment`

<?php

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

// Generates a random Malaysian bank account number (10-16 digits)
echo $faker->bankAccountNumber; // "1234567890123456"

// Generates a random Malaysian insurance company
echo $faker->insurance; // "AIA Malaysia"

// Generates a random Malaysian bank SWIFT Code
echo $faker->swiftCode; // "MBBEMYKLXXX"

`Faker\Provider\ms_MY\Person`

<?php

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

`Faker\Provider\ms_MY\PhoneNumber`

<?php

// Generates a random Malaysian mobile number
echo $faker->mobileNumber($countryCodePrefix = null|true|false, $formatting = null|true|false); // "+6012-705 3767"

// Generates a random Malaysian landline number
echo $faker->fixedLineNumber($countryCodePrefix = null|true|false, $formatting = null|true|false); // "03-7112 0455"

// Generates a random Malaysian voip number
echo $faker->voipNumber($countryCodePrefix = null|true|false, $formatting = null|true|false); // "015-458 7099"

`Faker\Provider\ne_NP\Address`

<?php

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

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

`Faker\Provider\nl_BE\Payment`

<?php

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

`Faker\Provider\nl_BE\Person`

<?php

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

`Faker\Provider\nl_NL\Company`

<?php

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

`Faker\Provider\nl_NL\Person`

<?php

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

`Faker\Provider\nb_NO\MobileNumber`

<?php

// Generates a random Norwegian mobile phone number
echo $faker->mobileNumber; // "+4799988777"
echo $faker->mobileNumber; // "999 88 777"
echo $faker->mobileNumber; // "99988777"

`Faker\Provider\nb_NO\Payment`

<?php

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

`Faker\Provider\pl_PL\Person`

<?php

// Generates a random PESEL number
echo $faker->pesel; // "40061451555"
// Generates a random personal identity card number
echo $faker->personalIdentityNumber; // "AKX383360"
// Generates a random taxpayer identification number (NIP)
echo $faker->taxpayerIdentificationNumber; // '8211575109'

`Faker\Provider\pl_PL\Company`

<?php

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

`Faker\Provider\pl_PL\Payment`

<?php

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

`Faker\Provider\pt_PT\Person`

<?php

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

`Faker\Provider\pt_BR\Address`

<?php

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

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

`Faker\Provider\pt_BR\PhoneNumber`

<?php

echo $faker->areaCode;  // 21
echo $faker->cellphone; // 9432-5656
echo $faker->landline;  // 2654-3445
echo $faker->phone;     // random landline, 8-digit or 9-digit cellphone number

// Using the phone functions with a false argument returns unformatted numbers
echo $faker->cellphone(false); // 74336667

// cellphone() has a special second argument to add the 9th digit. Ignored if generated a Radio number
echo $faker->cellphone(true, true); // 98983-3945 or 7343-1290

// Using the "Number" suffix adds area code to the phone
echo $faker->cellphoneNumber;       // (11) 98309-2935
echo $faker->landlineNumber(false); // 3522835934
echo $faker->phoneNumber;           // formatted, random landline or cellphone (obeying the 9th digit rule)
echo $faker->phoneNumberCleared;    // not formatted, random landline or cellphone (obeying the 9th digit rule)

`Faker\Provider\pt_BR\Person`

<?php

// The name generator may include double first or double last names, plus title and suffix
echo $faker->name; // 'Sr. Luis Adriano Sepúlveda Filho'

// Valid document generators have a boolean argument to remove formatting
echo $faker->cpf;        // '145.343.345-76'
echo $faker->cpf(false); // '45623467866'
echo $faker->rg;         // '84.405.736-3'
echo $faker->rg(false);  // '844057363'

`Faker\Provider\pt_BR\Company`

<?php

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

`Faker\Provider\ro_MD\Payment`

<?php

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

`Faker\Provider\ro_RO\Payment`

<?php

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

`Faker\Provider\ro_RO\Person`

<?php

// Generates a random male name prefix/title
echo $faker->prefixMale; // "ing."
// Generates a random female name prefix/title
echo $faker->prefixFemale; // "d-na."
// Generates a random male first name
echo $faker->firstNameMale; // "Adrian"
// Generates a random female first name
echo $faker->firstNameFemale; // "Miruna"


// Generates a random Personal Numerical Code (CNP)
echo $faker->cnp; // "2800523081231"
// Valid option values:
//    $gender: null (random), male, female
//    $dateOfBirth (1800+): null (random), Y-m-d, Y-m (random day), Y (random month and day)
//          i.e. '1981-06-16', '2015-03', '1900'
//    $county: 2 letter ISO 3166-2:RO county codes and B1, B2, B3, B4, B5, B6 for Bucharest's 6 sectors
//    $isResident true/false flag if the person resides in Romania
echo $faker->cnp($gender = null, $dateOfBirth = null, $county = null, $isResident = true);

`Faker\Provider\ro_RO\PhoneNumber`

<?php

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

`Faker\Provider\ru_RU\Payment`

<?php

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

//Generate a Russian Tax Payment Number for Company
echo $faker->inn; //  7813540735

//Generate a Russian Tax Code for Company
echo $faker->kpp; // 781301001

`Faker\Provider\sv_SE\Payment`

<?php

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

`Faker\Provider\sv_SE\Person`

<?php

//Generates a valid Swedish personal identity number (in Swedish - Personnummer)
echo $faker->personalIdentityNumber() // '950910-0799'

//Since the numbers are different for male and female persons, optionally you can specify gender.
echo $faker->personalIdentityNumber('female') // '950910-0781'

`Faker\Provider\tr_TR\Person`

<?php

//Generates a valid Turkish identity number (in Turkish - T.C. Kimlik No)
echo $faker->tcNo // '55300634882'

`Faker\Provider\zh_CN\Payment`

<?php

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

`Faker\Provider\uk_UA\Payment`

<?php

// Generates an Ukraine bank name (based on list of real Ukraine banks)
echo $faker->bank; // "Ощадбанк"

`Faker\Provider\zh_TW\Person`

<?php

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

`Faker\Provider\zh_TW\Company`

<?php

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

基于 Faker 的第三方库扩展

Symfony 包
- willdurand/faker-bundle：将强大的 Faker 库集成到 Symfony2 DIC 中，并用假数据填充您的数据库。
- hautelook/alice-bundle，h4cc/alice-fixtures-bundle：使用 nelmio/alice 和 Faker 的数据固定包。能够使用 Doctrine ORM 以及 Doctrine MongoDB ODM。
emanueleminotto/faker-service-provider：Faker Service Provider for Silex
bit3/faker-cli：Faker PHP 库的命令行工具
league/factory-muffin：启用对象的快速创建（factory-girl 的 PHP 版本）
fzaninotto/company-name-generator：使用类生成英文科技公司的名称
emanueleminotto/faker-placehold-it-provider：使用 placehold.it 生成图像
spyrit/datalea：一个高度可定制的随机测试数据生成 Web 应用程序
frequenc1/newage-ipsum：受http://sebpearce.com/bullshit/启发的faker库的新旧ipsum提供者。
prewk/xml-faker：使用Faker创建虚假XML。
denheck/faker-context：使用Faker生成测试数据的Behat上下文。
swekaj/cron-expression-generator：用于生成随机、有效cron表达式的Faker提供者。
pragmafabrik/pomm-faker：Pomm数据库框架（PostgreSQL）的Faker客户端。
nelmio/alice：使用yaml DSL的固定/对象生成器，可以将其用作数据生成器。
ravage84/cakephp-fake-seeder：用于在 CakePHP 2.x 中用虚假和/或固定数据填充数据库的shell。
bheller/images-generator：使用GD生成占位符类型图片的图像生成提供者。
pattern-lab/plugin-faker：Pattern Lab 是一个样式指南、组件库和原型工具。每次生成 Pattern Lab 时都会创建独特的内容。
guidocella/eloquent-populator：Laravel的Eloquent ORM的适配器。
tamperdata/exiges：用于生成随机温度的Faker提供者。
jzonta/faker-restaurant：用于食品和饮料名称生成的Faker。
aalaap/faker-youtube：用于各种格式的YouTube URL的Faker。
pelmered/fake-car：用于汽车和汽车数据的Faker。
bluemmb/faker-picsum-photos-provider：使用picsum.photos生成图像。
er1z/fakemock：使用类配置和通过Faker的猜测器和Symfony断言进行检测来生成模拟。
xvladqt/faker-lorem-flickr：使用loremflickr.com生成图像。
metrakit/faker-eddy-malou：生成法国Eddy Malou句子和段落。
drupol/belgian-national-number-faker：生成虚假的比利时国家号码。
elgentos/masquerade：基于配置、平台无关、语言兼容的数据模拟工具（默认支持Magento 2）。
ottaviano/faker-gravatar：使用Gravatar生成头像。
finwe/phpstan-faker：Faker方法的PHPStan扩展。

许可证

Faker以MIT许可证发布。有关详细信息，请参阅捆绑的LICENSE文件。

fzaninotto / faker

维护者

详情

README

目录

安装

基本用法

自动加载

创建虚假数据

格式化器

Faker\Provider\Base

Faker\Provider\Lorem

Faker\Provider\en_US\Person

Faker\Provider\en_US\Address

Faker\Provider\en_US\PhoneNumber

Faker\Provider\en_US\Company

Faker\Provider\en_US\Text

Faker\Provider\DateTime

Faker\Provider\Internet

Faker\Provider\UserAgent

Faker\Provider\Payment

Faker\Provider\Color

Faker\Provider\File

Faker\Provider\Image

Faker\Provider\Uuid

Faker\Provider\Barcode

Faker\Provider\Miscellaneous

Faker\Provider\Biased

Faker\Provider\HtmlLorem

修饰符

本地化

使用 ORM 或 ODM 填充实体

种子生成器

Faker 内部：了解提供者

实际应用

特定语言的格式化程序

Faker\Provider\ar_SA\Person

Faker\Provider\ar_SA\Payment

Faker\Provider\at_AT\Payment

Faker\Provider\bg_BG\Payment

Faker\Provider\cs_CZ\Address

Faker\Provider\cs_CZ\Company

Faker\Provider\cs_CZ\DateTime

Faker\Provider\cs_CZ\Person

Faker\Provider\da_DK\Person

Faker\Provider\da_DK\Address

Faker\Provider\da_DK\Company

Faker\Provider\de_CH\Person

Faker\Provider\de_DE\Payment

Faker\Provider\en_HK\Address

Faker\Provider\en_HK\Phone

Faker\Provider\en_NG\Address

Faker\Provider\en_NG\Person

Faker\Provider\en_NZ\Phone

Faker\Provider\en_US\Company

Faker\Provider\en_US\Payment

Faker\Provider\en_US\Person

Faker\Provider\en_ZA\Company

Faker\Provider\en_ZA\Person

Faker\Provider\en_ZA\PhoneNumber

Faker\Provider\es_ES\Person

Faker\Provider\es_ES\Payment

Faker\Provider\es_ES\PhoneNumber

Faker\Provider\es_PE\Person

Faker\Provider\fa_IR\Person

Faker\Provider\fa_IR\Address

Faker\Provider\fa_IR\Company

Faker\Provider\fi_FI\Payment

Faker\Provider\fi_FI\Person

Faker\Provider\fr_BE\Payment

Faker\Provider\es_VE\Person

Faker\Provider\es_VE\Company

Faker\Provider\fr_CH\Person

Faker\Provider\fr_FR\Address

Faker\Provider\fr_FR\Company

Faker\Provider\fr_FR\Payment

Faker\Provider\fr_FR\Person

Faker\Provider\fr_FR\PhoneNumber

Faker\Provider\he_IL\Payment

Faker\Provider\hr_HR\Payment

`Faker\Provider\Base`

`Faker\Provider\Lorem`

`Faker\Provider\en_US\Person`

`Faker\Provider\en_US\Address`

`Faker\Provider\en_US\PhoneNumber`

`Faker\Provider\en_US\Company`

`Faker\Provider\en_US\Text`

`Faker\Provider\DateTime`

`Faker\Provider\Internet`

`Faker\Provider\UserAgent`

`Faker\Provider\Payment`

`Faker\Provider\Color`

`Faker\Provider\File`

`Faker\Provider\Image`

`Faker\Provider\Uuid`

`Faker\Provider\Barcode`

`Faker\Provider\Miscellaneous`

`Faker\Provider\Biased`

`Faker\Provider\HtmlLorem`

`Faker\Provider\ar_SA\Person`

`Faker\Provider\ar_SA\Payment`

`Faker\Provider\at_AT\Payment`

`Faker\Provider\bg_BG\Payment`

`Faker\Provider\cs_CZ\Address`

`Faker\Provider\cs_CZ\Company`

`Faker\Provider\cs_CZ\DateTime`

`Faker\Provider\cs_CZ\Person`

`Faker\Provider\da_DK\Person`

`Faker\Provider\da_DK\Address`

`Faker\Provider\da_DK\Company`

`Faker\Provider\de_CH\Person`

`Faker\Provider\de_DE\Payment`

`Faker\Provider\en_HK\Address`

`Faker\Provider\en_HK\Phone`

`Faker\Provider\en_NG\Address`

`Faker\Provider\en_NG\Person`

`Faker\Provider\en_NZ\Phone`

`Faker\Provider\en_US\Company`

`Faker\Provider\en_US\Payment`

`Faker\Provider\en_US\Person`

`Faker\Provider\en_ZA\Company`

`Faker\Provider\en_ZA\Person`

`Faker\Provider\en_ZA\PhoneNumber`

`Faker\Provider\es_ES\Person`

`Faker\Provider\es_ES\Payment`

`Faker\Provider\es_ES\PhoneNumber`

`Faker\Provider\es_PE\Person`

`Faker\Provider\fa_IR\Person`

`Faker\Provider\fa_IR\Address`

`Faker\Provider\fa_IR\Company`

`Faker\Provider\fi_FI\Payment`

`Faker\Provider\fi_FI\Person`

`Faker\Provider\fr_BE\Payment`

`Faker\Provider\es_VE\Person`

`Faker\Provider\es_VE\Company`

`Faker\Provider\fr_CH\Person`

`Faker\Provider\fr_FR\Address`

`Faker\Provider\fr_FR\Company`

`Faker\Provider\fr_FR\Payment`

`Faker\Provider\fr_FR\Person`

`Faker\Provider\fr_FR\PhoneNumber`

`Faker\Provider\he_IL\Payment`

`Faker\Provider\hr_HR\Payment`

`Faker\Provider\hu_HU\Payment`

`Faker\Provider\id_ID\Person`

`Faker\Provider\it_CH\Person`

`Faker\Provider\it_IT\Company`

`Faker\Provider\it_IT\Person`

`Faker\Provider\ja_JP\Person`

`Faker\Provider\ka_GE\Payment`

`Faker\Provider\kk_KZ\Company`

`Faker\Provider\kk_KZ\Payment`

`Faker\Provider\kk_KZ\Person`

`Faker\Provider\ko_KR\Address`

`Faker\Provider\ko_KR\PhoneNumber`

`Faker\Provider\lt_LT\Payment`

`Faker\Provider\lv_LV\Person`

`Faker\Provider\ms_MY\Address`

`Faker\Provider\ms_MY\Miscellaneous`

`Faker\Provider\ms_MY\Payment`