zircote/swagger-php

Warning: Skipping unknown

Ошибка означает, что зиркот "не может загрузиться класс"

This message means that swagger-php has tried to use reflection to inspect \SomeClass and that PHP could not find/load that class. Effectively, this means that

class_exists("\SomeClass") 

returns false.

источник: https://zircote.github.io/swagger-php/gu...

Notice: Trying to access array offset on value of type bool zircote php 7.4

-- решается обновлением до 3.0.3 (или выше), просто выполните в своем проекте:

composer update zircote/swagger-php

-------

Notice: Trying to access array offset on value of type null

-- появилось после предыдущего обновление, как решить пока не ясно, но документация пересобирается нормальном.

Error: [Syntax Error] Expected PlainValue, got '[' in on line

Пишем вместо квадратных скобок дял массива, например:

example={"name": "CUSTOMER_ROLE", "permissions": [1, 3]}

фигурные:

example={"name": "CUSTOMER_ROLE", "permissions": {1, 3}}

то же самое в контексте всей аннотации:

Например для zircote/swagger-php:

Required @OA\Info() not found
Required @OA\PathItem() not found

Добавьте в любой из php-файлов из той папки, которую вы обходите, что-то вроде:

/**
 * @OA\Info(title="My First API", version="0.1")
 */

/**
 * @OA\Get(
 *     path="/api/resource.json",
 *     @OA\Response(response="200", description="An example resource")
 * )
 */

Установка
Возможно, имеет смысл установить как пакет для разработки (dev):

composer require zircote/swagger-php

Работа с паветом
Действуем так:

Swagger -- средство для удобной разработки и просмотра документации к метода REST API.

• Официальный сайт: https://swagger.io/
• Как начать использовать в php-проекте.

Остальные материалы см. по ссылкам ниже.