Made syntax of URI-safe base64 methods compatible with the built in base64_* methods.

VERSION

@@ -1 +1 @@
-0.2407.311814
+0.2407.311820

src/Serialisation/UriBase64.php

@@ -1,34 +1,32 @@
 <?php
 // UriBase64.php
 // Created: 2022-01-13
-// Updated: 2023-08-03
+// Updated: 2024-07-31
 
 namespace Index\Serialisation;
 
-use Index\IO\Stream;
-
 /**
  * Provides URL-safe Base64 encoding.
  */
 final class UriBase64 {
     /**
-     * Encodes binary data as a Base64 string.
+     * Encodes data with URI-safe MIME base64.
      *
-     * @param string $input Input binary data.
+     * @param string $string The data to encode.
-     * @return string Base64 string representing the binary data.
+     * @return string The encoded data, as a string.
      */
-    public static function encode(mixed $input): string {
+    public static function encode(string $string): string {
-        return rtrim(strtr(base64_encode((string)$input), '+/', '-_'), '=');
+        return rtrim(strtr(base64_encode($string), '+/', '-_'), '=');
     }
 
     /**
-     * Decodes a Base64 string back to binary data.
+     * Decodes data encoded with URI-safe MIME base64.
      *
-     * @param Stream|string $input Input Base64 string.
+     * @param string $string The encoded data.
-     * @return string|false Binary data.
+     * @param bool $strict If the strict parameter is set to true then the base64_decode() function will return false if the input contains character from outside the base64 alphabet. Otherwise invalid characters will be silently discarded.
+     * @return string|false Returns the decoded data or false on failure. The returned data may be binary.
      */
-    public static function decode(Stream|string $input): string|bool {
+    public static function decode(string $string, bool $strict = false): string|false {
-        $input = (string)$input;
+        return base64_decode(str_pad(strtr($string, '-_', '+/'), strlen($string) % 4, '=', STR_PAD_RIGHT));
-        return base64_decode(str_pad(strtr($input, '-_', '+/'), strlen($input) % 4, '=', STR_PAD_RIGHT));
     }
 }