@OA\Items() is required when @OA\Property

[maxence-futures]

I got this error after installation, without any documentation wrote in api.
Route file is ok,
security file is ok.

User Warning: @OA\Items() is required when @OA\Property(property="translations") has type "array" in

[DjordyKoert]

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

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

[maxence-futures]

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

[DjordyKoert]

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

[maxence-futures]

• 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.

[DjordyKoert]

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

NelmioApiDocBundle/src/PropertyDescriber/ArrayPropertyDescriber.php

Lines 27 to 29 in 124c182

	$property->type = 'array';
	/** @var OA\Items $property */
	$property = Util::getChild($property, OA\Items::class);

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

[maxence-futures]

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

[DjordyKoert]

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