Size: a a a

2021 October 05

СА

Станислав Алексеев... in symfony
всем привет, подскажите, пожалуйста
описываю апи с помощью nelmio/NelmioApiDocBundle
есть какая-то возможность описывать апи в каком-то отдельном yaml файле?
а то что-то аннотации в 30 строк к экшену из 5 строк выглядят как бронебойными по воробьям)
источник

VM

Volodymyr Melko in symfony
можно часть описания перенести на DTO  в экшенах только описыватьмкакое дто принимается на вход ,а что идет на респонс
а можно вообще выкинуть бандл и в отдельном ямл-файлике описывать свою апиху по формату openAPI =)
источник

SB

Sergei Baikin in symfony
Именно в этот момент мы удалили бандл
плюс поддержка апи для всех приложений которые могут быть не на симфони или не на пхп вообще

Просто пишите доки в yaml файле
стандартный способ для OPenApi
источник

D

Dmitry in symfony
поддержу, поступил так же
источник

SB

Sergei Baikin in symfony
Из бандла вытягиваете YAML и прощаетесь с бандлом
источник

D

Dmitry in symfony
нелмио уже научился генерить йамл ?
источник

SB

Sergei Baikin in symfony
ну как то он генерит документацию
источник

D

Dmitry in symfony
вы не поверите, налету :)
источник

D

Dmitry in symfony
так было когда я от него отказывался
источник

SB

Sergei Baikin in symfony
Полагаю там можно экспортировать наверно ее в удобоворимом виде не?
источник

SB

Sergei Baikin in symfony
ох боги
источник

D

Dmitry in symfony
пришлось его хакнуть, где-то я нарыл какой-то форк который вытаскивает json
по итогу выхватил из него json из каких-то неведомых недров
а потом сконвертил в йамл
источник

D

Dmitriy in symfony
Хм, походу тоже его выкину нафиг))
источник

D

Dmitry in symfony
возможно сейчас стало лучше, я не знаю, не интересовался
источник

D

Dmitry in symfony
я поставил harmbandstra/swagger-ui-bundle
и скармливаю ему нужные йамлы
источник

D

Dmitriy in symfony
Ещё вот такое есть https://github.com/zircote/swagger-php. Работает чисто через комменты - то есть ему плевать на классы пхпшные и т.п. То есть более гибко получается
источник

D

Dmitry in symfony
это же те же аннотации
источник

D

Dmitriy in symfony
Да, но оно хотя бы не орёт, требуя указать типы для всех паблик-методов)) То есть можно юзать аннотации даже без классов (просто в php-файлах их отдельно писать и всё)
источник

D

Dmitry in symfony
возможно, не пробовал. может вам и сгодится. я для себя выбор сделал вышеописанный. мне быстрее и проще поправить yaml
источник

СА

Станислав Алексеев... in symfony
хм, спасибо
я в симфони немного новичок, по поводу OpenApi подскажете? куда копать и что читать? yaml вроде как из nelmio вытянулся
источник