PHPackages                             diegoborgs/natural-swagger-php - 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. diegoborgs/natural-swagger-php

ActiveLibrary

diegoborgs/natural-swagger-php
==============================

The Swagger UI Render for you PHP Application

1.0.4(4y ago)1813.2k↓46.7%1[3 issues](https://github.com/eudiegoborgs/natural-swagger-php/issues)MITPHP

Since Nov 29Pushed 4y ago1 watchersCompare

[ Source](https://github.com/eudiegoborgs/natural-swagger-php)[ Packagist](https://packagist.org/packages/diegoborgs/natural-swagger-php)[ RSS](/packages/diegoborgs-natural-swagger-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (5)Versions (6)Used By (0)

NaturalSwagger (PHP)
====================

[](#naturalswagger-php)

[![Build Status](https://camo.githubusercontent.com/2f5e4222ce1aaad78ac1a6d4772246302cfcc9e3cf164d9d376b8f7b1f4ac310/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6575646965676f626f7267732f6e61747572616c2d737761676765722d7068702f43493f7374796c653d666c61742d737175617265)](https://github.com/eudiegoborgs/natural-swagger-php/actions?query=workflow:CI)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/db3eae29282c5802035e3f4f90def7e13220722a0e639c0c6a290adbdeab1b1d/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6575646965676f626f7267732f6e61747572616c2d737761676765722d7068702f6261646765732f7175616c6974792d73636f72652e706e673f623d6d61696e)](https://scrutinizer-ci.com/g/eudiegoborgs/natural-swagger-php/?branch=main)[![Code Intelligence Status](https://camo.githubusercontent.com/2b7a6fae9c772772282fcd742aefd150456ce476df17c42c322a703e34f405ce/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6575646965676f626f7267732f6e61747572616c2d737761676765722d7068702f6261646765732f636f64652d696e74656c6c6967656e63652e7376673f623d6d61696e)](https://scrutinizer-ci.com/code-intelligence)[![Total Downloads](https://camo.githubusercontent.com/8992a6fdc8b47de109f8f6b37df6580f537db694cbe58209d85ec58f010b16d8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f646965676f626f7267732f6e61747572616c2d737761676765722d7068702e737667)](https://packagist.org/packages/diegoborgs/natural-swagger-php)[![Latest Stable Version](https://camo.githubusercontent.com/771a66531479f8f93d5e8c927415fb72b1b323350da8adc246307070a09ff91c/68747470733a2f2f706f7365722e707567782e6f72672f646965676f626f7267732f6e61747572616c2d737761676765722d7068702f762f737461626c65)](https://packagist.org/packages/diegoborgs/natural-swagger-php)

The NaturalSwagger allows you to generate a decent documentation for your APIs. This library is based on [zircote/swagger-php](https://github.com/zircote/swagger-php) and [swagger-ui](https://github.com/swagger-api/swagger-ui).

This library provide for your system a swagger UI based

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

[](#how-to-use)

#### Install with composer:

[](#install-with-composer)

```
composer require diegoborgs/natural-swagger-php
```

#### Add to your code:

[](#add-to-your-code)

```
use Diegoborgs\NaturalSwaggerPhp\OpenApiRenderFactory;
use Diegoborgs\NaturalSwaggerPhp\Renders\RenderOpenApi;

$render = OpenApiRenderFactory::get();
$render->render(RenderOpenApi::HTML,  ['base_path' => '/path/to/annotations']);
```

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

[](#contributing)

Fork the project and send your PR.

Running the Tests
-----------------

[](#running-the-tests)

Install the [Composer](http://getcomposer.org/) dependencies:

```
git clone https://github.com/eudiegoborgs/natural-swagger-php.git
cd natural-swagger-php
docker-compose run --rm composer update
// or
composer update

```

Then run the test suite:

```
docker-compose run --rm composer test
// or
composer test

```

License
-------

[](#license)

This bundle is released under the MIT license.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity34

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% 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 ~10 days

Total

5

Last Release

1592d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/579b4c865ea65da43efbdd2e15e86e53adca2a696a8ca9d9f5b294f90cd01992?d=identicon)[eudiegoborgs](/maintainers/eudiegoborgs)

---

Top Contributors

[![eudiegoborgs](https://avatars.githubusercontent.com/u/8547922?v=4)](https://github.com/eudiegoborgs "eudiegoborgs (2 commits)")[![mmdutra](https://avatars.githubusercontent.com/u/36565187?v=4)](https://github.com/mmdutra "mmdutra (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/diegoborgs-natural-swagger-php/health.svg)

```
[![Health](https://phpackages.com/badges/diegoborgs-natural-swagger-php/health.svg)](https://phpackages.com/packages/diegoborgs-natural-swagger-php)
```

###  Alternatives

[symfony/symfony

The Symfony PHP framework

31.3k86.3M2.2k](/packages/symfony-symfony)[nelmio/api-doc-bundle

Generates documentation for your REST API from attributes

2.3k63.6M233](/packages/nelmio-api-doc-bundle)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6939.5M343](/packages/drupal-core-recommended)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)

PHPackages © 2026

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