Шифрует данные

Описание

openssl_encrypt ( string $data , string $method , string $key [, int $options = 0 [, string $iv = "" [, string &$tag = NULL [, string $aad = "" [, int $tag_length = 16 ]]]]] ) : string

Шифрует данные с заданным шифром и ключем и возвращает необработанную строку, либо строку кодированную в base64

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

data: Данные для шифрования.
method: Метод шифрования. Список доступных методов можно получить с помощью функции openssl_get_cipher_methods().
key: Ключ.
options: options можно задать одной из констант: OPENSSL_RAW_DATA, OPENSSL_ZERO_PADDING.
iv: Ненулевой инициализирующий вектор.
tag: Тег аутентификации, передаваемый по ссылке, в режиме шифрования AEAD (GCM или CCM).
aad: Дополнительные аутентификационные данные.
tag_length: Длина параметра tag. Для режима GCM должно быть от 4 до 16.

Возвращаемые значения

Возвращает зашифрованную строку или FALSE в случае возникновения ошибки.

Ошибки

Выдает ошибку уровня E_WARNING, если в параметр method передан неизвестный алгоритм шифрования.

Выдает ошибку уровня E_WARNING, если в параметр iv передано пустое значение.

Список изменений

Версия	Описание
7.1.0	Добавлены параметры `tag`, `aad` и `tag_length`.
5.4.0	Параметр `raw_output` изменен на `options`.
5.3.3	Добавлен параметр `iv`.

Примеры

Пример #1 Пример шифрования AES с аутентификацией в режиме GCM в PHP 7.1+


<?php
// $key должен быть сгенерирован заранее криптографически безопасным образом
// например, с помощью openssl_random_pseudo_bytes
$plaintext = "данные для шифрования";
$cipher = "aes-128-gcm";
if (in_array($cipher, openssl_get_cipher_methods()))
{
    $ivlen = openssl_cipher_iv_length($cipher);
    $iv = openssl_random_pseudo_bytes($ivlen);
    $ciphertext = openssl_encrypt($plaintext, $cipher, $key, $options=0, $iv, $tag);
    // сохраняем $cipher, $iv и $tag для дальнейшей расшифровки
    $original_plaintext = openssl_decrypt($ciphertext, $cipher, $key, $options=0, $iv, $tag);
    echo $original_plaintext."\n";
}
?>

Пример #2 Пример шифрования AES с аутентификацией в PHP 5.6+


<?php
// $key должен быть сгенерирован заранее криптографически безопасным образом
// например, с помощью openssl_random_pseudo_bytes
$plaintext = "данные для шифрования";
$ivlen = openssl_cipher_iv_length($cipher="AES-128-CBC");
$iv = openssl_random_pseudo_bytes($ivlen);
$ciphertext_raw = openssl_encrypt($plaintext, $cipher, $key, $options=OPENSSL_RAW_DATA, $iv);
$hmac = hash_hmac('sha256', $ciphertext_raw, $key, $as_binary=true);
$ciphertext = base64_encode( $iv.$hmac.$ciphertext_raw );

// расшифровка....
$c = base64_decode($ciphertext);
$ivlen = openssl_cipher_iv_length($cipher="AES-128-CBC");
$iv = substr($c, 0, $ivlen);
$hmac = substr($c, $ivlen, $sha2len=32);
$ciphertext_raw = substr($c, $ivlen+$sha2len);
$original_plaintext = openssl_decrypt($ciphertext_raw, $cipher, $key, $options=OPENSSL_RAW_DATA, $iv);
$calcmac = hash_hmac('sha256', $ciphertext_raw, $key, $as_binary=true);
if (hash_equals($hmac, $calcmac))// с PHP 5.6+ сравнение, не подверженное атаке по времени
{
    echo $original_plaintext."\n";
}
?>

Смотрите также

openssl_decrypt() - Расшифровывает данные