php8.5
Home/ Manual/ sodium / functions/ sodium_crypto_secretbox_keygen

sodium_crypto_secretbox_keygen

PHP function Edit on GitHub ✎

(PHP 7 >= 7.2.0, PHP 8)

Generate random key for sodium_crypto_secretbox

Description

sodium_crypto_secretbox_keygen(): string

Generate a key for use with sodium_crypto_secretbox() and sodium_crypto_secretbox_open().

Parameters Parameters

Return Values

Returns the generated string of cryptographically secure random bytes.

Examples

sodium_crypto_secretbox_keygen() example

php
<?php
$key = sodium_crypto_secretbox_keygen();
var_dump( sodium_bin2hex( $key ) );
?>

The above example will output something similar to:

output
string(64) "88bd1dc51ec81984f3ddc5a8f59a3d95b647e2da3e879f1b9ceb0abd89e7286c"

Comparing sodium_crypto_secretbox_keygen() with random_bytes()

php
<?php
$key = sodium_crypto_secretbox_keygen();
$bytes = random_bytes( SODIUM_CRYPTO_SECRETBOX_KEYBYTES );
var_dump( mb_strlen( $key, '8bit' ) === mb_strlen( $bytes, '8bit' ) );
?>

The above example will output:

output
bool(true)

See Also

Source: reference/sodium/functions/sodium-crypto-secretbox-keygen.xml · from the official PHP manual (php/doc-en)