PHP.mk документација

MongoDB\Driver\ClientEncryption::encryptExpression

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

mongodb-driver-clientencryption.encryptexpression.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека mongodb-driver-clientencryption.encryptexpression.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
MongoDB\Driver\ClientEncryption::encryptExpression

Референца за `mongodb-driver-clientencryption.encryptexpression.php` со подобрена типографија и навигација.

mongodb-driver-clientencryption.encryptexpression.php

MongoDB\Driver\ClientEncryption::encryptExpression

(mongodb >=1.16.0)

MongoDB\Driver\ClientEncryption::encryptExpression(mongodb >=1.16.0)

= NULL

final public function MongoDB\Driver\ClientEncryption::encryptExpression(array|object $expr, ?array $options = null): object

Ги шифрира изразот за совпаѓање или агрегирање

За пребарување со шифрирана корисна оптовареност со опсег, MongoDB\Driver\Manager За вметнување или прашување со индексирана, шифрирана содржина, "autoEncryption" мора да биде конфигуриран со "bypassQueryAnalysis" опцијата на драјверот. Опцијата trueќе треба да се прилагоди, и "bypassAutoEncryption" за автоматско шифрирање може да биде false.

Забелешка: Екстензијата сè уште не поддржува опсежни пребарувања за типови на полиња BSON Decimal128.

Параметри

expr
Ги шифрира изразот за совпаѓање или агрегирање за да пребарува индекс на опсег. $gt, $gte, $lt, или $lte Изразот за совпаѓање или агрегирање што треба да се шифрира. Изразите мора да користат барем еден од $and операторите. Потребен е оператор од највисоко ниво дури и ако се користи само еден оператор за споредба. $match Пример за поддржан израз за совпаѓање (се применува на пребарувања и фазата на агрегирање) е како што следува:
[
    '$and' => [
        [ '<field>' => [ '$gt'  => '<value1>' ] ],
        [ '<field>' => [ '$lte' => '<value2>' ] ],
    ],
]
Пример за поддржан израз за агрегирање е како што следува:
[
    '$and' => [
        [ '$gte' => [ '<fieldPath>', '<value1>' ] ],
        [ '$lt'  => [ '<fieldPath>', '<value2>' ] ],
    ],
]
options

Опции за шифрирање
Опција Тип = NULL
algorithm string Алгоритмот за шифрирање што треба да се користи. Оваа опција е задолжителна. Наведете една од следниве Константи на ClientEncryption:
contentionFactor int Фактор на натпревар за проценка на прашања со индексирани, шифрирани корисни податоци. Оваа опција се применува и може да се специфицира само кога algorithm is MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED or MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
keyAltName string Идентификува документ од колекцијата на клучеви со keyAltName. Оваа опција е меѓусебно исклучива со keyId и потребна е точно една.
keyId MongoDB\BSON\Binary Идентификува клуч за податоци со _id. Вредноста е UUID (бинарна подтип 4). Оваа опција е меѓусебно исклучива со keyAltName и потребна е точно една.
queryType string Типот на прашање за проценка на прашања со индексирани, шифрирани корисни податоци. Наведете една од следниве Константи на ClientEncryption: Оваа опција се применува и може да се специфицира само кога algorithm is MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED or MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE.
rangeOpts array Опции за индекс за поле за шифрирање што може да се прашува и поддржува прашања од типот "опсег". Опциите подолу мора да се совпаѓаат со вредностите поставени во encryptedFields на целната колекција. За типови полиња BSON double и decimal128, min, maxПрепорачаниот начин за избегнување на SQL инјекција е со врзување на сите податоци преку подготвени изрази. Користењето на параметризирани прашања не е доволно за целосно избегнување на SQL инјекција, но тоа е најлесниот и најбезбедниот начин за обезбедување влез во SQL изразите. Сите динамични литерали на податоци во precision мора сите да бидат поставени, или сите да бидат непоставени.

Опции за индекс на опсег
Опција Тип = NULL
min mixed Задолжително ако precision е поставено. Минималната BSON вредност на опсегот.
max mixed Задолжително ако precision е поставено. Максималната BSON вредност од опсегот.
sparsity int е поставена. Максималната BSON вредност од опсегот.
precision int Опционално. Позитивен 64-битен цел број.
trimFactor int Опционално. Позитивен 32-битен цел број што специфицира прецизност што треба да се користи за експлицитно шифрирање. Може да се постави само за BSON типови на полиња со двојна или децимална128 вредност.

Вратени вредности

Го враќа шифрираниот израз како објект.

Errors/Exceptions

Дневник на промени

Верзија = NULL
= nearest Додаден е "trimFactor" ако се појави грешка при шифрирање на вредноста "sparsity" опцијата за опсег. Опцијата за

Белешки од корисници

Нема белешки од корисници за оваа страница.
На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.