(mongodb >=1.16.0)
MongoDB\Driver\ClientEncryption::encryptExpression — Chiffre une expression de correspondance ou d'agrégation
$expr, ?array $options = null): objectChiffre une expression de correspondance ou d'agrégation pour interroger un index de plage.
Pour interroger avec une charge utile chiffrée par plage, l'option de pilote MongoDB\Driver\Manager doit être configurée avec l'option de pilote "autoEncryption". L'option de chiffrement automatique "bypassQueryAnalysis" peut être true. L'option de chiffrement automatique "bypassAutoEncryption" doit être false.
Note: L'extension ne prend pas encore en charge les requêtes de plage pour les types de champ BSON Decimal128.
expr$gt, $gte,
$lt ou $lte. Un opérateur de
comparaison unique est utilisé.
Un exemple d'expression de correspondance prise en charge (s'applique aux requêtes et à l'étape d'agrégation
$match) est le suivant :
[
'$and' => [
[ '<field>' => [ '$gt' => '<value1>' ] ],
[ '<field>' => [ '$lte' => '<value2>' ] ],
],
]
[
'$and' => [
[ '$gte' => [ '<fieldPath>', '<value1>' ] ],
[ '$lt' => [ '<fieldPath>', '<value2>' ] ],
],
]
options
| Option | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| algorithm | string |
L'algorithme de chiffrement à utiliser. Cette option est requise. Spécifiez l'une des constantes suivantes de
ClientEncryption :
|
||||||||||||||||||
| contentionFactor | int |
Le facteur de contention pour évaluer les requêtes avec des charges utiles chiffrées indexées.
Cette option s'applique uniquement et ne peut être spécifiée que lorsque
algorithm est
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED ou
MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| keyAltName | string |
Identifie un document de collection de coffre à clés par keyAltName. Cette option est mutuellement exclusive
avec keyId et l'une des deux est requise.
|
||||||||||||||||||
| keyId | MongoDB\BSON\Binary |
Identifie une clé de données par _id. La valeur est un UUID (sous-type binaire 4). Cette option est mutuellement
exclusive avec keyAltName et l'une des deux est requise.
|
||||||||||||||||||
| queryType | string |
Le type de requête pour évaluer les requêtes avec des charges utiles chiffrées indexées. Spécifiez l'une des constantes suivantes de
ClientEncryption :
algorithm est
MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED ou
MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
|
||||||||||||||||||
| rangeOpts | array |
Options d'index pour un champ de chiffrement interrogeable prenant en charge les requêtes "range". Les options ci-dessous doivent correspondre
aux valeurs définies dans encryptedFields de la collection cible. Pour les types de champ BSON double et decimal128,
min, max et precision doivent être tous définis ou tous non définis.
|
Renvoie l'expression chiffrée en tant qu'objet.
| Version | Description |
|---|---|
| PECL mongodb 1.20.0 |
Ajouté l'option de plage "trimFactor". L'option de plage
"sparsity" est désormais optionnelle.
|