PHPackages                             yoanm/jsonrpc-http-server-swagger-doc-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. yoanm/jsonrpc-http-server-swagger-doc-sdk

ActiveLibrary[API Development](/categories/api)

yoanm/jsonrpc-http-server-swagger-doc-sdk
=========================================

SDK to generate Http JSON-RPC server documentation for Swagger v2.0

v1.0.2(8mo ago)05.9k↓100%[3 PRs](https://github.com/yoanm/php-jsonrpc-http-server-swagger-doc-sdk/pulls)1MITPHPPHP ^8.0CI passing

Since Apr 20Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/yoanm/php-jsonrpc-http-server-swagger-doc-sdk)[ Packagist](https://packagist.org/packages/yoanm/jsonrpc-http-server-swagger-doc-sdk)[ RSS](/packages/yoanm-jsonrpc-http-server-swagger-doc-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (8)Dependencies (8)Versions (12)Used By (1)

JSON-RPC Http server swagger documentation
==========================================

[](#json-rpc-http-server-swagger-documentation)

[![License](https://camo.githubusercontent.com/f211aec36901f88d62411c013acc7d9a5cacbc32d16841b1805eeab8dda1a1ac/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f796f616e6d2f7068702d6a736f6e7270632d687474702d7365727665722d737761676765722d646f632d73646b2e737667)](https://github.com/yoanm/php-jsonrpc-http-server-swagger-doc-sdk)[![Code size](https://camo.githubusercontent.com/8908752561f67bf494b0d03e87b7f55e278774b259ed90c7ea9e025f0aabe97e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c616e6775616765732f636f64652d73697a652f796f616e6d2f7068702d6a736f6e7270632d687474702d7365727665722d737761676765722d646f632d73646b2e737667)](https://github.com/yoanm/php-jsonrpc-http-server-swagger-doc-sdk)[![Dependabot Status](https://camo.githubusercontent.com/57409c2a51c60e528bdb2f1e29fb5ace063d404a12b7400498ce12320041712a/68747470733a2f2f666c61742e62616467656e2e6e65742f6769746875622f646570656e6461626f742f796f616e6d2f7068702d6a736f6e7270632d687474702d7365727665722d737761676765722d646f632d73646b)](https://camo.githubusercontent.com/57409c2a51c60e528bdb2f1e29fb5ace063d404a12b7400498ce12320041712a/68747470733a2f2f666c61742e62616467656e2e6e65742f6769746875622f646570656e6461626f742f796f616e6d2f7068702d6a736f6e7270632d687474702d7365727665722d737761676765722d646f632d73646b)[![Last commit](https://camo.githubusercontent.com/cb96800d19202686c92299178e2beb5f74879d4a9de4f21d147b05a514f765a7/68747470733a2f2f62616467656e2e6e65742f6769746875622f6c6173742d636f6d6d69742f796f616e6d2f7068702d6a736f6e7270632d687474702d7365727665722d737761676765722d646f632d73646b)](https://camo.githubusercontent.com/cb96800d19202686c92299178e2beb5f74879d4a9de4f21d147b05a514f765a7/68747470733a2f2f62616467656e2e6e65742f6769746875622f6c6173742d636f6d6d69742f796f616e6d2f7068702d6a736f6e7270632d687474702d7365727665722d737761676765722d646f632d73646b)

[![Scrutinizer Build Status](https://camo.githubusercontent.com/8f5c8f74c854394c52bccb7cb6f02a438d38665774c01228d54e9959f32429fb/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f6275696c642f672f796f616e6d2f7068702d6a736f6e7270632d687474702d7365727665722d737761676765722d646f632d73646b2e7376673f6c6162656c3d5363727574696e697a6572266c6f676f3d7363727574696e697a6572)](https://scrutinizer-ci.com/g/yoanm/php-jsonrpc-http-server-swagger-doc-sdk/build-status/master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/590714a9730ae354d0a071ba969c61d2c26e5b25264ac6d8540a66175eb906ed/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f796f616e6d2f7068702d6a736f6e7270632d687474702d7365727665722d737761676765722d646f632d73646b2f6d61737465722e7376673f6c6f676f3d7363727574696e697a6572)](https://scrutinizer-ci.com/g/yoanm/php-jsonrpc-http-server-swagger-doc-sdk/?branch=master)[![Codacy Badge](https://camo.githubusercontent.com/9fb44e29c9d4bd4ecd206541fbd305938a5a0dbcc15fdab5d1db97a7a24ce23a/68747470733a2f2f6170702e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f3866333934323461646430343462343361373062646232333865326634386462)](https://www.codacy.com/gh/yoanm/php-jsonrpc-http-server-swagger-doc-sdk/dashboard?utm_source=github.com&utm_medium=referral&utm_content=yoanm/php-jsonrpc-http-server-swagger-doc-sdk&utm_campaign=Badge_Grade)

[![CI](https://github.com/yoanm/php-jsonrpc-http-server-swagger-doc-sdk/actions/workflows/CI.yml/badge.svg?branch=master)](https://github.com/yoanm/php-jsonrpc-http-server-swagger-doc-sdk/actions/workflows/CI.yml)[![codecov](https://camo.githubusercontent.com/d777747c1b6c0948762aa5fbea13a4f504d9340f953668499fe35b0943bae798/68747470733a2f2f636f6465636f762e696f2f67682f796f616e6d2f7068702d6a736f6e7270632d687474702d7365727665722d737761676765722d646f632d73646b2f6272616e63682f6d61737465722f67726170682f62616467652e7376673f746f6b656e3d4e486477454255464b35)](https://codecov.io/gh/yoanm/php-jsonrpc-http-server-swagger-doc-sdk)

[![Latest Stable Version](https://camo.githubusercontent.com/6cf69058ca1f57ce94b190def311d3f87dc8c28de511fa7d18861b43ca8e4c55/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f796f616e6d2f6a736f6e7270632d687474702d7365727665722d737761676765722d646f632d73646b2e737667)](https://packagist.org/packages/yoanm/jsonrpc-http-server-swagger-doc-sdk)[![Packagist PHP version](https://camo.githubusercontent.com/8d2953de79cbfbded0393f75408da7d49a167b6ff03ea994def5a2c27d5887f1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f796f616e6d2f6a736f6e7270632d687474702d7365727665722d737761676765722d646f632d73646b2e737667)](https://packagist.org/packages/yoanm/jsonrpc-http-server-swagger-doc-sdk)

SDK to generate Http JSON-RPC server documentation for Swagger v2.0

See [`yoanm/symfony-jsonrpc-http-server-swagger-doc`](https://github.com/yoanm/symfony-jsonrpc-http-server-swagger-doc) for automatic dependency injection.

How to use
----------

[](#how-to-use)

Create the normalizer :

```
use Yoanm\JsonRpcHttpServerSwaggerDoc\App\Normalizer\Component\ErrorDocNormalizer;
use Yoanm\JsonRpcHttpServerSwaggerDoc\App\Normalizer\Component\ExternalSchemaListDocNormalizer;
use Yoanm\JsonRpcHttpServerSwaggerDoc\App\Normalizer\Component\OperationDocNormalizer;
use Yoanm\JsonRpcHttpServerSwaggerDoc\App\Normalizer\Component\RequestDocNormalizer;
use Yoanm\JsonRpcHttpServerSwaggerDoc\App\Normalizer\Component\ResponseDocNormalizer;
use Yoanm\JsonRpcHttpServerSwaggerDoc\App\Normalizer\Component\SchemaTypeNormalizer;
use Yoanm\JsonRpcHttpServerSwaggerDoc\App\Normalizer\Component\ShapeNormalizer;
use Yoanm\JsonRpcHttpServerSwaggerDoc\App\Normalizer\Component\TypeDocNormalizer;
use Yoanm\JsonRpcHttpServerSwaggerDoc\App\Resolver\DefinitionRefResolver;
use Yoanm\JsonRpcHttpServerSwaggerDoc\Infra\Normalizer\DocNormalizer;

$shapeNormalizer = new ShapeNormalizer();
$definitionRefResolver = new DefinitionRefResolver();
$typeDocNormalizer = new TypeDocNormalizer(
    new SchemaTypeNormalizer()
);

$normalizer = new DocNormalizer(
    new ExternalSchemaListDocNormalizer(
        $definitionRefResolver,
        $typeDocNormalizer,
        new ErrorDocNormalizer(
            $typeDocNormalizer,
            $shapeNormalizer
        ),
        $shapeNormalizer
    ),
    new OperationDocNormalizer(
        $definitionRefResolver,
        new RequestDocNormalizer(
            $definitionRefResolver,
            $shapeNormalizer
        ),
        new ResponseDocNormalizer(
            $definitionRefResolver,
            $shapeNormalizer
        )
    )
);
```

Then you can convert `ServerDoc` or `HttpServerDoc` by doing :

```
use Yoanm\JsonRpcServerDoc\Domain\Model\ServerDoc;

$serverDoc = new ServerDoc();
// Configure server doc
...
// Add methods documentation
...
// Then normalize
/** @var array $swaggerDoc */
$swaggerDoc = $normalizer->normalize($serverDoc);
```

Contributing
------------

[](#contributing)

See [contributing note](./CONTRIBUTING.md)

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance75

Regular maintenance activity

Popularity21

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 92.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~332 days

Recently: every ~515 days

Total

8

Last Release

248d ago

Major Versions

v0.2.2 → v1.0.02023-04-02

PHP version history (2 changes)v0.1.0PHP >=7.1

v1.0.0PHP ^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4410697?v=4)[yoanm](/maintainers/yoanm)[@yoanm](https://github.com/yoanm)

---

Top Contributors

[![yoanm](https://avatars.githubusercontent.com/u/4410697?v=4)](https://github.com/yoanm "yoanm (48 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (1 commits)")

---

Tags

documentation-generatorjson-rpcjsonrpc-server-doc-sdkphpsdkswagger

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/yoanm-jsonrpc-http-server-swagger-doc-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/yoanm-jsonrpc-http-server-swagger-doc-sdk/health.svg)](https://phpackages.com/packages/yoanm-jsonrpc-http-server-swagger-doc-sdk)
```

###  Alternatives

[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M270](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/common-protos

Google API Common Protos for PHP

173103.7M49](/packages/google-common-protos)[hubspot/api-client

Hubspot API client

23414.2M16](/packages/hubspot-api-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)