Add support for PHP 8.1

.github/workflows/continuous-integration.yml

@@ -66,6 +66,9 @@ jobs:
           - "7.3"
           - "7.4"
           - "8.0"
+        include:
+          - php-version: "8.1"
+            composer-options: "--ignore-platform-req=php"
 
     steps:
       - name: "Checkout repository"
@@ -88,6 +91,14 @@ jobs:
   code-coverage:
     name: "Code coverage"
     runs-on: "ubuntu-latest"
+
+    strategy:
+      fail-fast: false
+      matrix:
+        php-version:
+          - "7.2"
+          - "8.0"
+
     steps:
       - name: "Checkout repository"
         uses: "actions/checkout@v2"
@@ -114,7 +125,6 @@ jobs:
   unit-tests:
     name: "Unit Tests"
     runs-on: "ubuntu-latest"
-    continue-on-error: ${{ matrix.experimental }}
 
     strategy:
       fail-fast: false
@@ -124,11 +134,8 @@ jobs:
           - "7.3"
           - "7.4"
           - "8.0"
-        experimental:
-          - false
         include:
           - php-version: "8.1"
-            experimental: true
             composer-options: "--ignore-platform-req=php"
 
     steps:

composer.json

@@ -13,7 +13,8 @@
         "ext-json": "*",
         "brick/math": "^0.8 || ^0.9",
         "ramsey/collection": "^1.0",
-        "symfony/polyfill-ctype": "^1.8"
+        "symfony/polyfill-ctype": "^1.8",
+        "symfony/polyfill-php80": "^1.14"
     },
     "replace": {
         "rhumsaa/uuid": "self.version"

phpstan.neon.dist

@@ -29,3 +29,7 @@ parameters:
             message: '#^Call to an undefined method Ramsey\\Uuid\\Fields\\FieldsInterface::get.*$#'
             count: 9
             path: ./src/Lazy/LazyUuidFromString.php
+        -
+            message: '#^Result of \|\| is always false\.$#'
+            count: 1
+            path: ./src/Type/Time.php

psalm-baseline.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<files psalm-version="3.18.2@19aa905f7c3c7350569999a93c40ae91ae4e1626">
+<files psalm-version="4.10.0@916b098b008f6de4543892b1e0651c1c3b92cbfa">
   <file src="src/Builder/DegradedUuidBuilder.php">
     <DeprecatedClass occurrences="3">
       <code>DegradedUuid</code>
@@ -48,6 +48,11 @@
       <code>$timeProvider</code>
     </PropertyNotSetInConstructor>
   </file>
+  <file src="src/Fields/SerializableFieldsTrait.php">
+    <UnusedMethodCall occurrences="1">
+      <code>unserialize</code>
+    </UnusedMethodCall>
+  </file>
   <file src="src/Generator/PeclUuidNameGenerator.php">
     <ImpureFunctionCall occurrences="3">
       <code>uuid_generate_md5</code>
@@ -62,6 +67,11 @@
       <code>$this</code>
     </ImpureVariable>
   </file>
+  <file src="src/Lazy/LazyUuidFromString.php">
+    <UnusedMethodCall occurrences="1">
+      <code>unserialize</code>
+    </UnusedMethodCall>
+  </file>
   <file src="src/Nonstandard/UuidBuilder.php">
     <ImpureVariable occurrences="3">
       <code>$this</code>
@@ -108,6 +118,26 @@
       <code>$this</code>
     </ImpureVariable>
   </file>
+  <file src="src/Type/Decimal.php">
+    <UnusedMethodCall occurrences="1">
+      <code>unserialize</code>
+    </UnusedMethodCall>
+  </file>
+  <file src="src/Type/Hexadecimal.php">
+    <UnusedMethodCall occurrences="1">
+      <code>unserialize</code>
+    </UnusedMethodCall>
+  </file>
+  <file src="src/Type/Integer.php">
+    <UnusedMethodCall occurrences="1">
+      <code>unserialize</code>
+    </UnusedMethodCall>
+  </file>
+  <file src="src/Type/Time.php">
+    <UnusedMethodCall occurrences="1">
+      <code>__construct</code>
+    </UnusedMethodCall>
+  </file>
   <file src="src/Uuid.php">
     <ImpureMethodCall occurrences="6">
       <code>getFactory</code>
@@ -117,6 +147,9 @@
       <code>getFactory</code>
       <code>getFactory</code>
     </ImpureMethodCall>
+    <UnusedMethodCall occurrences="1">
+      <code>unserialize</code>
+    </UnusedMethodCall>
   </file>
   <file src="src/UuidFactory.php">
     <ImpurePropertyFetch occurrences="7">

src/Fields/SerializableFieldsTrait.php

@@ -14,7 +14,10 @@
 
 namespace Ramsey\Uuid\Fields;
 
+use ValueError;
+
 use function base64_decode;
+use function sprintf;
 use function strlen;
 
 /**
@@ -42,6 +45,14 @@ public function serialize(): string
         return $this->getBytes();
     }
 
+    /**
+     * @return array{bytes: string}
+     */
+    public function __serialize(): array
+    {
+        return ['bytes' => $this->getBytes()];
+    }
+
     /**
      * Constructs the object from a serialized string representation
      *
@@ -58,4 +69,18 @@ public function unserialize($serialized): void
             $this->__construct(base64_decode($serialized));
         }
     }
+
+    /**
+     * @param array{bytes: string} $data
+     */
+    public function __unserialize(array $data): void
+    {
+        // @codeCoverageIgnoreStart
+        if (!isset($data['bytes'])) {
+            throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__));
+        }
+        // @codeCoverageIgnoreEnd
+
+        $this->unserialize($data['bytes']);
+    }
 }

src/Lazy/LazyUuidFromString.php

@@ -24,10 +24,12 @@
 use Ramsey\Uuid\Type\Integer as IntegerObject;
 use Ramsey\Uuid\UuidFactory;
 use Ramsey\Uuid\UuidInterface;
+use ValueError;
 
 use function assert;
 use function bin2hex;
 use function hex2bin;
+use function sprintf;
 use function str_replace;
 use function substr;
 
@@ -90,6 +92,16 @@ public function serialize(): string
         return $this->uuid;
     }
 
+    /**
+     * @return array{string: string}
+     *
+     * @psalm-return array{string: non-empty-string}
+     */
+    public function __serialize(): array
+    {
+        return ['string' => $this->uuid];
+    }
+
     /**
      * {@inheritDoc}
      *
@@ -102,6 +114,22 @@ public function unserialize($serialized): void
         $this->uuid = $serialized;
     }
 
+    /**
+     * @param array{string: string} $data
+     *
+     * @psalm-param array{string: non-empty-string} $data
+     */
+    public function __unserialize(array $data): void
+    {
+        // @codeCoverageIgnoreStart
+        if (!isset($data['string'])) {
+            throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__));
+        }
+        // @codeCoverageIgnoreEnd
+
+        $this->unserialize($data['string']);
+    }
+
     /** @psalm-suppress DeprecatedMethod */
     public function getNumberConverter(): NumberConverterInterface
     {

src/Type/Decimal.php

@@ -15,8 +15,10 @@
 namespace Ramsey\Uuid\Type;
 
 use Ramsey\Uuid\Exception\InvalidArgumentException;
+use ValueError;
 
 use function is_numeric;
+use function sprintf;
 
 /**
  * A value object representing a decimal
@@ -98,6 +100,14 @@ public function serialize(): string
         return $this->toString();
     }
 
+    /**
+     * @return array{string: string}
+     */
+    public function __serialize(): array
+    {
+        return ['string' => $this->toString()];
+    }
+
     /**
      * Constructs the object from a serialized string representation
      *
@@ -110,4 +120,18 @@ public function unserialize($serialized): void
     {
         $this->__construct($serialized);
     }
+
+    /**
+     * @param array{string: string} $data
+     */
+    public function __unserialize(array $data): void
+    {
+        // @codeCoverageIgnoreStart
+        if (!isset($data['string'])) {
+            throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__));
+        }
+        // @codeCoverageIgnoreEnd
+
+        $this->unserialize($data['string']);
+    }
 }

src/Type/Hexadecimal.php

@@ -15,8 +15,10 @@
 namespace Ramsey\Uuid\Type;
 
 use Ramsey\Uuid\Exception\InvalidArgumentException;
+use ValueError;
 
 use function ctype_xdigit;
+use function sprintf;
 use function strpos;
 use function strtolower;
 use function substr;
@@ -77,6 +79,14 @@ public function serialize(): string
         return $this->toString();
     }
 
+    /**
+     * @return array{string: string}
+     */
+    public function __serialize(): array
+    {
+        return ['string' => $this->toString()];
+    }
+
     /**
      * Constructs the object from a serialized string representation
      *
@@ -89,4 +99,18 @@ public function unserialize($serialized): void
     {
         $this->__construct($serialized);
     }
+
+    /**
+     * @param array{string: string} $data
+     */
+    public function __unserialize(array $data): void
+    {
+        // @codeCoverageIgnoreStart
+        if (!isset($data['string'])) {
+            throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__));
+        }
+        // @codeCoverageIgnoreEnd
+
+        $this->unserialize($data['string']);
+    }
 }

src/Type/Integer.php

@@ -15,9 +15,11 @@
 namespace Ramsey\Uuid\Type;
 
 use Ramsey\Uuid\Exception\InvalidArgumentException;
+use ValueError;
 
 use function ctype_digit;
 use function ltrim;
+use function sprintf;
 use function strpos;
 use function substr;
 
@@ -114,6 +116,14 @@ public function serialize(): string
         return $this->toString();
     }
 
+    /**
+     * @return array{string: string}
+     */
+    public function __serialize(): array
+    {
+        return ['string' => $this->toString()];
+    }
+
     /**
      * Constructs the object from a serialized string representation
      *
@@ -126,4 +136,18 @@ public function unserialize($serialized): void
     {
         $this->__construct($serialized);
     }
+
+    /**
+     * @param array{string: string} $data
+     */
+    public function __unserialize(array $data): void
+    {
+        // @codeCoverageIgnoreStart
+        if (!isset($data['string'])) {
+            throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__));
+        }
+        // @codeCoverageIgnoreEnd
+
+        $this->unserialize($data['string']);
+    }
 }