WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru Рекомендуемые продукты со скидкой от Template Monster

wp_rand() WP 2.6.2

Генерирует случайное число между указанных min и max.

C версии 4.4.0 использует PHP7 random_int(), если доступна; или внутренний алгортитм.

Это pluggable функция — т.е. её можно заменить из плагина. Это значит, что она будет работать (подключается) только после подключения всех плагинов, а до этого момента функция еще не определена... Поэтому нельзя вызывать эту и зависящие от неё функции прямо из кода плагина. Их нужно вызывать через хук plugins_loaded или позднее, например хук init.

Замена функции (переопределение) — в плагине можно создать функцию с таким же названием, тогда она заменит текущую функцию.

Является основой для: wp_generate_password()
✈ 1 раз = 0.000032с = очень быстро | 50000 раз = 0.09с = скорость света | PHP 7.0.8, WP 4.6.1

Хуков нет.

Возвращает

Число. Созданное число.

Использование

wp_rand( $min, $max );
$min(число)
Минимальное возможное число.
По умолчанию: 0
$max(число)
Максимальное возможное число.
По умолчанию: 0

Примеры

#1 Получим случайное число

Демонстрация работы функции:

echo wp_rand( 99, 99999 ); // 19899, 85724, 77130, 51575
echo wp_rand( 1.5, 5.5 );  // 5, 1, 3, 4
echo wp_rand( 5, 4 );      // всегда 5

Заметки

  • Global. Строка. $rnd_value
  • Static. Строка. $seed
  • Static. true/false. $use_random_int_functionality

Список изменений

С версии 2.6.2 Введена.
С версии 4.4.0 Uses PHP7 random_int() or the random_compat library if available.

Код wp rand: wp-includes/pluggable.php WP 5.2.4

<?php
function wp_rand( $min = 0, $max = 0 ) {
	global $rnd_value;

	// Some misconfigured 32bit environments (Entropy PHP, for example) truncate integers larger than PHP_INT_MAX to PHP_INT_MAX rather than overflowing them to floats.
	$max_random_number = 3000000000 === 2147483647 ? (float) '4294967295' : 4294967295; // 4294967295 = 0xffffffff

	// We only handle Ints, floats are truncated to their integer value.
	$min = (int) $min;
	$max = (int) $max;

	// Use PHP's CSPRNG, or a compatible method
	static $use_random_int_functionality = true;
	if ( $use_random_int_functionality ) {
		try {
			$_max = ( 0 != $max ) ? $max : $max_random_number;
			// wp_rand() can accept arguments in either order, PHP cannot.
			$_max = max( $min, $_max );
			$_min = min( $min, $_max );
			$val  = random_int( $_min, $_max );
			if ( false !== $val ) {
				return absint( $val );
			} else {
				$use_random_int_functionality = false;
			}
		} catch ( Error $e ) {
			$use_random_int_functionality = false;
		} catch ( Exception $e ) {
			$use_random_int_functionality = false;
		}
	}

	// Reset $rnd_value after 14 uses
	// 32(md5) + 40(sha1) + 40(sha1) / 8 = 14 random numbers from $rnd_value
	if ( strlen( $rnd_value ) < 8 ) {
		if ( defined( 'WP_SETUP_CONFIG' ) ) {
			static $seed = '';
		} else {
			$seed = get_transient( 'random_seed' );
		}
		$rnd_value  = md5( uniqid( microtime() . mt_rand(), true ) . $seed );
		$rnd_value .= sha1( $rnd_value );
		$rnd_value .= sha1( $rnd_value . $seed );
		$seed       = md5( $seed . $rnd_value );
		if ( ! defined( 'WP_SETUP_CONFIG' ) && ! defined( 'WP_INSTALLING' ) ) {
			set_transient( 'random_seed', $seed );
		}
	}

	// Take the first 8 digits for our value
	$value = substr( $rnd_value, 0, 8 );

	// Strip the first eight, leaving the remainder for the next call to wp_rand().
	$rnd_value = substr( $rnd_value, 8 );

	$value = abs( hexdec( $value ) );

	// Reduce the value to be within the min - max range
	if ( $max != 0 ) {
		$value = $min + ( $max - $min + 1 ) * $value / ( $max_random_number + 1 );
	}

	return abs( intval( $value ) );
}

Cвязанные функции

Из метки: Аналоги PHP (замена PHP функций)

Еще из раздела: Вспомогательные

3 коммента
Здравствуйте, !     Войти . Зарегистрироваться