Issue #8: tests for Uuid module

Author: sergey-dryabzhinsky

README.en.md

@@ -23,6 +23,7 @@ Required modules for full php testing:
   - zstd
   - igbinary
   - msgpack
+  - uuid
 
 Usually they are already installed or "compiled" in php.
 

README.md

@@ -23,6 +23,7 @@
   - snappy
   - igbinary
   - msgpack
+  - uuid
 
 Обычно они уже установлены или "вкомпилированны" в php.
 

UUID.php

@@ -0,0 +1,154 @@
+<?php
+/**
+ * UUID class
+ *
+ * The following class generates VALID RFC 4211 COMPLIANT
+ * Universally Unique IDentifiers (UUID) version 3, 4 and 5.
+ *
+ * UUIDs generated validates using OSSP UUID Tool, and output
+ * for named-based UUIDs are exactly the same. This is a pure
+ * PHP implementation.
+ *
+ * @author Andrew Moore
+ * @link http://www.php.net/manual/en/function.uniqid.php#94959
+ */
+class UUID
+{
+	/**
+	 * Generate v3 UUID
+	 *
+	 * Version 3 UUIDs are named based. They require a namespace (another 
+	 * valid UUID) and a value (the name). Given the same namespace and 
+	 * name, the output is always the same.
+	 * 
+	 * @param	uuid	$namespace
+	 * @param	string	$name
+	 */
+	public static function v3($namespace, $name)
+	{
+		if(!self::is_valid($namespace)) return false;
+
+		// Get hexadecimal components of namespace
+		$nhex = str_replace(array('-','{','}'), '', $namespace);
+
+		// Binary Value
+		$nstr = '';
+
+		// Convert Namespace UUID to bits
+		for($i = 0; $i < strlen($nhex); $i+=2) 
+		{
+			$nstr .= chr(hexdec($nhex[$i].$nhex[$i+1]));
+		}
+
+		// Calculate hash value
+		$hash = md5($nstr . $name);
+
+		return sprintf('%08s-%04s-%04x-%04x-%12s',
+
+		// 32 bits for "time_low"
+		substr($hash, 0, 8),
+
+		// 16 bits for "time_mid"
+		substr($hash, 8, 4),
+
+		// 16 bits for "time_hi_and_version",
+		// four most significant bits holds version number 3
+		(hexdec(substr($hash, 12, 4)) & 0x0fff) | 0x3000,
+
+		// 16 bits, 8 bits for "clk_seq_hi_res",
+		// 8 bits for "clk_seq_low",
+		// two most significant bits holds zero and one for variant DCE1.1
+		(hexdec(substr($hash, 16, 4)) & 0x3fff) | 0x8000,
+
+		// 48 bits for "node"
+		substr($hash, 20, 12)
+		);
+	}
+
+	/**
+	 * 
+	 * Generate v4 UUID
+	 * 
+	 * Version 4 UUIDs are pseudo-random.
+	 */
+	public static function v4() 
+	{
+		return sprintf('%04x%04x-%04x-%04x-%04x-%04x%04x%04x',
+
+		// 32 bits for "time_low"
+		mt_rand(0, 0xffff), mt_rand(0, 0xffff),
+
+		// 16 bits for "time_mid"
+		mt_rand(0, 0xffff),
+
+		// 16 bits for "time_hi_and_version",
+		// four most significant bits holds version number 4
+		mt_rand(0, 0x0fff) | 0x4000,
+
+		// 16 bits, 8 bits for "clk_seq_hi_res",
+		// 8 bits for "clk_seq_low",
+		// two most significant bits holds zero and one for variant DCE1.1
+		mt_rand(0, 0x3fff) | 0x8000,
+
+		// 48 bits for "node"
+		mt_rand(0, 0xffff), mt_rand(0, 0xffff), mt_rand(0, 0xffff)
+		);
+	}
+
+	/**
+	 * Generate v5 UUID
+	 * 
+	 * Version 5 UUIDs are named based. They require a namespace (another 
+	 * valid UUID) and a value (the name). Given the same namespace and 
+	 * name, the output is always the same.
+	 * 
+	 * @param	uuid	$namespace
+	 * @param	string	$name
+	 */
+	public static function v5($namespace, $name) 
+	{
+		if(!self::is_valid($namespace)) return false;
+
+		// Get hexadecimal components of namespace
+		$nhex = str_replace(array('-','{','}'), '', $namespace);
+
+		// Binary Value
+		$nstr = '';
+
+		// Convert Namespace UUID to bits
+		for($i = 0; $i < strlen($nhex); $i+=2) 
+		{
+			$nstr .= chr(hexdec($nhex[$i].$nhex[$i+1]));
+		}
+
+		// Calculate hash value
+		$hash = sha1($nstr . $name);
+
+		return sprintf('%08s-%04s-%04x-%04x-%12s',
+
+		// 32 bits for "time_low"
+		substr($hash, 0, 8),
+
+		// 16 bits for "time_mid"
+		substr($hash, 8, 4),
+
+		// 16 bits for "time_hi_and_version",
+		// four most significant bits holds version number 5
+		(hexdec(substr($hash, 12, 4)) & 0x0fff) | 0x5000,
+
+		// 16 bits, 8 bits for "clk_seq_hi_res",
+		// 8 bits for "clk_seq_low",
+		// two most significant bits holds zero and one for variant DCE1.1
+		(hexdec(substr($hash, 16, 4)) & 0x3fff) | 0x8000,
+
+		// 48 bits for "node"
+		substr($hash, 20, 12)
+		);
+	}
+
+	public static function is_valid($uuid) {
+		return preg_match('/^\{?[0-9a-f]{8}\-?[0-9a-f]{4}\-?[0-9a-f]{4}\-?'.
+                      '[0-9a-f]{4}\-?[0-9a-f]{12}\}?$/i', $uuid) === 1;
+	}
+}
+?>

bench.php

@@ -9,8 +9,8 @@
 #  Company     : Code24 BV, The Netherlands                                    #
 #  Author      : Sergey Dryabzhinsky                                           #
 #  Company     : Rusoft Ltd, Russia                                            #
-#  Date        : Mar 22, 2025                                                  #
-#  Version     : 1.0.58-dev                                                        #
+#  Date        : May 29, 2025                                                  #
+#  Version     : 1.0.59-dev                                                    #
 #  License     : Creative Commons CC-BY license                                #
 #  Website     : https://github.com/rusoft/php-simple-benchmark-script         #
 #  Website     : https://gitea.rusoft.ru/open-source/php-simple-benchmark-script #
@@ -20,7 +20,7 @@
 
 include_once("php-options.php");
 
-$scriptVersion = '1.0.58-dev';
+$scriptVersion = '1.0.59-dev';
 
 // Special string to flush buffers, nginx for example
 $flushStr = '<!-- '.str_repeat(" ", 8192).' -->';
@@ -102,6 +102,12 @@
 if (extension_loaded('intl')) {
 	@include_once("intl.inc");
 }
+if (file_exists('UUID.php') && PHP_VERSION >= '5.0.0') {
+	@include_once("php-uuid.inc");
+}
+if (extension_loaded('uuid')) {
+	@include_once("mod-uuid.inc");
+}
 if (extension_loaded('gd')) {
 	@include_once("php-gd-imagick-common.inc");
 	@include_once("php-gd.inc");
@@ -272,8 +278,9 @@ function print_norm($msg) {
 if (!function_exists('gethostname')) {
 	// 5.3.0+ only
 	function gethostname() {
-		on_start();
+		ob_start();
 		$last_str = system(`hostname -f`, $errcode);
+		ob_end_clean();
 		if ($last_str !== false) {
 			return $last_str;
 		}
@@ -406,7 +413,7 @@ function gethostname() {
 						. PHP_EOL
 						. '	-h|--help		- print this help and exit' . PHP_EOL
 						. '	-x|--debug		- enable debug mode, raise output level' . PHP_EOL
-						. '	-C|--dont-use-colors	- disable printing html-span or color sequences for capable terminal: xterm, *-color, *-256color. And not in JSON/machine mode.' . PHP_EOL
+						. '	-C|--dont-use-colors	- disable printing html-span or color sequences for capable terminal: xterm, *-color, *-256color. And not use it in JSON/machine mode.' . PHP_EOL
 						. '	-J|--print-json	- enable printing only in JSON format, useful for automated tests. disables print-machine.' . PHP_EOL
 						. '	-M|--print-machine	- enable printing only in machine parsable format, useful for automated tests. disables print-json.' . PHP_EOL
 						. '	-d|--dont-recalc	- do not recalculate test times / operations count even if memory of execution time limits are low' . PHP_EOL
@@ -429,7 +436,7 @@ function gethostname() {
 						. PHP_EOL
 						. '	-h		- print this help and exit' . PHP_EOL
 						. '	-x		- enable debug mode, raise output level' . PHP_EOL
-						. '	-C		- disable printing html-span or color sequences for capable terminal: xterm, *-color, *-256color. And not in JSON/machine mode.' . PHP_EOL
+						. '	-C		- disable printing html-span or color sequences for capable terminal: xterm, *-color, *-256color. And not use it in JSON/machine mode.' . PHP_EOL
 						. '	-J		- enable printing only in JSON format, useful for automated tests. disables print-machine.' . PHP_EOL
 						. '	-M		- enable printing only in machine parsable format, useful for automated tests. disables print-json.' . PHP_EOL
 						. '	-d		- do not recalculate test times / operations count even if memory of execution time limits are low' . PHP_EOL
@@ -742,6 +749,8 @@ function gethostname() {
 	'36_brotli_compress'	=> 1000000,
 	'37_01_php8_str_ccontains' => 100000,
 	'37_02_php8_str_ccontains_simulate' => 100000,
+	'38_01_php_uuid'	=> 1000000,
+	'38_02_mod_uuid'	=> 1000000,
 );
 // Should not be more than X Mb
 // Different PHP could use different amount of memory
@@ -798,6 +807,8 @@ function gethostname() {
 	'36_brotli_compress'		=> 4,
 	'37_01_php8_str_ccontains' => 4,
 	'37_02_php8_str_ccontains_simulate' => 4,
+	'38_01_php_uuid'		=> 4,
+	'38_02_mod_uuid'		=> 4,
 );
 
 /** ---------------------------------- Common functions -------------------------------------------- */
@@ -1657,6 +1668,11 @@ function format_result_test($diffSeconds, $opCount, $memory = 0)
 	$has_brotli = "{$colorGreen}yes{$colorReset}";
 }
 
+$has_uuid = "{$colorYellow}no{$colorReset}";
+if (extension_loaded('uuid')) {
+	$has_uuid = "{$colorGreen}yes{$colorReset}";
+}
+
 $has_jsond = "{$colorYellow}no{$colorReset}";
 $has_jsond_as_json = "{$colorYellow}no{$colorReset}";
 if ($jsond = extension_loaded('jsond')) {
@@ -1679,7 +1695,7 @@ function print_results_common()
 	global $line, $padHeader, $cpuInfo, $padInfo, $scriptVersion, $maxTime, $originTimeLimit, $originMemoryLimit, $cryptAlgoName, $memoryLimitMb;
 	global $flushStr, $has_apc, $has_pcre, $has_intl, $has_json, $has_simplexml, $has_dom, $has_mbstring, $has_opcache, $has_xcache;
 	global $has_gd, $has_imagick, $has_igb, $has_msg, $has_jsond, $has_jsond_as_json;
-	global $has_zlib, $has_gzip, $has_bz2, $has_lz4, $has_snappy, $has_zstd, $has_brotli;
+	global $has_zlib, $has_uuid, $has_gzip, $has_bz2, $has_lz4, $has_snappy, $has_zstd, $has_brotli;
 	global $opcache, $has_eacc, $has_xdebug, $xcache, $apcache, $eaccel, $xdebug, $xdbg_mode, $obd_set, $mbover;
 	global $showOnlySystemInfo, $padLabel, $functions, $runOnlySelectedTests, $selectedTests, $totalOps;
 	global $colorGreen, $colorReset, $colorRed;
@@ -1726,9 +1742,10 @@ function print_results_common()
 		. str_pad("gzip", $padInfo, ' ', STR_PAD_LEFT) . " : $has_gzip\n"
 		. str_pad("bz2", $padInfo, ' ', STR_PAD_LEFT) . " : $has_bz2\n"
 		. str_pad("lz4", $padInfo, ' ', STR_PAD_LEFT) . " : $has_lz4\n"
-   . str_pad("snappy", $padInfo, ' ', STR_PAD_LEFT) . " : $has_snappy\n"
+		. str_pad("snappy", $padInfo, ' ', STR_PAD_LEFT) . " : $has_snappy\n"
 		. str_pad("zstd", $padInfo, ' ', STR_PAD_LEFT) . " : $has_zstd, version:".LIBZSTD_VERSION_STRING."\n"
 		. str_pad("brotli", $padInfo, ' ', STR_PAD_LEFT) . " : $has_brotli\n"
+		. str_pad("uuid", $padInfo, ' ', STR_PAD_LEFT) . " : $has_uuid\n"
 		. str_pad("-affecting->", $padInfo, ' ', STR_PAD_LEFT) . "\n"
 		. str_pad("opcache", $padInfo, ' ', STR_PAD_LEFT) . " : $has_opcache; enabled: {$opcache}\n"
 		. str_pad("xcache", $padInfo, ' ', STR_PAD_LEFT) . " : $has_xcache; enabled: {$xcache}\n"

mod-uuid.inc

@@ -0,0 +1,26 @@
+<?php
+/**
+ * module Uuuid test functions
+ * Php 5.2+
+ */
+
+/** ---------------------------------- Tests functions -------------------------------------------- */
+
+function test_38_02_mod_uuid()
+{
+	global $stringTest, $emptyResult, $testsLoopLimits, $totalOps;
+
+//	print_r(get_defined_functions());
+	if (!function_exists('uuid_create')) {
+		print("Function don't exists!\n"); 
+		return $emptyResult;
+	}
+
+	$count = $testsLoopLimits['38_02_mod_uuid'];
+	$time_start = get_microtime();
+	for ($i = 0; $i < $count; $i++) {
+		$uuid = uuid_create();
+	}
+	$totalOps += $count;
+	return format_result_test(get_microtime() - $time_start, $count, mymemory_usage());
+}

php-uuid.inc

@@ -0,0 +1,28 @@
+<?php
+/**
+ * php UUID test functions
+ * Php 5.2+
+ */
+
+/** ---------------------------------- Tests functions -------------------------------------------- */
+
+include_once("UUID.php");
+function test_38_01_php_uuid()
+{
+	global $stringTest, $emptyResult, $testsLoopLimits, $totalOps;
+
+//	print_r(get_declared_classes());
+	if (!class_exists('UUID',false)) {
+		print("Class don't exists!\n");
+		return $emptyResult;
+	}
+
+	$count = $testsLoopLimits['38_01_php_uuid'];
+//	print("Count runs: $count");
+	$time_start = get_microtime();
+	for ($i = 0; $i < $count; $i++) {
+		$uuid = UUID::v4();
+	}
+	$totalOps += $count;
+	return format_result_test(get_microtime() - $time_start, $count, mymemory_usage());
+}