[Mailer][Notifier] Add and use Dsn::getBooleanOption()

Author: OskarStark

CHANGELOG.md

@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+7.3
+---
+
+ * Add `Dsn::getBooleanOption()`
+
 7.2
 ---
 

Tests/Transport/DsnTest.php

@@ -259,4 +259,29 @@ public static function getRequiredOptionThrowsMissingRequiredOptionExceptionProv
             'with_empty_string',
         ];
     }
+
+    /**
+     * @dataProvider getBooleanOptionProvider
+     */
+    public function testGetBooleanOption(bool $expected, string $dsnString, string $option, bool $default)
+    {
+        $dsn = new Dsn($dsnString);
+
+        $this->assertSame($expected, $dsn->getBooleanOption($option, $default));
+    }
+
+    public static function getBooleanOptionProvider(): iterable
+    {
+        yield [true, 'scheme://localhost?enabled=1', 'enabled', false];
+        yield [true, 'scheme://localhost?enabled=true', 'enabled', false];
+        yield [true, 'scheme://localhost?enabled=on', 'enabled', false];
+        yield [true, 'scheme://localhost?enabled=yes', 'enabled', false];
+        yield [false, 'scheme://localhost?enabled=0', 'enabled', false];
+        yield [false, 'scheme://localhost?enabled=false', 'enabled', false];
+        yield [false, 'scheme://localhost?enabled=off', 'enabled', false];
+        yield [false, 'scheme://localhost?enabled=no', 'enabled', false];
+
+        yield [false, 'scheme://localhost', 'not_existant', false];
+        yield [true, 'scheme://localhost', 'not_existant', true];
+    }
 }

Transport/Dsn.php

@@ -93,6 +93,11 @@ public function getRequiredOption(string $key): mixed
         return $this->options[$key];
     }
 
+    public function getBooleanOption(string $key, bool $default = false): bool
+    {
+        return filter_var($this->getOption($key, $default), \FILTER_VALIDATE_BOOLEAN);
+    }
+
     public function getOptions(): array
     {
         return $this->options;