recycledbeans/the-office-faker

Faker Generator,主题围绕史上最佳电视剧之一,《办公室》。

v1.0.11 2020-12-03 21:43 UTC

This package is auto-updated.

Last update: 2024-08-29 05:13:01 UTC


README

Latest Stable Version Build Status

熊。甜菜。银河战舰。

使用这个包,你可以扩展非常实用的 Faker (fzaninotto/faker) 库,通过使用来自热门电视剧《办公室》(美国版) 中的角色和公司来为你的 PHP 应用程序填充假数据。

这对于我们推出 Dunder Mifflin Infinity ✌️-point-👌 是至关重要的!

安装

使用 Composer 安装此包。

composer require recycledbeans/the-office-faker

使用方法

通过将提供程序添加到 Faker 实例,立即使用您已经熟悉的 Faker 方法开始使用角色和公司名称。

以下示例使用 Laravel Factory 作为示例,但 Faker(以及此提供程序)可以用于任何 PHP 项目。

$faker = Faker\Factory::create();
$faker->addProvider(new \TheOfficeFaker\Provider\TheOffice($faker));

// Example usage (more details below)
$name = $faker->character()->name; // Dwight Schrute
$company = $faker->company; // Poor Richard's Pub

🔥 Laravel

如果您在一个 Laravel 应用程序中使用此包,您还可以通过将 TheOfficeFaker\Laravel\TheOfficeServiceProvider::class 添加到 config/app.php 文件的 providers 部分来全局地使此功能可用于所有工厂和测试,具体请参考 Laravel 文档

角色

上述默认用法创建真正随机的首名和姓氏,因此您可能会得到像 "Roy Kapoor" 或 "Jim Schrute" 这样的名字。如果您希望首名和姓氏与节目中的角色一致(这可能是大多数人所希望的),您可以使用 character() 方法来返回一个包含角色详细信息的对象。

$character = $faker->character();

return [
    'given_name' => $character->firstName,
    'family_name' => $character->lastName,
    'email' => $character->safeEmail,
];

公司

有一个小型但不断增长的电影公司名称列表,取自《办公室》的剧集。您可以使用这些名称,就像使用正常的公司属性一样。

// Michael Scott Paper Company, for instance
$company = $faker->company; 

贡献

运行单元测试

此项目使用 PHPUnit。您可以带或不带代码覆盖率运行测试。

不带代码覆盖率

./vendor/bin/phpunit

带代码覆盖率(您必须安装 Xdebug 以运行代码覆盖率)

./vendor/bin/phpunit --coverage-html tests/coverage

要查看代码覆盖率报告,请打开浏览器中的 tests/coverage/index.html

想法

您对这个包中想看到的其他数据有什么想法吗?创建一个带有您建议的问题!

待办事项(我非常希望得到您的帮助!)

我有一个简短的待办事项列表,我希望在不久的将来改进或添加,以使此提供程序变得更好。如果您想在这项事业中帮忙,请随时创建一个拉取请求。即使您不想编码,如果看到角色列表中缺少的人物或尚未添加的公司,请创建一个 PR!

  • 添加更多公司名称:有很多虚构公司以及 Scranton 地区的地点可以添加,以增加更多变化性。
  • 城市和地区:我不知道《办公室》中是否会提到足够多的城市(主要来自 PA 地区),但我认为值得调查提供程序是否能够提供足够多的城市以添加。
  • 剧集中的台词?也许有一个文本提供程序可以返回实际对话中的一句随机台词?

关注我的 Twitter