sodium_crypto_secretbox

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_secretbox — Шифрування із загальним ключем із автентифікацією

Опис

sodium_crypto_secretbox(string $message, string $nonce, string $key): string

Шифрування повідомлення є симетричним (загальним) ключем.

Список параметрів

message

Текстове повідомлення, яке потрібно зашифрувати.

nonce

Номер, який потрібно використовувати лише один раз для кожного повідомлення. Довжина 24 байти. Це досить велика межа для випадкової генерації (наприклад, random_bytes()

key

Ключ шифрування (256 біт).

Значення, що повертаються

Повертає зашифрований рядок.

Помилки

• Викидається SodiumExceptionякщо довжина байтів параметраnonce відрізняється від SODIUM_CRYPTO_SECRETBOX_NONCEBYTES(24 байти).
• Викидається SodiumExceptionякщо довжина байтів параметраkey відрізняється від SODIUM_CRYPTO_SECRETBOX_KEYBYTES(32 байти).
• Викидає SodiumExceptionв случае возникновения ошибки.

Приклади

Приклад #1 Приклад використання sodium_crypto_secretbox()****

Loading...
▶

Висновок наведеного прикладу буде схожим на:

string(78) "3a1fa3e9f7b72ef8be51d40abf8e296c6899c185d07b18b4c93e7f26aa776d24c50852cd6b1076"
string(23) "message to be encrypted"

Дивіться також

• sodium_crypto_secretbox_open() - Розшифрування з використанням загального ключа з автентичністю
• sodium_crypto_secretbox_keygen() - Створює випадковий ключ для sodium_crypto_secretbox
• random_bytes() - Отримує криптографічно безпечні випадкові байти