RuntimeConfiguration: Allow opt-in for bool handling (#148)

Co-authored-by: Markus Staab <[email protected]>

Author: staabm

src/QueryReflection/RuntimeConfiguration.php

@@ -8,7 +8,17 @@
 
 final class RuntimeConfiguration
 {
+    /**
+     * methods should return `false` on error.
+     */
+    public const ERROR_MODE_BOOL = 'bool';
+    /**
+     * methods will throw exceptions on errors, therefore will never return `false`.
+     */
     public const ERROR_MODE_EXCEPTION = 'exception';
+    /**
+     * use whatever the current php-src version uses per default.
+     */
     public const ERROR_MODE_DEFAULT = 'default';
 
     /**
@@ -52,6 +62,9 @@ public function throwsPdoExceptions(PhpVersion $phpVersion): bool
         if (self::ERROR_MODE_EXCEPTION === $this->errorMode) {
             return true;
         }
+        if (self::ERROR_MODE_BOOL === $this->errorMode) {
+            return false;
+        }
 
         // since php8 the pdo php-src default error mode changed to exception
         return $phpVersion->getVersionId() >= 80000;
@@ -62,6 +75,9 @@ public function throwsMysqliExceptions(PhpVersion $phpVersion): bool
         if (self::ERROR_MODE_EXCEPTION === $this->errorMode) {
             return true;
         }
+        if (self::ERROR_MODE_BOOL === $this->errorMode) {
+            return false;
+        }
 
         // since php8.1 the mysqli php-src default error mode changed to exception
         return $phpVersion->getVersionId() >= 80100;