PHP 8.4.1 Released!

MongoDB\Driver\ClientEncryption::encrypt

(mongodb >=1.7.0)

MongoDB\Driver\ClientEncryption::encryptEncrypt a value

Опис

final public MongoDB\Driver\ClientEncryption::encrypt(mixed $value, ?array $options = null): MongoDB\BSON\Binary

Encrypts the value.

Параметри

value

The value to be encrypted. Any value that can be inserted into MongoDB can be encrypted using this method.

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 потрібно задавати всі або жодного.

Параметри індексу діапазону
Параметр Тип Опис
min mixed Нижня межа діапазону, яка має BSON-значення. Параметр обов'язковий, якщо задано precision.
max mixed Верхня межа діапазону, яка має BSON-значення. Параметр обов'язковий, якщо задано precision.
sparsity int Обов'язковий. Додатнє ціле 64-бітне число.
precision int Необов'язковий. Додатнє ціле 32-бітне число, що вказує точність явного шифрування. Можна задавати тільки для полів з BSON-типами "double" або "decimal128".
trimFactor int Необов'язковий. Додатнє ціле 32-бітне число.

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

Returns the encrypted value as MongoDB\BSON\Binary object with subtype 6.

Помилки/виключення

Журнал змін

Версія Опис
PECL mongodb 1.20.0 Added the "trimFactor" range option. The "sparsity" range option is now optional.
PECL mongodb 1.16.0 Added the "rangeOpts" option.
PECL mongodb 1.14.0 Added the "contentionFactor" and "queryType" options.

Прогляньте також

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top