title: Swagger PHP - Describe array of objects
body: <p>I use <strong>Laravel</strong> + <strong>Swagger PHP</strong>. In one of my services, I handle parameters like this :</p>
  <pre class="lang-php prettyprint-override"><code>$params = [
      'addressChild' =&gt; [
          'address' =&gt; ' ... ',
          'city' =&gt; ' ... ',
      ],
      'addressParent' =&gt; [
          'address' =&gt; ' ... ',
          'city' =&gt; ' ... ',
      ],
  ];
  </code></pre>
  <p>I am trying to describe this schema in Swagger Annotations, using <strong>OpenApi 3</strong> :</p>
  <pre class="lang-php prettyprint-override"><code>/**
   * @OA\Post(
   *      path=&quot;/entity/{entity}/addresses&quot;,
   *      @OA\Response(
   *          response=200,
   *          @OA\JsonContent()
   *      ),
   *      @OA\RequestBody(
   *          description=&quot;Addresses to store&quot;,
   *          required=true,
   *          @OA\JsonContent(
   *              type=&quot;object&quot;,
   *              @OA\Property()
   *          ),
   *      ),
   * )
   *
   */
  public function update(Request $request)
  {
      // ...
  }
  </code></pre>
  <p>I tried many things like :</p>
  <pre class="lang-php prettyprint-override"><code> @OA\JsonContent(
       type=&quot;object&quot;,
       @OA\Property(name=&quot;addressKid&quot;, ref=&quot;#/components/schemas/ParkingAddressRequest&quot;) // error
   ),
  </code></pre>
  <p>My address data is described in <code>ref=&quot;#/components/schemas/ParkingAddressRequest&quot;</code> schema, how can I set it as an array in <code>RequestBody</code> ?</p>