Наконец, я обязательно проверю вашу вещь .. :) (хм, не уверен, почему ограничение на размер комментария .. :)

ся, phpDocumentor является стандартом для документирования PHP-кода, хотя мне интересно, почему он не обновлялся годами?

Однако он не подходит для документирования точек входа для REST API; IE, внешние доступные точки входа, которые будут интересны конечному пользователю вашей системы, в отличие от документирования всех внутренних классов и тому подобного - то, что представляет интерес только для разработчиков API.

Я ищу что-то, где я мог бы сказать: эй, этот метод здесь доступен извне через REST по этому URL, здесь приведены аргументы GET или POST, он принимает методы HTTP GET / POST / etc, он возвращает JSON или XML или любой другой.

Эта информация сможет создать документ API. Он также может использоваться внутренним кодом для автоматической фильтрации входных данных, проверки выходных данных, создания базовых модульных тестов и т. Д.