search

yiisoft / yii-swagger

Swagger integration for Yii
https://www.yiiframework.com/
BSD 3-Clause "New" or "Revised" License
30 stars 8 forks source link

Suggest using the new PHP feature attributes #84

Open ezsky opened 10 months ago

ezsky commented 10 months ago

Annotations are very frustrating to use. The IDE has poor support for it and is difficult to debug. Suggest using the new PHP feature attributes，like https://github.com/uderline/openapi-php-attributes

xepozz commented 10 months ago

Totally agree

nkondrashov commented 8 months ago

Hi all! doctrine/annotations being optional as of version 4.8 for zircote/swagger-php (current used ^4.0). Current annotation can't be parsed for openapi.json anymore (Current state after installation: demo apps have error on /docs, also yii-debug-api cant join openapi.js).

I suggest next scenario:

  1. Include doctrine/annotations in current composer json right now (for stabilization demo apps and yii-debug-api)
  2. Issuing refactoring demo apps and yii-debug-api to use native PHP annotation
  3. When complete step 2 - remove doctrine/annotations from composer json

p.s. I hope I selected correctly place for this message