Bug: allOf with description

[siggi-k]

Invoice.yaml

title: Invoice
x-table: invoices
type: object
properties:
  id:
    type: integer
  reference_invoice:
    allOf:
      - $ref: '#/components/schemas/Invoice'
      - x-faker: false
      - description: This field is only set on invoices of type "cancellation_invoice"

Bug: description don't work with allOf. Is not displayed in the generated BaseModel.

[SOHELAHMED7]

At this moment, every custom OpenAPI extension such as x-faker, x-fk-on-update etc. with allOf is manually dealt with. description is not handled at all.

php-openapi make it easy to read allOf but it does not resolve allOf yet.

I have created cebe/php-openapi#208 to make handling and resolving of allOf dynamic. If merged and released, I will upgrade php-openapi repo in this repo and remove custom handling of above keywords in yii2-openapi.

Though I will still create a test in yii2-openapi using cebe/php-openapi#208 to ensure this issue is fixed.

[SOHELAHMED7]

Though current state of pull request #51 fixes this issue, current implementation is not perfect and professional.

That is because most part of this library uses unresolved (example: unresolved references) OpenAPI spec.

For particularly this issue we need resolved OpenAPI spec i.e. resolved references, resolved allOfs etc.

So to gain more concrete implementation, significant changes to this library might be required.

So first let

• Resolve: Better way to resolve allOf  cebe/php-openapi#208 be merged
• similar changes to above be implemented for OpenAPI Responses, Paths and Callbacks

It is still possible to fix this issue without cebe/php-openapi#208 bieng merged, but that will be manual like done for example x-fk-on-delete.