@OA\Items() is required when @OA\Property about nelmioapidocbundle HOT 7 OPEN

As the message suggest, you need to add a @OA\Items() for your translations property.

 * @OA\Property(
 *      property="translations"
 *      type="array",
 *      @OA\Items()
 * )

from nelmioapidocbundle.

As I said, there no documentation wrote, the property="translations" just doesn't exist in our project.

from nelmioapidocbundle.

Do you have some more context?

• Bundle version
• Config used
• Do you use Symfony's Map* attributes? https://symfony.com/bundles/NelmioApiDocBundle/current/symfony_attributes.html

This warning is thrown inside the underlying swagger-php:
https://github.com/zircote/swagger-php/blob/038da8ad219f1e9c3f82c5d84c47da3b6f35039c/src/Annotations/Schema.php#L488

from nelmioapidocbundle.

• bundle version : "nelmio/api-doc-bundle": "^4.23"
• config :

    areas: # to filter documented areas
        path_patterns:
            - ^/v1/. # Accepts routes under /v1 except /v1/doc
        disable_default_routes: true

• And yes we are using Symfony's attributes.

This warning came after installation and initialization of nelmio bundle, no more.

from nelmioapidocbundle.

This bundle should automatically add the OA\Items on the version you are using to array properties.

Could you try and find the class inside your codebase which has a "translations" property

public array $translations;

That class should probably contain more information about why it does not add the OA\Items

from nelmioapidocbundle.

This is the problem, there is no var called translations in our project, I really don't know from where this error can come.

from nelmioapidocbundle.

You could try dumping $this by temporarily editing the place where the warning is thrown inside swagger-php inside your vendor.
https://github.com/zircote/swagger-php/blob/038da8ad219f1e9c3f82c5d84c47da3b6f35039c/src/Annotations/Schema.php#L488

from nelmioapidocbundle.