(mongodb >=1.7.0)
MongoDB\Driver\ClientEncryption::encrypt — Encrypt a value
$value, ?array $options = null): MongoDB\BSON\BinaryEncrypts the value.
valueThe value to be encrypted. Any value that can be inserted into MongoDB can be encrypted using this method.
options| 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 | ||||||||||||||||||
| keyAltName | string | Identifies a key vault collection document by | ||||||||||||||||||
| keyId | MongoDB\BSON\Binary | Identifies a data key by | ||||||||||||||||||
| queryType | string | The query type for evaluating queries with indexed, encrypted payloads. Specify one of the following ClientEncryption constants:
This option only applies and may only be specified when | ||||||||||||||||||
| rangeOpts | array | Index options for a queryable encryption field supporting "range" queries. The options below must match the values set in the
|
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. |