Add toInteger/fromInteger helpers

Author: tvdijen

composer.json

@@ -27,6 +27,7 @@
     },
     "require": {
         "php": "^8.1",
+        "ext-bcmath": "*",
         "ext-date": "*",
         "ext-dom": "*",
         "ext-filter": "*",

src/Type/IntegerValue.php

@@ -5,7 +5,11 @@
 namespace SimpleSAML\XML\Type;
 
 use SimpleSAML\XML\Assert\Assert;
-use SimpleSAML\XML\Exception\SchemaViolationException;
+use SimpleSAML\XML\Exception\{RuntimeException, SchemaViolationException};
+
+use function bccomp;
+use function intval;
+use function strval;
 
 /**
  * @package simplesaml/xml-common
@@ -27,4 +31,33 @@ protected function validateValue(string $value): void
     {
         Assert::validInteger($this->sanitizeValue($value), SchemaViolationException::class);
     }
+
+
+    /**
+     * Convert from integer
+     *
+     * @param int $value
+     * @return static
+     */
+    public static function fromInteger(int $value): static
+    {
+        return new static(strval($value));
+    }
+
+
+    /**
+     * Convert to integer
+     *
+     * @return int
+     */
+    public function toInteger(): int
+    {
+        $value = $this->getValue();
+
+        if (bccomp($value, strval(PHP_INT_MAX)) === 1) {
+            throw new RuntimeException("Cannot convert to integer: out of bounds.");
+        }
+
+        return intval($value);
+    }
 }