random_bytes

(PHP 7, PHP 8)

random_bytesGenerates cryptographically secure pseudo-random bytes

Açıklama

random_bytes ( int $length ) : string

Generates an arbitrary length string of cryptographic random bytes that are suitable for cryptographic use, such as when generating salts, keys or initialization vectors.

Bu işlevde kullanılan rasgelelik kaynakları:

  • Windows'ta, daima » CryptGenRandom() kullanılır. PHP 7.2.0 itibariyle, bunun yerine daima » CNG-API kullanılmaktadır.
  • Linux'ta, mümkünse » getrandom(2) sistem çağrısı kullanılır.
  • Diğer sistemlerde, /dev/urandom kullanılır.
  • Yukarıda belirtilen kaynakların hiçbiri kullanılamıyorsa, bir Exception yavrulanır.

Bilginize: Bu işlev PHP'ye PHP 7.0'da eklenmiş olsa da, » kullanıcı alanı gerçeklenimi PHP 5.2'den (dahil) 5.6'ya (dahil) kadar kullanılmıştır.

Değiştirgeler

length

The length of the random string that should be returned in bytes.

Dönen Değerler

Returns a string containing the requested number of cryptographically secure random bytes.

Hatalar/İstisnalar

  • Uygun bir rasgelelik kaynağı bulunamazsa bir Exception yavrulanır.
  • Geçersiz bir değer belirtilirse bir TypeError yavrulanır.
  • If an invalid length of bytes is given, an Error will be thrown.

Örnekler

Örnek 1 random_bytes() example

<?php
$bytes 
random_bytes(5);
var_dump(bin2hex($bytes));
?>

Yukarıdaki örnek şuna benzer bir çıktı üretir:

string(10) "385e33f741"

Ayrıca Bakınız