Stable release of v3.1.19

We fixed #972 so that custom code (in the header) will be added after the power namespaces. We added a message to show when a server move failed. We fixed the BaseConfig to not use '_' as separator. We fixed the footable loading issue. We removed the need for passing placeholders by reference. We added the option to generate a CHANGELOG. We fixed the server class to load new client if server details changed. We fixed the readme placeholder issue #978. We fixed the empty server url issue #978. Fixed Package import to now use the phplibsec version 3.

libraries/jcb_powers/VDM.Joomla/src/Utilities/ObjectHelper.php

@@ -37,6 +37,42 @@ abstract class ObjectHelper
 
 		return false;
 	}
+
+	/**
+	 * Compare two objects for equality based on their property values.
+	 *
+	 *   Note that this method works only for simple objects that don't
+	 *   contain any nested objects or resource references. If you need
+	 *   to compare more complex objects, you may need to use a
+	 *   more advanced method such as serialization or reflection.
+	 *
+	 * @param object|null $obj1 The first object to compare.
+	 * @param object|null $obj2 The second object to compare.
+	 *
+	 * @return bool True if the objects have the same key-value pairs and false otherwise.
+	 */
+	public static function equal(?object $obj1, ?object $obj2): bool
+	{
+		// if any is null we return false as that means there is a none object
+		// we are not comparing null but objects
+		// but we allow null as some objects while
+		// not instantiate are still null
+		if (is_null($obj1) || is_null($obj2))
+		{
+			return false;
+		}
+
+		// Convert the objects to arrays of their property values using get_object_vars.
+		$array1 = get_object_vars($obj1);
+		$array2 = get_object_vars($obj2);
+
+		// Compare the arrays using array_diff_assoc to detect any differences.
+		$diff1 = array_diff_assoc($array1, $array2);
+		$diff2 = array_diff_assoc($array2, $array1);
+
+		// If the arrays have the same key-value pairs, they will have no differences, so return true.
+		return empty($diff1) && empty($diff2);
+	}
 
 }
 

libraries/jcb_powers/VDM.Joomla/src/Utilities/StringHelper.php

@@ -392,11 +392,12 @@ abstract class StringHelper
 	/**
 	 * Random Key
 	 *
+	 * @input	 int  $size   The size of the random string
+	 *
 	 * @returns a string
-	 * 
 	 * @since  3.0.9
 	 */
-	public static function random($size): string
+	public static function random(int $size): string
 	{
 		$bag = "abcefghijknopqrstuwxyzABCDDEFGHIJKLLMMNOPQRSTUVVWXYZabcddefghijkllmmnopqrstuvvwxyzABCEFGHIJKNOPQRSTUWXYZ";
 		$key = [];