canvural / php-openapi-faker
用于生成 OpenAPI 请求/响应/架构的虚假数据的库。
2.1.0
2022-11-22 11:14 UTC
Requires
- php: ^8.0 || ^8.1 || ^8.2
- ext-json: *
- cebe/php-openapi: ^1.7
- fakerphp/faker: ^1.20
- league/openapi-psr7-validator: ^0.18
- thecodingmachine/safe: ^2.4
Requires (Dev)
- doctrine/coding-standard: ^10
- ergebnis/composer-normalize: ^2.27
- infection/infection: ^0.26
- phpstan/extension-installer: ^1.1
- phpstan/phpstan: ^1.9
- phpstan/phpstan-phpunit: ^1
- phpunit/phpunit: ^9.5
- rector/rector: ^0.14.7
- spatie/phpunit-snapshot-assertions: ^4.2
- symfony/var-dumper: ^6
- thecodingmachine/phpstan-safe-rule: ^1.2
README
为您的 OpenAPI 请求、响应和架构生成虚假数据的库。
$faker = \Vural\OpenAPIFaker\OpenAPIFaker::createFromJson($yourSchemaAsJson); $fakeData = $faker->mockResponse('/todos','GET');
安装
您可以通过 composer 安装此包
composer require --dev canvural/php-openapi-faker
使用方法
首先,您需要创建一个 OpenAPIFaker
实例,该实例包含您要从其生成虚假数据的架构。您可以使用 createFromJson
、createFromYaml
或 createFromSchema
创建 OpenAPIFaker
的实例。
$faker = \Vural\OpenAPIFaker\OpenAPIFaker::createFromJson($yourSchemaAsJson);
然后,您可以在其实例上使用 mockResponse
、mockResponseForExample
、mockRequest
、mockRequestForExample
、mockComponentSchema
和 mockComponentSchemaForExample
方法来生成您的请求、响应和架构的虚假数据。例如
$fakeData = $faker->mockResponse('/todos','GET');
选项
有一些选项可以用来修改一些行为。您可以将选项作为关联数组传递给 OpenAPIFaker
中的 setOptions
方法。例如
$faker = \Vural\OpenAPIFaker\OpenAPIFaker::createFromJson($yourSchemaAsJson) ->setOptions(['minItems' => 5]);
以下是对每个选项的解释。
minItems
如果此值小于 minItems
属性,则覆盖 minItems
属性。
maxItems
如果此值大于 maxItems
,则覆盖 maxItems
。
alwaysFakeOptionals
如果启用,则无论属性或项是否必需,都将生成每个属性或项。默认值:false
strategy
默认情况下,OpenAPIFaker
使用动态生成策略。您可以使用 static
策略启用静态示例生成。默认值:dynamic
变更日志
请参阅 CHANGELOG 了解最近更改的更多信息。
贡献
请参阅 CONTRIBUTING 了解详细信息。
致谢
人物
资源
许可
MIT 许可证(MIT)。请参阅 许可文件 了解更多信息。