(mongodb >=1.7.0)
MongoDB\Driver\ClientEncryption::encrypt — Шифрует данные
$value, ?array $options = null): MongoDB\BSON\BinaryМетод шифрует данные.
valueЗначение для шифрования. Метод шифрует любые значения, которые вставляются в БД MongoDB.
options
| Опция | Тип | Описание | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| algorithm | string |
Алгоритм шифрования, который будет использоваться. Опция обязательна.
Укажите одну из следующих
констант ClientEncryption:
|
||||||||||||||||||
| contentionFactor | int |
Коэффициент конкуренции для оценки запросов с индексированными
зашифрованными полезными нагрузками.
Опция применяется и может быть указана только тогда, когда
опция algorithm равна
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED
или
MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| keyAltName | string |
Идентифицирует документ коллекции хранилища ключей по keyAltName.
Опция является взаимоисключающей с keyId и требуется ровно один.
|
||||||||||||||||||
| keyId | MongoDB\BSON\Binary |
Идентифицирует ключ данных по _id. Значением является UUID
(двоичный подтип 4). Опция является взаимоисключающей с keyAltName
и требуется ровно один.
|
||||||||||||||||||
| queryType | string |
Тип запроса для оценки запросов с индексированными, зашифрованными
полезными нагрузками. Укажите одну из следующих
констант ClientEncryption:
algorithm равна
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED
или MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| rangeOpts | array |
Опции индекса для шифруемого поля с поддержкой запросов «range».
Параметры, которые приводят следующие абзацы, должны соответствовать значениям, которые установили
в параметре encryptedFields целевой коллекции.
Для BSON-полей с типом double и decimal128 требуется либо установить все опции
min, max и precision, либо все отключить.
|
Метод возвращает зашифрованные данные в виде объекта MongoDB\BSON\Binary с подтипом 6.
| Версия | Описание |
|---|---|
| PECL-модуль mongodb 1.20.0 |
В список опций параметра шифрования rangeOpts добавили опцию
индекса диапазона "trimFactor". Опция диапазона
"sparsity" теперь необязательна.
|
| PECL-модуль mongodb 1.16.0 |
В список параметров шифрования добавили параметр "rangeOpts".
|
| PECL-модуль mongodb 1.14.0 |
В список параметров шифрования добавили параметры
"contentionFactor" и "queryType".
|