(mongodb >=1.7.0)
MongoDB\Driver\ClientEncryption::encrypt — Cifra un valor
$value, ?array $options = null): MongoDB\BSON\BinaryCifra el valor.
valueEl valor a cifrar. Cualquier valor que pueda ser insertado en MongoDB puede ser cifrado utilizando este método.
options
| Opción | Tipo | Descripción | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| algorithm | string |
El algoritmo de cifrado a utilizar. Esta opción es requerida. Especifique una de las siguientes constantes de
ClientEncryption:
|
||||||||||||||||||
| contentionFactor | int |
El factor de contención para evaluar las consultas con cargas útiles cifradas indexadas.
Esta opción se aplica únicamente y solo puede ser especificada cuando
algorithm es
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED o
MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| keyAltName | string |
Identifica un documento de colección de cofre de claves por keyAltName. Esta opción es mutuamente exclusiva
con keyId y una de las dos es requerida.
|
||||||||||||||||||
| keyId | MongoDB\BSON\Binary |
Identifica una clave de datos por _id. El valor es un UUID (subtipo binario 4). Esta opción es mutuamente
exclusiva con keyAltName y una de las dos es requerida.
|
||||||||||||||||||
| queryType | string |
El tipo de consulta para evaluar las consultas con cargas útiles cifradas indexadas. Especifique una de las siguientes constantes de
ClientEncryption:
algorithm es
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED o
MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| rangeOpts | array |
Opciones de índice para un campo de cifrado interrogeable que soporta consultas "range". Las opciones a continuación deben coincidir
con los valores definidos en encryptedFields de la colección objetivo. Para los tipos de campo BSON double y decimal128,
min, max y precision deben ser todos definidos o todos no definidos.
|
Devuelve el valor cifrado como un objeto MongoDB\Driver\ClientEncryption::decrypt() de subtipo 6.
| Versión | Descripción |
|---|---|
| PECL mongodb 1.20.0 |
Se añadió la opción de rango "trimFactor". La opción de rango
"sparsity" es ahora opcional.
|
| PECL mongodb 1.16.0 |
Se añadió la opción "rangeOpts".
|
| PECL mongodb 1.14.0 |
Se añadieron las opciones "contentionFactor" y
"queryType".
|