PHPackages                             pbaszak/extended-api-doc-bundle - 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. pbaszak/extended-api-doc-bundle

ActiveSymfony-bundle[API Development](/categories/api)

pbaszak/extended-api-doc-bundle
===============================

An extension for `nelmio/api-doc-bundle` that improves the sorting of endpoints by tags and provides minor stylistic corrections to the original Nelmio view.

2.0.1(2y ago)01.5k↓100%MITPHPPHP >=8.2

Since Aug 15Pushed 2y ago1 watchersCompare

[ Source](https://github.com/patrykbaszak/extended-api-doc-bundle)[ Packagist](https://packagist.org/packages/pbaszak/extended-api-doc-bundle)[ RSS](/packages/pbaszak-extended-api-doc-bundle/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (2)Dependencies (18)Versions (7)Used By (0)

Extended Api Doc Bundle
=======================

[](#extended-api-doc-bundle)

An extension for `nelmio/api-doc-bundle` that improves the sorting of endpoints by tags and provides minor stylistic corrections to the original Nelmio view.

Installation
------------

[](#installation)

Required bundles:

```
composer require symfony/asset
composer require symfony/twig-bundle
composer require nelmio/api-doc-bundle
composer require pbaszak/extended-api-doc-bundle
```

Routing Registration:

- /api/doc
- /api/doc.json
- /api/doc.yaml

```
# config/routes.yaml
...
extended_api_doc:
    resource: '@ExtendedApiDocBundle/Resources/routes/*'
```

Setup metainfo:

```
# config/packages/nelmio_api_doc.yaml
parameters:
    app_title: '%env(APP_TITLE)%'
    app_description: '%env(APP_DESCRIPTION)%'
    app_version: '%env(APP_VERSION)%'
    app_commit_sha_short: '%env(APP_COMMIT_SHA_SHORT)%'

nelmio_api_doc:
    documentation:
        info:
            title: '%app_title%'
            description: '%app_description%'
            version: '%app_version% (%app_commit_sha_short%)'
    areas: # to filter documented areas
        path_patterns:
            - ^/api(?!/doc(.json|.yaml)?$)
```

Usage
-----

[](#usage)

Just open `/api/doc` path on Your server and enjoy!

[![alt text](docs/image.png)](docs/image.png)

Development
-----------

[](#development)

### How to start

[](#how-to-start)

Start local environment using this command:

```
bash start.sh
```

### How to use **Standard Version**

[](#how-to-use-standard-version)

If You don't have node\_modules directory run:

```
npm install
```

`Major`, `Minor`, `Patch` version update:

```
npm run version:major
# or
npm run version:minor
# or
npm run version:patch
```

Push tags:

```
npm run version:release
# or
npm run release
```

Check `package.json` for understand what commands do.

### How to use **PHPStan**

[](#how-to-use-phpstan)

Main command:

```
docker exec php composer code:analyse
```

but, if You need to add errors to ignored:

```
docker exec php composer code:analyse:b
```

### How to use **PHP CS Fixer**

[](#how-to-use-php-cs-fixer)

```
docker exec php composer code:fix
```

### How to use **XDebug** in **Visual Studio Code**

[](#how-to-use-xdebug-in-visual-studio-code)

Create new file in Your project: `.vscode/launch.json`

```
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for xDebug",
            "type": "php",
            "request": "launch",
            "port": 5902,
            "hostname": "0.0.0.0",
            "pathMappings": {
                "/app/": "${workspaceRoot}"
            }
        }
    ]
}
```

Uncomment environments in `.env.local`:

```
XDEBUG_MODE=develop,debug
XDEBUG_CONFIG=" client_port=5902 idekey=VSCODE client_host=host.docker.internal discover_client_host=0 start_with_request=yes"
```

Type `Ctrl + Shift + D` and run `Listen for xDebug`.

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~37 days

Recently: every ~22 days

Total

6

Last Release

814d ago

Major Versions

0.1.0 → 1.0.02023-11-18

1.1.1 → 2.0.02024-02-14

PHP version history (2 changes)0.1.0PHP >=8.1

2.0.0PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/145db325ca53baabce2d955faebe43d56bc4f3122b9ae463d41ee0e5da487cea?d=identicon)[patrykbaszak](/maintainers/patrykbaszak)

---

Top Contributors

[![patrykbaszak](https://avatars.githubusercontent.com/u/66377724?v=4)](https://github.com/patrykbaszak "patrykbaszak (13 commits)")

---

Tags

nelmioapidocbundleopenapiquery-parametersswaggersymfonybundle

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/pbaszak-extended-api-doc-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/pbaszak-extended-api-doc-bundle/health.svg)](https://phpackages.com/packages/pbaszak-extended-api-doc-bundle)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M646](/packages/sylius-sylius)[kimai/kimai

Kimai - Time Tracking

4.6k7.4k1](/packages/kimai-kimai)[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)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)

PHPackages © 2026

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