adgoal/symfony-jsonrpc-http-server-doc
Symfony扩展,用于轻松生成JSON-RPC服务器文档
v0.3.1
2020-03-27 16:27 UTC
Requires
- php: >=7.2
- adgoal/jsonrpc-server-doc-sdk: ^0.3
- symfony/config: ^4.0 || ^5.0
- symfony/dependency-injection: ^4.0 || ^5.0
- symfony/http-kernel: ^4.0 || ^5.0
- yoanm/jsonrpc-server-sdk: ^3.0
- yoanm/symfony-jsonrpc-http-server: ^2.0
Requires (Dev)
- behat/behat: ~3.0
- matthiasnoback/symfony-config-test: ^3.0 || ^4.0
- matthiasnoback/symfony-dependency-injection-test: ^3.0 || ^4.0
- phpunit/phpunit: ^7.0 || ^8.0
- squizlabs/php_codesniffer: 3.*
- symfony/framework-bundle: ^3.0 || ^4.0
- symfony/routing: ^3.0 || ^4.0
- yoanm/php-unit-extended: ~1.0
Suggests
- adgoal/symfony-jsonrpc-http-server-openapi-doc: Symfony bundle for easy JSON-RPC server OpenAPI 3.0.0 documentation
- adgoal/symfony-jsonrpc-params-sf-constraints-doc: Symfony bundle for easy Symfony constraints to JSON-RPC documentation transformation
- yoanm/symfony-jsonrpc-http-server: Symfony Bundle to convert an HTTP json-rpc request into HTTP json-rpc response
- yoanm/symfony-jsonrpc-http-server-swagger-doc: Symfony bundle for easy JSON-RPC server Swagger 2.0 documentation
This package is auto-updated.
Last update: 2024-08-29 05:43:14 UTC
README
Symfony扩展,用于轻松生成JSON-RPC服务器文档
Symfony扩展,用于yoanm/jsonrpc-server-doc-sdk
有关参数文档生成的详细信息,请参阅adgoal/symfony-jsonrpc-params-sf-constraints-doc。
支持的格式
- 原始:内置的
json
格式在/doc
或/doc/raw.json
- Swagger:adgoal/symfony-jsonrpc-http-server-swagger-doc
- OpenApi:adgoal/symfony-jsonrpc-http-server-openapi-doc
如何使用
一旦配置完成,您的项目就可以在/doc/{?filename}
端点处理HTTP GET
请求。
下面是如何配置它的示例。
配置
Behat演示应用程序配置文件夹可以用作示例。
-
在您的
config/bundles.php
文件中添加以下内容// config/bundles.php return [ ... Symfony\Bundle\FrameworkBundle\FrameworkBundle::class => ['all' => true], Yoanm\SymfonyJsonRpcHttpServer\JsonRpcHttpServerBundle::class => ['all' => true], Yoanm\SymfonyJsonRpcHttpServerDoc\JsonRpcHttpServerDocBundle::class => ['all' => true], ... ];
-
在您的路由配置中添加以下内容
# config/routes.yaml json-rpc-endpoint: resource: '@JsonRpcHttpServerBundle/Resources/config/routing/endpoint.xml' json-rpc-endpoint-doc: resource: '@JsonRpcHttpServerDocBundle/Resources/config/routing/endpoint.xml'
-
在您的配置中添加以下内容
# config/config.yaml framework: secret: '%env(APP_SECRET)%' json_rpc_http_server: ~ json_rpc_http_server_doc: ~ # Or the following in case you want to customize endpoint path #json_rpc_http_server_doc: # endpoint: '/my-custom-doc-endpoint' # Default to '/doc'
-
按照adgoal/symfony-jsonrpc-http-server文档中的说明注册JSON-RPC方法。
-
在
/doc
端点查询您的项目,您将获得服务器文档的json
格式。
贡献
请参阅贡献指南