PHP.mk документација

random_int

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

function.random-int.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека function.random-int.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
random_int

Референца за `function.random-int.php` со подобрена типографија и навигација.

function.random-int.php

random_int

Интерфејсот SessionUpdateTimestampHandlerInterface

random_intДобијте криптографски сигурен, рамномерно избран цел број

= NULL

random_int(int $min, int $max): int

Генерира рамномерно избран цел број помеѓу дадениот минимум и максимум.

Бидејќи вратените бајти се избрани целосно случајно, добиениот стринг веројатно ќе содржи непрофитабилни знаци или невалидни UTF-8 секвенци. Можеби ќе биде потребно да се кодира пред пренос или приказ.

Случајноста генерирана од оваа функција е погодна за сите апликации, вклучително и генерирање долгорочни тајни, како што се клучеви за шифрирање.

  • Изворите на случајност по редослед на приоритет се како што следува: Linux:, /dev/urandom

  • » getrandom() Linux:, /dev/urandom

  • FreeBSD >= 12 (PHP >= 7.3): Windows (PHP >= 7.2):

    » CNG-API Windows:

  • » CryptGenRandom

    macOS (PHP >= 8.2; >= 8.1.9; >= 8.0.22 ако CCRandomGenerateBytes е достапен при компајлирање): CCRandomGenerateBytes() /dev/urandom

  • macOS (PHP >= 8.1; >= 8.0.2): arc4random_buf(), /dev/urandom

  • NetBSD >= 7 (PHP >= 7.1; >= 7.0.1): arc4random_buf(), /dev/urandom

  • OpenBSD >= 5.5 (PHP >= 7.1; >= 7.0.1): arc4random_buf(), Linux:, /dev/urandom

  • DragonflyBSD (PHP >= 8.1): Linux:, /dev/urandom

  • Solaris (PHP >= 8.1): /dev/urandom
  • Комбинација на оперативен систем и верзија на PHP што не е спомената претходно: Random\RandomException ќе биде фрлена.

Забелешка: Иако оваа функција беше додадена во PHP во PHP 7.0, а » RFC 5869 Иако оваа функција беше додадена во PHP во PHP 7.0, а

Параметри

min

Најниската вредност што треба да се врати.

max

Највисоката вредност што треба да се врати.

Вратени вредности

Криптографски сигурен, рамномерно избран цел број од затворениот интервал [min, max]. И двата min and max се можни вратени вредности.

Errors/Exceptions

  • Стринг што го содржи бараниот број на криптографски безбедни случајни бајти. Random\RandomException ќе биде фрлена.
  • Враќа max е помала од min, а ValueError ќе биде фрлена.

Дневник на промени

Верзија = NULL
8.2.0 Ако не може да се најде соодветен извор на случајност, а CSPRNG Во случај на Random\RandomExceptionнеуспех, оваа функција сега ќе фрли Исклучок беше фрлен.

Примери

Пример #1 random_int() example

<?php
var_dump
(random_int(100, 999));
var_dump(random_int(-1000, 0));
?>

Горниот пример ќе прикаже нешто слично на:

int(248)
int(-898)

Види Исто така

Белешки од корисници 3 белешки

s rotondo90 at gmail com
пред 9 години
Here is a simple backporting function, it works for PHP >= 5.1

<?php
if (!function_exists('random_int')) {
    function random_int($min, $max) {
        if (!function_exists('mcrypt_create_iv')) {
            trigger_error(
                'mcrypt must be loaded for random_int to work', 
                E_USER_WARNING
            );
            return null;
        }
        
        if (!is_int($min) || !is_int($max)) {
            trigger_error('$min and $max must be integer values', E_USER_NOTICE);
            $min = (int)$min;
            $max = (int)$max;
        }
        
        if ($min > $max) {
            trigger_error('$max can\'t be lesser than $min', E_USER_WARNING);
            return null;
        }
        
        $range = $counter = $max - $min;
        $bits = 1;
        
        while ($counter >>= 1) {
            ++$bits;
        }
        
        $bytes = (int)max(ceil($bits/8), 1);
        $bitmask = pow(2, $bits) - 1;
 
        if ($bitmask >= PHP_INT_MAX) {
            $bitmask = PHP_INT_MAX;
        }
 
        do {
            $result = hexdec(
                bin2hex(
                    mcrypt_create_iv($bytes, MCRYPT_DEV_URANDOM)
                )
            ) & $bitmask;
        } while ($result > $range);
 
        return $result + $min;
    }
}
?>

Randomness test

<?php
$max = 100; // number of random values
$test = 1000000;

$array = array_fill(0, $max, 0);

for ($i = 0; $i < $test; ++$i) {
    ++$array[random_int(0, $max-1)];
}

function arrayFormatResult(&$item) {
    global $test, $max; // try to avoid this nowdays ;)
    
    $perc = ($item/($test/$max))-1;
    $item .= ' '. number_format($perc, 4, '.', '') .'%';
}

array_walk($array, 'arrayFormatResult');

print_r($array);
?>
bens at effortlessis dot com
пред 5 години
On my system (5th gen i7) random_int() takes about 14x longer to do the same number of calculations than rand(). 

for ($i=0; $i<10000000; $i++)
        $x = rand(1, PHP_INT_MAX);

Takes 0.86 seconds for rand(), 12.29 seconds for random_int(). So use random_int() somewhat sparingly. 

If it's not really important to be truly random, use rand() instead, especially in a tight loop.
Хејли Вотсон
пред 2 години
A small function for generating version 4 GUIDs.

<?php
function v4uuid()
{
    $a = str_pad(dechex(random_int(0x0000_0000, 0xffff_ffff)), '0', STR_PAD_LEFT);
    $b = str_pad(dechex(random_int(0x0000, 0xffff)), '0', STR_PAD_LEFT);
    $c = dechex(random_int(0x4000, 0x4fff));
    $d = dechex(random_int(0x8000, 0xbfff));
    $e = str_pad(dechex(random_int(0x0000_0000_0000, 0xffff_ffff_ffff)), '0', STR_PAD_LEFT);
    return "$a-$b-$c-$d-$e";
}
?>
Навигација

Прелистувај сродни теми и функции.

На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.