yoanm / jsonrpc-server-doc-sdk
生成 (Http) JSON-RPC 服务器文档的 SDK
v1.0.2
2024-08-30 10:04 UTC
Requires
- php: ^8.0
Requires (Dev)
- ext-json: *
- behat/behat: ^3.9.0
- dvdoug/behat-code-coverage: ^5.0
- phpspec/prophecy: ^1.15
- phpspec/prophecy-phpunit: ^2.0
- phpunit/phpunit: ^9.6
- squizlabs/php_codesniffer: ^3.5
- yoanm/php-unit-extended: ^2.0
Suggests
- yoanm/jsonrpc-http-server-openapi-doc-sdk: SDK to generate Http JSON-RPC server documentation for OpenAPI v3.0.0
- yoanm/jsonrpc-http-server-swagger-doc-sdk: SDK to generate Http JSON-RPC server documentation for Swagger v2.0
- yoanm/jsonrpc-params-symfony-constraint-doc-sdk: SDK to generate JSON-RPC documentation from symfony constraint
- yoanm/jsonrpc-server-sdk: Server SDK to convert a json-rpc request string into json-rpc response string
- yoanm/symfony-jsonrpc-http-server: Symfony Bundle to convert an HTTP json-rpc request into HTTP json-rpc response
- yoanm/symfony-jsonrpc-http-server-doc: Symfony bundle for easy JSON-RPC server documentation
This package is auto-updated.
Last update: 2024-08-30 10:07:44 UTC
README
生成 (Http) JSON-RPC 服务器文档的 PHP SDK
有关自动依赖注入,请参阅 yoanm/symfony-jsonrpc-http-server-doc
有关参数文档生成,请参阅 yoanm/jsonrpc-params-symfony-constraint-doc-sdk
可用格式
- 原始格式 : 内置
json
格式 - Swagger : yoanm/jsonrpc-http-server-swagger-doc-sdk
- OpenApi : yoanm/jsonrpc-http-server-openapi-doc-sdk
如何使用
PHP 对象
可用的文档对象
ServerDoc
和HttpServerDoc
用于 HTTP 服务器方法文档
错误文档
TagDoc
: 允许标记方法- 类型
标准化器
可用的标准化器
TypeDocNormalizer
use Yoanm\JsonRpcServerDoc\Infra\Normalizer\TypeDocNormalizer; $typeDocNormalizer = new TypeDocNormalizer();
TagDocNormalizer
use Yoanm\JsonRpcServerDoc\Infra\Normalizer\TagDocNormalizer; $tagDocNormalizer = new TagDocNormalizer();
ErrorDocNormalizer
use Yoanm\JsonRpcServerDoc\Infra\Normalizer\MethodDocNormalizer; $errorDocNormalizer = new ErrorDocNormalizer($typeDocNormalizer);
MethodDocNormalizer
use Yoanm\JsonRpcServerDoc\Infra\Normalizer\MethodDocNormalizer; $tagDocNormalizer = new MethodDocNormalizer( $typeDocNormalizer, $errorDocNormalizer );
ServerDocNormalizer
和HttpServerDocNormalizer
用于 HTTP 服务器use Yoanm\JsonRpcServerDoc\Infra\Normalizer\ServerDocNormalizer; use Yoanm\JsonRpcServerDoc\Infra\Normalizer\HttpServerDocNormalizer; $normalizer = new ServerDocNormalizer( $methodDocNormalizer, $tagDocNormalizer, $errorDocNormalizer ); $httpNormalizer = new HttpServerDocNormalizer($normalizer);
贡献
请参阅 贡献指南