Size: a a a

2020 October 30

IM

Ilya Medzhidov 🖋 in symfony
Нашёл nelmio/api-doc-bundle, норм тема, спасибо)
источник

AN

Alexander Nazarov in symfony
дефакто стандарт под симфони проекты
источник

D

Dmitry in symfony
удобнее вести отдельный файл, чем засирать код аннотациями нелмио
опять же отдельный файл потом можно использовать в тестах
источник

JB

Jurij Bachkov in symfony
источник

AN

Alexander Nazarov in symfony
вы можете и с nelmio вести отдельный файл
источник

JB

Jurij Bachkov in symfony
С аннотациями дока будте всегда актуальна
источник

JB

Jurij Bachkov in symfony
а в отдельном файле никто не будет менять - забудут тупо
источник

D

Dmitry in symfony
Jurij Bachkov
С аннотациями дока будте всегда актуальна
пффф, какое заблуждение :) дока будет актуальна только если каким-то чудом какой-то скрипт будет строить доку по самому коду, а не по аннотациям
источник

JB

Jurij Bachkov in symfony
Перед глазами должны быть что надо поменять
источник

D

Dmitry in symfony
Alexander Nazarov
вы можете и с nelmio вести отдельный файл
ага, зачем только тащить весь нелмио если swagger ui есть гораздо мельче и проще для симфони.
источник

МФ

Максим Федоров... in symfony
Jurij Bachkov
Перед глазами должны быть что надо поменять
но если перед глазами, то в анноатциях/атрибутах — максимально близко к глазам 🙂 чем файл
источник

Ш

Шурик in symfony
Jurij Bachkov
а в отдельном файле никто не будет менять - забудут тупо
Тестировщики напомнят)
источник

D

Dmitry in symfony
Jurij Bachkov
Перед глазами должны быть что надо поменять
да да, а для тестирования берем аннотации, опять парсим, выгружаем в отдельный файл и потом по нему тестим.. караул имхо
источник

D

Dmitry in symfony
Шурик
Тестировщики напомнят)
дык тесты напомнят, которые парсят апи файл и шлют запросы
источник

AN

Alexander Nazarov in symfony
Dmitry
да да, а для тестирования берем аннотации, опять парсим, выгружаем в отдельный файл и потом по нему тестим.. караул имхо
nelmio вроде умеет это все в json отдать
источник

D

Dmitry in symfony
Alexander Nazarov
nelmio вроде умеет это все в json отдать
да, только команда dump еще не вмержена в релиз, и валяется у кого-то в пул риквесте
выбор каждый делает сам конечно, но я для себя сделал выбор что дешевле писать сразу йамл
источник

ВМ

Виктор Монастырев... in symfony
Dmitry
да, только команда dump еще не вмержена в релиз, и валяется у кого-то в пул риквесте
выбор каждый делает сам конечно, но я для себя сделал выбор что дешевле писать сразу йамл
200 лет как отдают json
источник

ВМ

Виктор Монастырев... in symfony
Просто в конце страницы а апи методами добавь .json
источник

ВМ

Виктор Монастырев... in symfony
Дамп был во второй версии нелмио, при переходе на третью и четвертую версию json можно получить, как я описал выше, в офф доке нелмио это есть
источник

ВМ

Виктор Монастырев... in symfony
И нелмио поддерживает одновременно аннотации и yaml, то есть часть можно в файле а часть аннотациями описать
Да и в плане дто всяких нелмио автоматом подтчнет состав этого дто, руками ничего описывать не надо
источник