v1.0.4

* Add `isBase64Encoded()` method to check for valid base 64 encoded string.

Author: ve3

Rundiz/Serializer/Serializer.php

@@ -14,14 +14,42 @@
  * Works with serialization such as check if string is serialized.
  *
  * @package Serializer
- * @version 1.0.3
+ * @version 1.0.4
  * @author Vee W.
  * @since 1.0
  */
 class Serializer
 {
 
 
+    /**
+     * Check if the given string is valid base 64 encoded.
+     *
+     * @since 1.0.4
+     * @param string $data The value to check.
+     * @return bool Return `true` if valid base 64 encoded, `false` for not.
+     */
+    public function isBase64Encoded($data)
+    {
+        if (!is_string($data)) {
+            // if the value to check is NOT string
+            // Due to base64_decode() on PHP document site require that this argument should be string, if it is not then just return false.
+            return false;
+        }
+
+        $decoded = base64_decode($data, true);
+        if (false === $decoded) {
+            return false;
+        }
+
+        if (false === json_encode([$decoded])) {
+            return false;
+        }
+
+        return true;
+    }// isBase64Encoded
+
+
     /**
      * Check if JSON encoded or valid JSON string.
      * 

Rundiz/Serializer/SerializerStatic.php

@@ -12,6 +12,7 @@
 /**
  * Works with serialize.
  * 
+ * @method bool isBase64Encoded(string $string) Check if string is valid base 64 encoded.
  * @method bool isSerialized(string $string) Check if string is serialized.
  * @method bool isJSONEncoded($data) Check if JSON encoded or valid JSON string.
  * @method string maybeSerialize(mixed $value) Check first that data is serialized or not, if not then serialize it otherwise return as is.

tests/phpunit/isBase64EncodedTest.php

@@ -0,0 +1,95 @@
+<?php
+/**
+ * @license http://opensource.org/licenses/MIT MIT
+ */
+
+
+namespace Rundiz\Serializer\Tests;
+
+class IsBase64EncodedTest extends \PHPUnit\Framework\TestCase
+{
+
+
+    public function testBase64EncodedBoolean()
+    {
+        $Serializer = new \Rundiz\Serializer\Serializer();
+        $this->assertFalse($Serializer->isBase64Encoded(true));
+        $this->assertFalse($Serializer->isBase64Encoded(false));
+        $this->assertFalse(\Rundiz\Serializer\SerializerStatic::isBase64Encoded(true));
+        $this->assertFalse(\Rundiz\Serializer\SerializerStatic::isBase64Encoded(false));
+    }// testBase64EncodedBoolean
+
+
+    public function testBase64EncodedInteger()
+    {
+        $Serializer = new \Rundiz\Serializer\Serializer();
+        $this->assertFalse($Serializer->isBase64Encoded(12345));
+        $this->assertFalse($Serializer->isBase64Encoded(012345));
+        $this->assertFalse($Serializer->isBase64Encoded(555));
+        $this->assertFalse($Serializer->isBase64Encoded(5555));
+        $this->assertFalse($Serializer->isBase64Encoded('12345'));
+        $this->assertTrue($Serializer->isBase64Encoded('NTU1NQ=='));// it is base 64 encoded for '5555'
+        $this->assertFalse(\Rundiz\Serializer\SerializerStatic::isBase64Encoded('12345'));
+        $this->assertTrue(\Rundiz\Serializer\SerializerStatic::isBase64Encoded('NTU1NQ=='));
+    }// testBase64EncodedInteger
+
+
+    public function testBase64EncodedDouble()
+    {
+        $Serializer = new \Rundiz\Serializer\Serializer();
+        $this->assertFalse($Serializer->isBase64Encoded('2345.67'));
+        $this->assertFalse($Serializer->isBase64Encoded('-2345.67'));
+        $this->assertFalse($Serializer->isBase64Encoded(2345.67));
+        $this->assertFalse($Serializer->isBase64Encoded(-2345.67));
+        $this->assertTrue($Serializer->isBase64Encoded('MjM0NS42Nw=='));// it is base 64 encoded for 2345.67
+        $this->assertTrue(\Rundiz\Serializer\SerializerStatic::isBase64Encoded('MjM0NS42Nw=='));
+        $this->assertFalse(\Rundiz\Serializer\SerializerStatic::isBase64Encoded('23456.78'));
+        $this->assertFalse(\Rundiz\Serializer\SerializerStatic::isBase64Encoded('-23456.78'));
+        $this->assertFalse(\Rundiz\Serializer\SerializerStatic::isBase64Encoded(23456.78));
+    }// testBase64EncodedDouble
+
+
+    public function testBase64EncodedString()
+    {
+        $Serializer = new \Rundiz\Serializer\Serializer();
+        $this->assertFalse($Serializer->isBase64Encoded('test'));
+        $this->assertFalse($Serializer->isBase64Encoded('สวัสดี'));
+        $this->assertFalse($Serializer->isBase64Encoded('hello'));
+        $this->assertFalse($Serializer->isBase64Encoded('"hello"'));
+        $this->assertTrue($Serializer->isBase64Encoded('aGVsbG8='));// valid base 64 encoded for 'hello'
+        $this->assertTrue($Serializer->isBase64Encoded('4Liq4Lin4Lix4Liq4LiU4Li1'));// valid base 64 encoded for 'สวัสดี'
+        $this->assertTrue(\Rundiz\Serializer\SerializerStatic::isBase64Encoded('dGVzdA=='));// valid base 64 encoded for 'test'
+        $this->assertTrue($Serializer->isBase64Encoded(''));
+        $this->assertTrue(\Rundiz\Serializer\SerializerStatic::isBase64Encoded(''));
+    }// testBase64EncodedString
+
+
+    public function testBase64EncodedArray()
+    {
+        $Serializer = new \Rundiz\Serializer\Serializer();
+        $this->assertFalse($Serializer->isBase64Encoded(['a' => 'b']));
+        $this->assertFalse(\Rundiz\Serializer\SerializerStatic::isBase64Encoded(['a' => 'b']));
+    }// testBase64EncodedArray
+
+
+    public function testBase64EncodedObject()
+    {
+        $Serializer = new \Rundiz\Serializer\Serializer();
+        $std = new \stdClass();
+        $std->name = 'My Name';
+        $this->assertFalse($Serializer->isBase64Encoded($std));
+        $this->assertFalse(\Rundiz\Serializer\SerializerStatic::isBase64Encoded($std));
+    }// testBase64EncodedObject
+
+
+    public function testBase64EncodedNull()
+    {
+        $Serializer = new \Rundiz\Serializer\Serializer();
+        $this->assertFalse($Serializer->isBase64Encoded('null'));
+        $this->assertFalse($Serializer->isBase64Encoded(null));
+        $this->assertFalse(\Rundiz\Serializer\SerializerStatic::isBase64Encoded('null'));
+        $this->assertFalse(\Rundiz\Serializer\SerializerStatic::isBase64Encoded(null));
+    }// testBase64EncodedNull
+
+
+}