README

Faker

Faker 是一个 PHP 库，可以为您生成虚假数据。无论您需要启动数据库、创建美观的 XML 文档、填充持久化数据以进行压力测试，还是匿名化从生产服务获取的数据，Faker 都能满足您的需求。

它受到了 Perl 的 Data::Faker 和 Ruby 的 Faker 的极大启发。

入门

安装

Faker 需要 PHP >= 7.1。

composer require fakerphp/faker

文档

完整的文档可以在 fakerphp.github.io 上找到。

基本用法

使用 Faker\Factory::create() 创建并初始化一个 Faker 生成器，通过访问以您想要的数据类型命名的函数来生成数据。

<?php
require_once 'vendor/autoload.php';

// use the factory to create a Faker\Generator instance
$faker = Faker\Factory::create();
// generate data by calling methods
echo $faker->name();
// 'Vince Sporer'
echo $faker->email();
// 'walter.sophia@hotmail.com'
echo $faker->text();
// 'Numquam ut mollitia at consequuntur inventore dolorem.'

每次调用 $faker->name() 都会产生不同的（随机）结果。这是因为 Faker 使用了 __call() 魔法函数，并将 Faker\Generator->$method() 调用转发到 Faker\Generator->format($method, $attributes)。

<?php
for ($i = 0; $i < 3; $i++) {
    echo $faker->name() . "\n";
}

// 'Cyrus Boyle'
// 'Alena Cummerata'
// 'Orlo Bergstrom'

许可证

Faker 采用 MIT 许可证发布。有关详细信息，请参阅 LICENSE。

向后兼容性承诺

Faker 使用 Semver。这意味着版本用 MAJOR.MINOR.PATCH 标记。只有新的主要版本才允许破坏向后兼容性（BC）。

标记为 @experimental 或 @internal 的类不包括在我们的向后兼容性承诺中。您也不能保证方法返回的值总是相同的。我们可以保证数据类型不会改变。

PHP 8 引入了 命名参数，这增加了包维护者的成本并降低了灵活性。Faker 中方法参数的名称不包括在我们的 BC 承诺中。