MongoDB\Driver\ClientEncryption::encrypt

(mongodb >=1.7.0)

MongoDB\Driver\ClientEncryption::encryptEncrypt a value

Descrição

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

Encrypts the value.

Parâmetros

value

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

options

Opções de criptografia
OpçãoTipoDescrição
algorithmstring

O algoritmo de criptografia a ser usado. Esta opção é obrigatória. Especifique uma das seguintes constantes ClientEncryption:

contentionFactorint

O fator de contenção para avaliar consultas com cargas indexadas e criptografadas.

Esta opção só se aplica e só pode ser especificada quando algorithm for MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED ou MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW.

keyAltNamestring

Identifica um documento de coleção de cofres de chaves por keyAltName. Esta opção é mutuamente exclusiva com keyId e exatamente uma é necessária.

keyIdMongoDB\BSON\Binary

Identifica uma chave de dados por _id. O valor é um UUID (subtipo binário 4). Esta opção é mutuamente exclusiva com keyAltName e exatamente uma é necessária.

queryTypestring

O tipo de consulta para avaliar consultas com cargas indexadas e criptografadas. Especifique uma das seguintes constantes ClientEncryption:

Esta opção só se aplica e só pode ser especificada quando algorithm for MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED ou MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW.

rangeOptsarray

Opções de índice para um campo de criptografia consultável compatível com consultas "rangePreview". As opções abaixo devem corresponder aos valores definidos nos encryptedFields da coleção de destino. Para tipos de campo double e decimal128 BSON, min, max e precision devem ser todos definidos ou nenhum definido.

Opções de índice de intervalo
OpçãoTipoDescrição
minmixedObrigatória se precision for definida.
maxmixedObrigatória se precision for definida.
sparsityintObrigatória.
precisionintOpcional. Só pode ser definida para tipos de campo double ou decimal128 BSON.

Valor Retornado

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

Erros/Exceções

Registro de Alterações

VersãoDescrição
PECL mongodb 1.14.0 Added the "contentionFactor" and "queryType" options.

Veja Também

To Top