openssl_decrypt

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

openssl_decrypt - Розшифровує дані

Опис

openssl_decrypt(    string $data,    string $cipher_algo,    string $passphrase,    int $options = 0,    string $iv = "",    ?string $tag = null,    string $aad = ""): string|false

Бере необроблений або кодований у base64 рядок і розшифровує його за допомогою заданого методу та ключа.

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

data

Дані для розшифрування.

cipher_algo

Метод шифрування. Список доступних методів можна отримати за допомогою функції openssl_get_cipher_methods()

passphrase

Ключ.

options

options можна задати одній з констант: OPENSSL_RAW_DATA OPENSSL_ZERO_PADDING

iv

Ненульовий вектор, що ініціалізує.

tag

Тег аутентифікації в режимі шифрування AEAD. Якщо він некоректний, то автентифікація завершиться невдачею та функція поверне false

Застереження

Довжина tag не перевіряється функцією. Сторона, що викликає, несе відповідальність за те, щоб довжина тега відповідала довжині тега, отриманого при виклику openssl_encrypt(). В іншому випадку, дешифрування може бути успішним, якщо цей тег збігається тільки з початком правильного тега.

aad

Додаткові автентифіковані дані.

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

Розшифрований рядок або **false**в случае возникновения ошибки.

Помилки

Видає помилку рівня E_WARNING, якщо параметр cipher_algo передано невідомий алгоритм шифрування.

Видає помилку рівня E_WARNING, якщо параметр ivпередано пустое значение.

список змін

ВерсияОпис
8.1.0Параметрtag тепер допускає значення null.
7.1.0Додані параметри tagиaad

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