Полный курс Laravel Swagger. REST API Laravel

Стань спонсором(бусти аккаунт), доступ к собеседованиям:

Мои платные курсы:

План развития с нуля до middle+:

Группа вк:

- - 00:00:00 Введение
00:04:25 Делаем заготовку
00:16:20 Установка Swagger
00:22:18 Общие аннотации и настройки Swagger
00:28:01 CRUD со Swagger
01:03:03 Установка JWT Auth
01:13:08 Авторизация и защищенные роуты в Swagger
01:20:20 Бонус. Нестандартные тело запроса и ответа

[biLLie_wiLLie]

Мужик, спасибо за полезное видео. Сними про Redis пожалуйста! Ребята, поднимите коммент лайками плиз.

[sergeykondratev]

Лучшего учителя ещё не встречал, автору большой респект

[alderion-el-thunder]

Посмотрел видео после перерыва в программировании чтобы освежить память - спасибо, было полезно.

Пара моментов:
1. У себя я описываю методы внутри контроллеров, причем каждый метод описывается отдельно над ним самим, а не над контроллером в целом - достаточно удобно для сравнения самого метода и аннотации к нему. При этом у меня что методы, что аннотации по умолчанию свернуты, поэтому все выглядит компактно и красиво.
2. Схемы можно расписывать отдельно внизу аннотации, а в аннотации метода ссылаться на них.
3. Можно включить автогенерацию документации, чтобы каждый раз не генерировать ее вручную.
4. Еще я не использовал allOf, видимо потому, что принимаю не JSON, а параметры отдельно.

[augcat]

Всем привет, пожилые ребятушки!
Круто, не знал, что есть такой инструмент. Посмотрел первую треть, очень полезно. Обязательно вернусь к видео позже.

[gru]

От души огромное благодарю Уважаемый!👋👍👏

[paul.inglsmit]

Ютуб мои мысли читает. Только думал о том как swagger c laravel вяжется. И вот он в предложениях просмотра.

[andrewlevitsky]

Cделай пожалуйста видео по кешированию данньіх, а именно про Redis и ему подобное. Очень нужна информация єта в структурированном класном виде в твоем стиле подачи!)
Поддержите лайками чтоб автор увидел!

[Khudayberdiyev-gsmn]

Спасибо как раз прошлом видео написал про это в коментарии)

[АндрейГалушко-ео]

Просто пушка! спасибо за качественный материал!

[qoonmax]

1. Вы раньше практиковали однометодные контроллеры, мне кажется сейчас они максимально актуальны. Создавать дубль одного и того-же контроллера, сомнительно конечно. Да вам придётся прописать все 4 роута для круда, но в этом есть и плюсы, вы избавитесь от этой магии ресурса, для новичков так супер актуально.

2. ХЗ как там работает сваггер если его отдельным докер-контейнром организовывать, но чисто в теории, это может лишить вас этих проблем с авторизацией. Можно повесить авторизацию на уровне nginx, или что-то вроде того.

3. Кому нужно организовать доку, и с вас не требуют обязательно сделать это через сваггер, есть решение по проще. Можно сделать доку через постман.
В постмане можно нажать на всю группу и сгенерить доку, он сгенерит тоже html-ку.
В постмане можно очень легко делать варианты запросов и их ответов. Не помню точно как называется, но там возле ответа есть кнопка "Save as example" что-то такое. Вы можете наплодить много вариантов, где каждый например уникалльный. Вот 200, вот 404, вот 422, вот 500.

Он генериит странички где будут и все вариант запроса и все вариант ответа, и описание можно добавить.
В общем, сильно проще, в добавок вы и так скорее всего уже юзаете постман и у вас есть там запросы, зачем их дублировать в сваггер? :))

[romanetsenterprises]

Так там вроде в VerifyCsrfToken не надо ставить в исключение, если роуты берутся из api, там вроде по умолчанию уже не проверяется csrf

[ИльяК-зр]

Как по мне это боль !
Код файл с кодом перегружен (хотя можно выносить параметры запроса и формат ответа в ресурсы или реквесты) описанием для свагера. Дубликаты контроллеров тоже боль.

[lisichkinuriy]

А чем эти PHP аннотации лучше обычного yaml файла c OpenApi спецификациями? OpenApi спецификации хорошо поддерживается IDE, а PhpStorm - он сам себе сваггер. Там есть кнопка типа "скомпилировать доки из спецификации".

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

Поймите правильно, не холиварю и без притензий. Но в легком замешательстве. Может чего не понял.

[sani]

Авторизация в Swagger работает с Sanctum или только с JWT?

[sashasss]

Laravel Creative, расскажите пожалуйста про websocket на production версии с HTTPS.

[handleftman]

Странно, что до сих пор этот компонент сам не берет route:list и не анализирует синтакс контроллеров 😅

[НиколайН-тт]

Спасибо за видео!
Каким образом можно добавить в в сваггер необязательное наличие jwt, от наличия которого будет зависеть объем данных в ответе?

[nick-test]

Не хватало мне подобного урока очень давно, но посмотрев его сейчас подумал "хорошо что раньше не нашел"..
Не понимаю зачем захламлять проект этими комментариями, если можно всё описывать в openapi файле и читать его swagger'ом

[АртемАртеменконезабывайвыходит]

сделаешь курс по админке Laravel Orchid или полноценную админку с ролями и тд а не эти огрызки от админки ?)

[TsAex]

Максимально неудобный подход
1. Руками расставлять отступы, форматировать, нет атокоплитов. Через некоторе время эти коменты превратятся в хаос
2. Дублировать руками контроллеры, вообще дичь. Лишние файлы, при добавлении новых методов нужно не забыть дублировать в оба места, по-любому кто-то по ошибке при разработке вставит в роутере вызов метода контроллера, который ничего не делает
3. Генерировать каждый раз документацию
Решения
1. Писать yaml руками. Есть атвокомплит с плагинами, не будет ошибки по синтаксису, не нужно генерировать файл каждый раз. Минус - большой файл
2. Сделать структуру с папками маленькими yaml файлами + сборщик всего этого добра в единый yaml (есть пакет для Ларки)
3. Выбросить древний Swagger и писать документацию в Postman или другом современном инструменте