PHPackages                             nastradamus39/annotation-md - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. nastradamus39/annotation-md

ActiveLibrary[Parsing & Serialization](/categories/parsing)

nastradamus39/annotation-md
===========================

This extension parse phpdoc annotations and generate md document that can be parsed by slate docker

0.0.8(9y ago)01.3k1BSD-3-ClausePHP

Since Jan 27Pushed 9y ago1 watchersCompare

[ Source](https://github.com/nastradamus39/annotation-md)[ Packagist](https://packagist.org/packages/nastradamus39/annotation-md)[ RSS](/packages/nastradamus39-annotation-md/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (1)Versions (9)Used By (0)

Возможности
-----------

[](#возможности)

- **Phpdoc** — Документация оформляется в виде коментариев phpdoc. Из которых генерируется .md файл.
- **Slate docker** — Формат сгенерированного .md поддерживается [slate](https://github.com/lord/slate)

Установка
---------

[](#установка)

`composer require nastradamus39/annotation-md`

Использование
-------------

[](#использование)

```
$controllersPath = PATH_TO_CONTROLLERS;
$buildPath = BUILD_PATH;

$params = [
            "title"     => "Заголовок",
            "baseUrl"   => "http://api.yoursite.com"
        ];

$parser = new Parser($controllersPath, $buildPath, $params);
$parser->parse();
```

- **$controllersPath** - Путь к папке, в которой будет происходить поиск контроллеров.
- **$buildPath** - Путь к папке где будет сохранен постронный .md

Аннотации
---------

[](#аннотации)

Поддерживаемые аннотации:

- **ApiController** — Описывает контроллер. Раздел в документации.
- **ApiContent** — Произвольный блок контента. В документации представляет собой раздел.
- **ApiError** — Блок с описанием ошибок. Добавляется в конце документации.
- **ApiAction** — Действие контроллера. Подраздел раздела в документации.
- **Sample** - Пример кода на одном из языков - javascript, php, shell, ruby, python
- **Request** - Описывает запрос.
- **Param** - Параметр запроса.

Вкладка json используется примера ответа сервера на запрос.

```
/**
 * @ApiController(
 *     title="Пользователь",
 *     description="Описаие методов для работы с пользователем"
 * )
 * @ApiContent(
 *     title="Авторизация",
 *     description="Описание процесса авторизации"
 *  )
 * @ApiError(code="400", description="Bad Request – Your request sucks.")
 * @ApiError(code="401", description="Unauthorized – Your API key is wrong.")
 */
class User
{
    /**
      * @ApiAction(
      *     title="Список пользователей",
      *     description="Возвращает список пользователей",
      *     samples={
      *          @Sample(lang="javascript", code="alert('123');"),
      *          @Sample(lang="php", code="phpinfo();")
      *     }
      *     request=@Request(
      *          method="GET",
      *          url="/users",
      *          body="",
      *          params={
      *              @Param(title="param1", type="type1", defaultValue="val", description="descr"),
      *              @Param(title="param1", type="type1", defaultValue="val", description="descr")
      *          }
      *         response=@Response(body="json encoded array")
      *     )
      * )
      */
     public function listAction() {}
}
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 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 ~3 days

Total

8

Last Release

3366d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7cbb027beb152590b467008dddde12f5f14676775f0e92e65670583c3dc43ada?d=identicon)[nastradamus39](/maintainers/nastradamus39)

---

Top Contributors

[![nastradamus39](https://avatars.githubusercontent.com/u/3934351?v=4)](https://github.com/nastradamus39 "nastradamus39 (12 commits)")

---

Tags

phpdocannotationsslate

### Embed Badge

![Health badge](/badges/nastradamus39-annotation-md/health.svg)

```
[![Health](https://phpackages.com/badges/nastradamus39-annotation-md/health.svg)](https://phpackages.com/packages/nastradamus39-annotation-md)
```

###  Alternatives

[doctrine/lexer

PHP Doctrine Lexer parser library that can be used in Top-Down, Recursive Descent Parsers.

11.2k910.8M118](/packages/doctrine-lexer)[jms/metadata

Class/method/property metadata management in PHP

1.8k152.8M88](/packages/jms-metadata)[evert/phpdoc-md

PHP documentation generator, with markdown output

169170.9k92](/packages/evert-phpdoc-md)[zeptech/annotations

DOC Block annotation parsing for PHP

66648.6k17](/packages/zeptech-annotations)[jan-swiecki/simple-annotations

Simple annotation parser

66615.0k18](/packages/jan-swiecki-simple-annotations)[clean/phpdoc-md

Parse PHP classes and writes documentation to markdown files

46128.0k40](/packages/clean-phpdoc-md)

PHPackages © 2026

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