Add ReturnTypeWillChange attribute

Reason: To maintain PHP >=7.1.0 and make implementation PHP 8.1 compatible

Author: the-csaba

src/json/JsonReference.php

@@ -126,6 +126,7 @@ public function getReference(): string
      * @return mixed data which can be serialized by <b>json_encode</b>,
      * which is a value of any type other than a resource.
      */
+    #[\ReturnTypeWillChange]
     public function jsonSerialize()
     {
         return (object)['$ref' => $this->getReference()];

src/spec/Paths.php

@@ -183,6 +183,7 @@ public function getErrors(): array
      * @return boolean true on success or false on failure.
      * The return value will be casted to boolean if non-boolean was returned.
      */
+    #[\ReturnTypeWillChange]
     public function offsetExists($offset)
     {
         return $this->hasPath($offset);
@@ -194,6 +195,7 @@ public function offsetExists($offset)
      * @param mixed $offset The offset to retrieve.
      * @return PathItem Can return all value types.
      */
+    #[\ReturnTypeWillChange]
     public function offsetGet($offset)
     {
         return $this->getPath($offset);
@@ -205,6 +207,7 @@ public function offsetGet($offset)
      * @param mixed $offset The offset to assign the value to.
      * @param mixed $value The value to set.
      */
+    #[\ReturnTypeWillChange]
     public function offsetSet($offset, $value)
     {
         $this->addPath($offset, $value);
@@ -215,6 +218,7 @@ public function offsetSet($offset, $value)
      * @link http://php.net/manual/en/arrayaccess.offsetunset.php
      * @param mixed $offset The offset to unset.
      */
+    #[\ReturnTypeWillChange]
     public function offsetUnset($offset)
     {
         $this->removePath($offset);
@@ -226,6 +230,7 @@ public function offsetUnset($offset)
      * @return int The custom count as an integer.
      * The return value is cast to an integer.
      */
+    #[\ReturnTypeWillChange]
     public function count()
     {
         return count($this->_paths);
@@ -236,6 +241,7 @@ public function count()
      * @link http://php.net/manual/en/iteratoraggregate.getiterator.php
      * @return Traversable An instance of an object implementing <b>Iterator</b> or <b>Traversable</b>
      */
+    #[\ReturnTypeWillChange]
     public function getIterator()
     {
         return new ArrayIterator($this->_paths);

src/spec/Responses.php

@@ -173,6 +173,7 @@ public function getErrors(): array
      * @return boolean true on success or false on failure.
      * The return value will be casted to boolean if non-boolean was returned.
      */
+    #[\ReturnTypeWillChange]
     public function offsetExists($offset)
     {
         return $this->hasResponse($offset);
@@ -184,6 +185,7 @@ public function offsetExists($offset)
      * @param mixed $offset The offset to retrieve.
      * @return mixed Can return all value types.
      */
+    #[\ReturnTypeWillChange]
     public function offsetGet($offset)
     {
         return $this->getResponse($offset);
@@ -195,6 +197,7 @@ public function offsetGet($offset)
      * @param mixed $offset The offset to assign the value to.
      * @param mixed $value The value to set.
      */
+    #[\ReturnTypeWillChange]
     public function offsetSet($offset, $value)
     {
         $this->addResponse($offset, $value);
@@ -205,6 +208,7 @@ public function offsetSet($offset, $value)
      * @link http://php.net/manual/en/arrayaccess.offsetunset.php
      * @param mixed $offset The offset to unset.
      */
+    #[\ReturnTypeWillChange]
     public function offsetUnset($offset)
     {
         $this->removeResponse($offset);
@@ -216,6 +220,7 @@ public function offsetUnset($offset)
      * @return int The custom count as an integer.
      * The return value is cast to an integer.
      */
+    #[\ReturnTypeWillChange]
     public function count()
     {
         return count($this->_responses);
@@ -226,6 +231,7 @@ public function count()
      * @link http://php.net/manual/en/iteratoraggregate.getiterator.php
      * @return Traversable An instance of an object implementing <b>Iterator</b> or <b>Traversable</b>
      */
+    #[\ReturnTypeWillChange]
     public function getIterator()
     {
         return new ArrayIterator($this->_responses);