Add a RequiredPHPVersionException

Author: stloyd

src/core/etl/src/Flow/ETL/Exception/RequiredPHPVersionException.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Flow\ETL\Exception;
+
+final class RequiredPHPVersionException extends RuntimeException
+{
+    public function __construct(string $className, string $version, ?\Exception $previous = null)
+    {
+        parent::__construct(
+            "To use {$className} class, you need to upgrade your PHP version to: {$version}+.",
+            previous: $previous
+        );
+    }
+}

src/core/etl/src/Flow/ETL/Function/HTMLQuerySelector.php

@@ -5,6 +5,7 @@
 namespace Flow\ETL\Function;
 
 use Dom\{Element, HTMLDocument};
+use Flow\ETL\Exception\RequiredPHPVersionException;
 use Flow\ETL\Row;
 
 final class HTMLQuerySelector extends ScalarFunctionChain
@@ -18,7 +19,7 @@ public function __construct(
     public function eval(Row $row) : ?Element
     {
         if (!\class_exists('\Dom\HTMLDocument')) {
-            throw new \RuntimeException('This function requires \Dom\HTMLDocument extension available in PHP 8.4+.');
+            throw new RequiredPHPVersionException('\Dom\HTMLDocument', '8.4');
         }
 
         $value = (new Parameter($this->value))->asInstanceOf($row, HTMLDocument::class);

src/core/etl/src/Flow/ETL/Function/HTMLQuerySelectorAll.php

@@ -5,6 +5,7 @@
 namespace Flow\ETL\Function;
 
 use DOM\{Element, HTMLDocument};
+use Flow\ETL\Exception\RequiredPHPVersionException;
 use Flow\ETL\Row;
 
 final class HTMLQuerySelectorAll extends ScalarFunctionChain
@@ -21,7 +22,7 @@ public function __construct(
     public function eval(Row $row) : ?array
     {
         if (!\class_exists('\Dom\HTMLDocument')) {
-            throw new \RuntimeException('This function requires \Dom\HTMLDocument extension available in PHP 8.4+.');
+            throw new RequiredPHPVersionException('\Dom\HTMLDocument', '8.4');
         }
 
         $value = (new Parameter($this->value))->asInstanceOf($row, HTMLDocument::class);