(mongodb >=1.7.0)
MongoDB\Driver\ClientEncryption::encrypt — Encrypt a value
$value, ?array $options = null): MongoDB\BSON\BinaryEncrypts the value.
valueoptions
| Option | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| algorithm | string |
The encryption algorithm to be used. This option is required.
Specify one of the following
ClientEncryption constants:
|
||||||||||||||||||
| contentionFactor | int |
The contention factor for evaluating queries with indexed, encrypted
payloads.
This option only applies and may only be specified when
algorithm is
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED
or
MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| keyAltName | string |
Identifies a key vault collection document by
keyAltName. This option is mutually exclusive
with keyId and exactly one is required.
|
||||||||||||||||||
| keyId | MongoDB\BSON\Binary |
Identifies a data key by _id. The value is a UUID
(binary subtype 4). This option is mutually exclusive with
keyAltName and exactly one is required.
|
||||||||||||||||||
| queryType | string |
The query type for evaluating queries with indexed, encrypted
payloads. Specify one of the following
ClientEncryption constants:
algorithm is
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED
or MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| rangeOpts | array |
Index options for a queryable encryption field supporting "range"
queries. The options below must match the values set in the
encryptedFields of the target collection. For
double and decimal128 BSON field types, min,
max, and precision must all be
set, or all be unset.
|
Returns the encrypted value as MongoDB\BSON\Binary object with subtype 6.
| Version | Description |
|---|---|
| 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.
|