diff --git a/language-snippets.ent b/language-snippets.ent index 06d33c3ec2..e6003b54df 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,7 +1,6 @@ - + - @@ -3449,23 +3448,82 @@ xmlns="http://docbook.org/ns/docbook">TRADER_REAL_MIN до TRADER_REAL_MAX.'> - - + + + + PECL-модуль mongodb 2.0.0 + + Класс удалили. + + +'> + + + PECL-модуль mongodb 2.0.0 + + Функцию удалили. + + +'> + + + PECL-модуль mongodb 2.0.0 + + Метод удалили. + + +'> + + + PECL-модуль mongodb 2.0.0 + + + Класс больше не реализует интерфейс + Serializable. + + + +'> + - PECL mongodb 1.15.0 + PECL-модуль mongodb 1.15.0 - Типы возвращаемых значений для методов объявлены как предварительные в PHP 8.0 и новее, + Типы значений возврата для интерфейсных методов модуля объявили как предварительные в PHP 8.0 и новее, что вызывает уведомления об устаревании в коде, который реализует этот интерфейс - без объявления соответствующих типов возвращаемых значений. - Атрибут #[ReturnTypeWillChange] добавляют, - чтобы заглушить уведомление об устаревании. + без объявления для значений возврата типов, которые соответствуют типам методов интерфейса. + Уведомление об устаревании заглушают путём добавления + атрибута #[ReturnTypeWillChange]. '> + + PECL-модуль mongodb 2.0.0 + + Типы значений возврата, которые для методов интерфейса прежде объявили предварительными, стали обязательными. + + +'> + + + PECL-модуль mongodb 2.0.0 + + + При вызове для записи без подтверждения метод вместо возврата значения &null; теперь выбрасывает исключение. + + + +'> + collation @@ -4098,8 +4156,9 @@ local: { libbson. '> +При записи без подтверждения метод выбрасывает исключение MongoDB\Driver\Exception\LogicException.'> - + - - - Флаги - - - - Флаг - &Description; - - - - - - - - Выравнивание по левому краю в пределах заданной ширины поля; - По умолчанию выравнивание происходит по правому краю. - - - - + - - Печатает плюс + у не отрицательных чисел; - По умолчанию знак печатается только у отрицательных чисел. - - - - (пробел) - - Дополняет результат пробелами. - Это поведение по умолчанию. - - - - 0 - - Дополняет числа нулями (только слева). - Со спецификатором s также может - дополнять нулями справа. - - - - '(символ) - - Дополняет результат символом (символ). - - - - -
- + + Флаги + + + + + + Флаг + &Description; + + + + + - + + Выравнивание по левому краю в пределах заданной ширины поля; + По умолчанию выравнивание происходит по правому краю. + + + + + + + Печатает плюс + у не отрицательных чисел; + По умолчанию знак печатается только у отрицательных чисел. + + + + (пробел) + + Дополняет результат пробелами. + Это поведение по умолчанию. + + + + 0 + + Дополняет числа нулями (только слева). + Со спецификатором s также может + дополнять нулями справа. + + + + '(символ) + + Дополняет результат символом (символ). + + + + + + + Ширина diff --git a/reference/mongodb/bson/binary.xml b/reference/mongodb/bson/binary.xml index e745217d94..992212d105 100644 --- a/reference/mongodb/bson/binary.xml +++ b/reference/mongodb/bson/binary.xml @@ -1,5 +1,5 @@ - + @@ -42,10 +42,6 @@ MongoDB\BSON\Type - - Serializable - - JsonSerializable @@ -241,14 +237,15 @@ + &mongodb.changelog.serializable-interface-removed; - PECL mongodb 1.17.0 + PECL-модуль mongodb 1.17.0 Добавили тип MongoDB\BSON\Binary::TYPE_SENSITIVE. - PECL mongodb 1.12.0 + PECL-модуль mongodb 1.12.0 Реализовали интерфейс Stringable для PHP 8.0+. @@ -259,19 +256,19 @@ - PECL mongodb 1.7.0 + PECL-модуль mongodb 1.7.0 Добавили тип MongoDB\BSON\Binary::TYPE_ENCRYPTED. - PECL mongodb 1.3.0 + PECL-модуль mongodb 1.3.0 Реализовали интерфейс MongoDB\BSON\BinaryInterface. - PECL mongodb 1.2.0 + PECL-модуль mongodb 1.2.0 Реализовали интерфейсы Serializable и JsonSerializable. diff --git a/reference/mongodb/bson/binaryinterface.xml b/reference/mongodb/bson/binaryinterface.xml index 3f44fea602..71ff526680 100644 --- a/reference/mongodb/bson/binaryinterface.xml +++ b/reference/mongodb/bson/binaryinterface.xml @@ -1,7 +1,6 @@ - + - Интерфейс MongoDB\BSON\BinaryInterface @@ -42,6 +41,7 @@ + &mongodb.changelog.tentative-return-types-enforced; &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/bson/dbpointer.xml b/reference/mongodb/bson/dbpointer.xml index 6939efddee..021781de2f 100644 --- a/reference/mongodb/bson/dbpointer.xml +++ b/reference/mongodb/bson/dbpointer.xml @@ -1,5 +1,5 @@ - + @@ -37,10 +37,6 @@ MongoDB\BSON\Type - - Serializable - - JsonSerializable @@ -70,10 +66,11 @@ + &mongodb.changelog.serializable-interface-removed; PECL-модуль mongodb 1.12.0 - Реализует интерфейс Stringable для PHP 8.0+. + Класс теперь реализует интерфейс Stringable для PHP 8.0+. diff --git a/reference/mongodb/bson/decimal128.xml b/reference/mongodb/bson/decimal128.xml index 3f27fa468b..2639d14e29 100644 --- a/reference/mongodb/bson/decimal128.xml +++ b/reference/mongodb/bson/decimal128.xml @@ -1,5 +1,5 @@ - + @@ -14,14 +14,14 @@ Тип BSON для Decimal128 формата с плавающей точкой, - который поддерживает числа до 34 десятичных знаков (то есть значимых - цифр) и диапазон экспонент от -6143 до +6144. + который поддерживает числа до 34 десятичных знаков, или значащих + цифр, и диапазон экспонент от -6143 до +6144. - В отличие от типа double BSON (то есть float в PHP), который хранит только + В отличие от типа double BSON, или тип float в PHP, который хранит только приблизительные значения десятичных значений, тип данных decimal хранит точное значение. Например, MongoDB\BSON\Decimal128('9.99') - имеет точное значение 9ю99, где двойное значение 9ю99 будет иметь приблизительное + содержит точное значение 9.99, где двойное значение 9.99 будет содержать приблизительное значение 9.9900000000000002131628…. &mongodb.note.decimal128; @@ -50,10 +50,6 @@ MongoDB\BSON\Type - - Serializable - - JsonSerializable @@ -83,23 +79,24 @@ + &mongodb.changelog.serializable-interface-removed; - PECL mongodb 1.12.0 + PECL-модуль mongodb 1.12.0 - Реализует интерфейс Stringable для PHP 8.0+. + Класс теперь реализует интерфейс Stringable для PHP 8.0+. - PECL mongodb 1.3.0 + PECL-модуль mongodb 1.3.0 - Реализует интерфейс MongoDB\BSON\Decimal128Interface. + Класс теперь реализует интерфейс MongoDB\BSON\Decimal128Interface. - PECL mongodb 1.2.0 + PECL-модуль mongodb 1.2.0 - Реализует интерфейсы Serializable и - JsonSerializable. + Класс теперь реализует интерфейсы Serializable + и JsonSerializable. diff --git a/reference/mongodb/bson/decimal128interface.xml b/reference/mongodb/bson/decimal128interface.xml index 11644b874e..58bbb84fe3 100644 --- a/reference/mongodb/bson/decimal128interface.xml +++ b/reference/mongodb/bson/decimal128interface.xml @@ -1,7 +1,6 @@ - + - Интерфейс MongoDB\BSON\Decimal128Interface @@ -11,9 +10,9 @@
&reftitle.intro; - Этот интерфейс реализован - MongoDB\BSON\Decimal128, но также может использоваться - в качестве параметра, возвращаемого значения или типа свойства в классах пользовательского пространства. + Интерфейс реализуется классом + MongoDB\BSON\Decimal128, но интерфейсный тип также возможно указать + для параметра, значения возврата или типа свойства в классах пользовательского пространства.
@@ -43,6 +42,7 @@ + &mongodb.changelog.tentative-return-types-enforced; &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/bson/document.xml b/reference/mongodb/bson/document.xml index ea287868cb..9261693eca 100644 --- a/reference/mongodb/bson/document.xml +++ b/reference/mongodb/bson/document.xml @@ -1,5 +1,5 @@ - + @@ -43,10 +43,6 @@ IteratorAggregate - - - Serializable - @@ -69,10 +65,11 @@ + &mongodb.changelog.serializable-interface-removed; - PECL mongodb 1.17.0 + PECL-модуль mongodb 1.17.0 - Реализует MongoDB\BSON\Type. + Класс теперь реализует интерфейс MongoDB\BSON\Type. diff --git a/reference/mongodb/bson/int64.xml b/reference/mongodb/bson/int64.xml index ea3c2f104b..bce2f62877 100644 --- a/reference/mongodb/bson/int64.xml +++ b/reference/mongodb/bson/int64.xml @@ -1,5 +1,5 @@ - + @@ -12,27 +12,27 @@
&reftitle.intro; - Тип BSON для 64-разрядного целого числа. При декодировании BSON - в данные PHP этот класс используется, когда 64-битное целое число - не может быть представлено как целое число PHP на 32-битных платформах. - Эти объекты поддерживают перегруженные + Класс представляет BSON-тип для 64-разрядного целого числа. Объекты класса создают при декодировании BSON-объекта + в PHP-данные, когда 64-битное целое число + невозможно представить как целое PHP-число на 32-битных платформах. + Объекты класса поддерживают перегруженные арифметические, - побитовые операторы и - операторы сравнения. + побитовые операторы + и операторы сравнения. - При работе с необработанными BSON данными с помощью классов + При работе с необработанными BSON-данными через классы MongoDB\BSON\Document, - MongoDB\BSON\PackedArray и - MongoDB\BSON\Iterator, - любое 64-битное целое число будет возвращено как экземпляр этого класса, - независимо от платформы и того, может ли значение быть представлено как целое число PHP. - Это гарантирует, что значения могут быть переданы по кругу без изменения типа. + MongoDB\BSON\PackedArray + и MongoDB\BSON\Iterator + любое 64-битное целое число возвращается как экземпляр этого класса + независимо от платформы и доступности представления значения в виде целого PHP-числа. + Это гарантирует, что значения передаются в обе стороны без изменения типа. - Во время кодирования BSON объекты этого класса будут преобразованы обратно в 64-битный + При кодировании в BSON-объект объекты этого класса преобразовываются обратно в 64-битный целочисленный тип, даже если значение помещается в 32-битное целое число. - Это позволяет явно хранить значения как 64-битные целые числа в BSON. + Это явно сохраняет значения как 64-разрядные целые BSON-числа.
@@ -55,10 +55,6 @@ MongoDB\BSON\Type - - Serializable - - JsonSerializable @@ -88,17 +84,18 @@ + &mongodb.changelog.serializable-interface-removed; - PECL mongodb 1.16.0 + PECL-модуль mongodb 1.16.0 - Теперь класс может быть инициализирован на всех платформах. - Добавлена поддержка перегруженных арифметических, побитовых операторов и операторов сравнения. + Теперь класс доступен для инициализации на всех платформах. + Добавили поддержку перегруженных арифметических, побитовых операторов и операторов сравнения. - PECL mongodb 1.12.0 + PECL-модуль mongodb 1.12.0 - Реализует интерфейс Stringable для PHP 8.0+. + Класс теперь реализует интерфейс Stringable для PHP 8.0+. diff --git a/reference/mongodb/bson/javascript.xml b/reference/mongodb/bson/javascript.xml index 65a9f7dbac..1c584b58a7 100644 --- a/reference/mongodb/bson/javascript.xml +++ b/reference/mongodb/bson/javascript.xml @@ -1,5 +1,5 @@ - + @@ -12,14 +12,14 @@
&reftitle.intro; - Тип BSON для кода Javascript. Может быть указан необязательный документ + Класс представляет BSON-тип для JavaScript-кода. Конструктор класс принимает необязательный документ области видимости, который сопоставляет идентификаторы со значениями и определяет область, в которой код должен оцениваться сервером. - Этот тип BSON в основном используется при выполнении команд базы данных, которые принимают - функцию Javascript в качестве параметра, например + С этим BSON-тип часто работают при выполнении команд базы данных, которые принимают + Javascript-функцию как параметр, например mapReduce. @@ -48,10 +48,6 @@ MongoDB\BSON\Type - - Serializable - - JsonSerializable @@ -81,25 +77,26 @@ + &mongodb.changelog.serializable-interface-removed; - PECL mongodb 1.12.0 + PECL-модуль mongodb 1.12.0 - Реализует интерфейс Stringable для PHP 8.0+. + Класс теперь реализует интерфейс Stringable для PHP 8.0+. - PECL mongodb 1.3.0 + PECL-модуль mongodb 1.3.0 - Реализует интерфейс + Класс теперь реализует интерфейс MongoDB\BSON\JavascriptInterface. - PECL mongodb 1.2.0 + PECL-модуль mongodb 1.2.0 - Реализует интерфейсы - Serializable и - JsonSerializable. + Класс теперь реализует интерфейсы + Serializable + и JsonSerializable. diff --git a/reference/mongodb/bson/javascriptinterface.xml b/reference/mongodb/bson/javascriptinterface.xml index 462d36a240..f0a1e3ef62 100644 --- a/reference/mongodb/bson/javascriptinterface.xml +++ b/reference/mongodb/bson/javascriptinterface.xml @@ -1,7 +1,6 @@ - + - Интерфейс MongoDB\BSON\JavascriptInterface @@ -11,9 +10,9 @@
&reftitle.intro; - Этот интерфейс реализован - MongoDB\BSON\Javascript, но также может использоваться - в качестве параметра, возвращаемого значения или типа свойства в классах пользовательского пространства. + Интерфейс реализуется классом + MongoDB\BSON\Javascript, но интерфейсный тип также возможно указать + для параметра, значения возврата или типа свойства в классах пользовательского пространства.
@@ -43,6 +42,7 @@ + &mongodb.changelog.tentative-return-types-enforced; &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/bson/maxkey.xml b/reference/mongodb/bson/maxkey.xml index d559a8d8e7..ad7db3dd9d 100644 --- a/reference/mongodb/bson/maxkey.xml +++ b/reference/mongodb/bson/maxkey.xml @@ -1,7 +1,6 @@ - + - Класс MongoDB\BSON\MaxKey @@ -13,12 +12,12 @@
&reftitle.intro; - Специальный тип BSON, который сравнивает выше всех других возможных значений - элемента BSON. + Особый BSON-тип, который сравнивается выше остальных возможных значений + BSON-элементов. - Это внутренний тип MongoDB, используемый для индексации и шардинга. + Это внутренний тип СУБД MongoDB для индексации и шардирования.
@@ -46,10 +45,6 @@ MongoDB\BSON\Type - - Serializable - - JsonSerializable @@ -75,17 +70,18 @@ - - PECL mongodb 1.3.0 + &mongodb.changelog.serializable-interface-removed; + + PECL-модуль mongodb 1.3.0 - Реализует интерфейс MongoDB\BSON\MaxKeyInterface. + Класс тепрерь реализует интерфейс MongoDB\BSON\MaxKeyInterface. - PECL mongodb 1.2.0 + PECL-модуль mongodb 1.2.0 - Реализует интерфейсы Serializable и - JsonSerializable. + Класс тепрерь реализует интерфейсы Serializable + и JsonSerializable. diff --git a/reference/mongodb/bson/minkey.xml b/reference/mongodb/bson/minkey.xml index 22df296d9f..fd5eeb2f2b 100644 --- a/reference/mongodb/bson/minkey.xml +++ b/reference/mongodb/bson/minkey.xml @@ -1,7 +1,6 @@ - + - Класс MongoDB\BSON\MinKey @@ -13,12 +12,12 @@
&reftitle.intro; - Специальный тип BSON, который сравнивает ниже всех других возможных значений - элемента BSON. + Особый BSON-тип, который сравнивается ниже остальных возможных значений + BSON-элементов. - Это внутренний тип MongoDB, используемый для индексации и шардинга. + Это внутренний тип СУБД MongoDB для индексации и шардирования.
@@ -46,10 +45,6 @@ MongoDB\BSON\Type - - Serializable - - JsonSerializable @@ -75,17 +70,18 @@ + &mongodb.changelog.serializable-interface-removed; - PECL mongodb 1.3.0 + PECL-модуль mongodb 1.3.0 - Реализует интерфейс MongoDB\BSON\MinKeyInterface. + Класс теперь реализует интерфейс MongoDB\BSON\MinKeyInterface. - PECL mongodb 1.2.0 + PECL-модуль mongodb 1.2.0 - Реализует интерфейсы Serializable и - JsonSerializable. + Класс теперь реализует интерфейсы Serializable + и JsonSerializable. diff --git a/reference/mongodb/bson/objectid.xml b/reference/mongodb/bson/objectid.xml index e3426793a6..4db0a459fb 100644 --- a/reference/mongodb/bson/objectid.xml +++ b/reference/mongodb/bson/objectid.xml @@ -1,5 +1,5 @@ - + @@ -83,10 +83,6 @@ MongoDB\BSON\Type - - Serializable - - JsonSerializable @@ -116,10 +112,11 @@ + &mongodb.changelog.serializable-interface-removed; PECL-модуль mongodb 1.12.0 - В классе реализовали интерфейс Stringable для PHP 8.0+. + Класс теперь реализует интерфейс Stringable для PHP 8.0+. @@ -130,14 +127,14 @@ в MongoDB\BSON\ObjectId. - В классе реализовали интерфейс MongoDB\BSON\ObjectIdInterface. + Класс теперь реализует интерфейс MongoDB\BSON\ObjectIdInterface. PECL-модуль mongodb 1.2.0 - В классе реализовали интерфейсы Serializable + Класс теперь реализует интерфейсы Serializable и JsonSerializable. diff --git a/reference/mongodb/bson/objectidinterface.xml b/reference/mongodb/bson/objectidinterface.xml index 842ca23213..63bd1325fb 100644 --- a/reference/mongodb/bson/objectidinterface.xml +++ b/reference/mongodb/bson/objectidinterface.xml @@ -1,5 +1,5 @@ - + @@ -10,9 +10,9 @@
&reftitle.intro; - Этот интерфейс реализован с помощью - MongoDB\BSON\ObjectId, но также может быть использован для - в качестве параметра, возвращаемого значения или типа свойства в классах пользовательского пространства. + Интерфейс реализуется классом + MongoDB\BSON\ObjectId, но интерфейсный тип также возможно указать + для параметра, значения возврата или типа свойства в классах пользовательского пространства.
@@ -42,6 +42,7 @@ + &mongodb.changelog.tentative-return-types-enforced; &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/bson/packedarray.xml b/reference/mongodb/bson/packedarray.xml index 786e3370e0..dbf8c5440b 100644 --- a/reference/mongodb/bson/packedarray.xml +++ b/reference/mongodb/bson/packedarray.xml @@ -1,5 +1,5 @@ - + @@ -12,8 +12,8 @@
&reftitle.intro; - Класс представляет массив BSON. Класс используется при чтении данных - в виде необработанного BSON и его нельзя модифицировать. + Класс представляет BSON-массив. С классом работают при чтении необработанных двоичных + BSON-данных и объект класса нельзя модифицировать.
@@ -43,10 +43,6 @@ IteratorAggregate - - - Serializable - @@ -69,18 +65,19 @@ + &mongodb.changelog.serializable-interface-removed; - PECL mongodb 1.17.0 + PECL-модуль mongodb 1.17.0 - Реализует MongoDB\BSON\Type. + Класс теперь реализует интерфейс MongoDB\BSON\Type. - PECL mongodb 1.17.0 + PECL-модуль mongodb 1.17.0 - Класс MongoDB\BSON\PackedArray не может быть сериализован в контекстах, - где ожидается BSON-документ. - В предыдущих версиях BSON-массив должен был быть преобразован в документ. + Класс MongoDB\BSON\PackedArray нельзя сериализовать в контекстах, + в которых ожидается BSON-документ. + В предыдущих версиях BSON-массив требовалось преобразовывать в документ. diff --git a/reference/mongodb/bson/regex.xml b/reference/mongodb/bson/regex.xml index 6143426153..623cdda068 100644 --- a/reference/mongodb/bson/regex.xml +++ b/reference/mongodb/bson/regex.xml @@ -1,5 +1,5 @@ - + @@ -12,13 +12,13 @@
&reftitle.intro; - Тип BSON для шаблона регулярного выражения и дополнительные - флаги. + Класс представляет BSON-тип для шаблона регулярного выражения и дополнительных + флагов. - Этот тип BSON в основном используется при запросах к базе данных. В качестве альтернативы - можно использовать оператор запроса + С этим BSON-типом часто работают при запросах к базе данных. Альтернативно + указывают оператор запроса $regex. @@ -47,10 +47,6 @@ MongoDB\BSON\Type - - Serializable - - JsonSerializable @@ -80,23 +76,24 @@ + &mongodb.changelog.serializable-interface-removed; - PECL mongodb 1.12.0 + PECL-модуль mongodb 1.12.0 Реализует интерфейс Stringable для PHP 8.0+. - PECL mongodb 1.3.0 + PECL-модуль mongodb 1.3.0 - Реализует интерфейс MongoDB\BSON\RegexInterface. + Класс теперь реализует интерфейс MongoDB\BSON\RegexInterface. - PECL mongodb 1.2.0 + PECL-модуль mongodb 1.2.0 - Реализует интерфейсы Serializable и - JsonSerializable. + Класс теперь реализует интерфейсы Serializable + и JsonSerializable. diff --git a/reference/mongodb/bson/regexinterface.xml b/reference/mongodb/bson/regexinterface.xml index 7208ac4e63..a4332d863f 100644 --- a/reference/mongodb/bson/regexinterface.xml +++ b/reference/mongodb/bson/regexinterface.xml @@ -1,7 +1,6 @@ - + - Интерфейс MongoDB\BSON\RegexInterface @@ -11,8 +10,8 @@
&reftitle.intro; - Этот интерфейс реализован MongoDB\BSON\Regex, - в качестве параметра, возвращаемого значения или типа свойства в классах пользовательского пространства. + Интерфейс реализуется классом MongoDB\BSON\Regex, но интерфейсный тип также возможно указать + для параметра, значения возврата или типа свойства в классах пользовательского пространства.
@@ -42,6 +41,7 @@ + &mongodb.changelog.tentative-return-types-enforced; &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/bson/serializable.xml b/reference/mongodb/bson/serializable.xml index e7c5d8af9c..8d4c1ac4c4 100644 --- a/reference/mongodb/bson/serializable.xml +++ b/reference/mongodb/bson/serializable.xml @@ -1,7 +1,6 @@ - + - Интерфейс MongoDB\BSON\Serializable @@ -13,8 +12,8 @@
&reftitle.intro; - Классы, которые реализуют этот интерфейс, могут возвращать данные для сериализации - в виде массива BSON или документа вместо открытых свойств объекта. + Классы, которые реализуют этот интерфейс, сами определяют, какие данные возвращать + для сериализации в BSON-массив или BSON-документ вместо открытых свойств объекта.
@@ -57,6 +56,7 @@ + &mongodb.changelog.tentative-return-types-enforced; &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/bson/symbol.xml b/reference/mongodb/bson/symbol.xml index 47ad4e8ae0..da03552de0 100644 --- a/reference/mongodb/bson/symbol.xml +++ b/reference/mongodb/bson/symbol.xml @@ -1,5 +1,5 @@ - + @@ -70,10 +70,11 @@ + &mongodb.changelog.serializable-interface-removed; PECL-модуль mongodb 1.12.0 - Реализует интерфейс Stringable для PHP 8.0+. + Класс теперь реализует интерфейс Stringable для PHP 8.0+. diff --git a/reference/mongodb/bson/timestamp.xml b/reference/mongodb/bson/timestamp.xml index d4eeffbd35..8c3094289c 100644 --- a/reference/mongodb/bson/timestamp.xml +++ b/reference/mongodb/bson/timestamp.xml @@ -1,5 +1,5 @@ - + @@ -12,16 +12,16 @@
&reftitle.intro; - Представляет + Класс представляет метку времени BSON. - Значение состоит из 4-байтовой метки времени (т.е. секунды с начала эпохи) и - 4-байтового приращения. + Значение состоит из 4-байтовой метки времени для представления секунд с начала эпохи + и 4-байтового приращения. - Это внутренний тип MongoDB, используемый для репликации и разделения. Он - не предназначен для общего хранения дат - (вместо него следует использовать MongoDB\BSON\UTCDateTime). + Это внутренний тип СУБД MongoDB для репликации и шардирования. + Тип не предназначен для общего хранения дат, + вместо него лучше использовать класс MongoDB\BSON\UTCDateTime.
@@ -49,10 +49,6 @@ MongoDB\BSON\Type - - Serializable - - JsonSerializable @@ -82,23 +78,24 @@ + &mongodb.changelog.serializable-interface-removed; - PECL mongodb 1.12.0 + PECL-модуль mongodb 1.12.0 - Реализует интерфейс Stringable для PHP 8.0+. + Класс теперь реализует интерфейсStringable для PHP 8.0+. - PECL mongodb 1.3.0 + PECL-модуль mongodb 1.3.0 - Реализует интерфейс MongoDB\BSON\TimestampInterface. + Класс теперь реализует интерфейс MongoDB\BSON\TimestampInterface. - PECL mongodb 1.2.0 + PECL-модуль mongodb 1.2.0 - Реализует интерфейсы Serializable и - JsonSerializable. + Класс теперь реализует интерфейсы Serializable + и JsonSerializable. diff --git a/reference/mongodb/bson/timestampinterface.xml b/reference/mongodb/bson/timestampinterface.xml index ddcbe17c46..d97403a08f 100644 --- a/reference/mongodb/bson/timestampinterface.xml +++ b/reference/mongodb/bson/timestampinterface.xml @@ -1,7 +1,6 @@ - + - Интерфейс MongoDB\BSON\TimestampInterface @@ -11,9 +10,9 @@
&reftitle.intro; - Этот интерфейс реализован с помощью - MongoDB\BSON\Timestamp, но также может использоваться - в качестве параметра, возвращаемого значения или типа свойства в классах пользовательского пространства. + Интерфейс реализуется классом + MongoDB\BSON\Timestamp, но интерфейсный тип также возможно указать + для параметра, значения возврата или типа свойства в классах пользовательского пространства.
@@ -43,6 +42,7 @@ + &mongodb.changelog.tentative-return-types-enforced; &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/bson/undefined.xml b/reference/mongodb/bson/undefined.xml index 7b363e5461..e597b391ba 100644 --- a/reference/mongodb/bson/undefined.xml +++ b/reference/mongodb/bson/undefined.xml @@ -1,5 +1,5 @@ - + @@ -14,7 +14,7 @@ Класс представляет BSON-данные с типом Undefined. Этот BSON-тип устарел, и объекты этого класса нельзя создать. PHP создаст объект этого класса из BSON-типа Undefined - во время преобразования BSON-данных в PHP, а при сохранении документов в базе данных + при преобразовании BSON-данных в PHP, а при сохранении документов в базе данных преобразует объект обратно в BSON-данные.
@@ -71,10 +71,11 @@ + &mongodb.changelog.serializable-interface-removed; - PECL mongodb 1.12.0 + PECL-модуль mongodb 1.12.0 - Реализует интерфейс Stringable для PHP 8.0+. + Класс теперь реализует интерфейс Stringable для PHP 8.0+. diff --git a/reference/mongodb/bson/unserializable.xml b/reference/mongodb/bson/unserializable.xml index fbe0016ce2..a12c05ef23 100644 --- a/reference/mongodb/bson/unserializable.xml +++ b/reference/mongodb/bson/unserializable.xml @@ -1,7 +1,6 @@ - + - Интерфейс MongoDB\BSON\Unserializable @@ -13,9 +12,9 @@
&reftitle.intro; - Классы, которые реализуют этот интерфейс, могут быть указаны в - карте типов для - десериализации массивов и документов BSON (как корневых, так и встроенных). + Классы, которые реализуют этот интерфейс, разрешается указывать + в карте типов + для десериализации BSON-массивов и BSON-документов, как корневых, так и встроенных.
@@ -54,6 +53,7 @@ + &mongodb.changelog.tentative-return-types-enforced; &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/bson/utcdatetime.xml b/reference/mongodb/bson/utcdatetime.xml index f99b3da49d..5237fa2869 100644 --- a/reference/mongodb/bson/utcdatetime.xml +++ b/reference/mongodb/bson/utcdatetime.xml @@ -1,5 +1,5 @@ - + @@ -12,9 +12,9 @@
&reftitle.intro; - Представляет дату BSON. Значение - представляет собой 64-разрядное целое число, представляющее количество миллисекунд с начала - эпохи Unix (1 января 1970 г.). Отрицательные значения представляют даты до 1970 года. + Класс представляет BSON-дату. + Значение — 64-разрядное целое число, которое представляет количество миллисекунд + с 1 января 1970 г. — начала Unix-эпохи. Отрицательные значения представляют даты до 1970 года.
@@ -41,10 +41,6 @@ MongoDB\BSON\Type - - Serializable - - JsonSerializable @@ -74,23 +70,24 @@ + &mongodb.changelog.serializable-interface-removed; - PECL mongodb 1.12.0 + PECL-модуль mongodb 1.12.0 - Реализует интерфейс Stringable для PHP 8.0+. + Класс теперь реализует интерфейс Stringable для PHP 8.0+. - PECL mongodb 1.3.0 + PECL-модуль mongodb 1.3.0 - Реализует интерфейс MongoDB\BSON\UTCDateTimeInterface. + Класс теперь реализует интерфейс MongoDB\BSON\UTCDateTimeInterface. - PECL mongodb 1.2.0 + PECL-модуль mongodb 1.2.0 - Реализует интерфейсы Serializable и - JsonSerializable. + Класс теперь реализует интерфейсы Serializable + и JsonSerializable. diff --git a/reference/mongodb/bson/utcdatetime/construct.xml b/reference/mongodb/bson/utcdatetime/construct.xml index 1f10cfeeca..5858524e2d 100644 --- a/reference/mongodb/bson/utcdatetime/construct.xml +++ b/reference/mongodb/bson/utcdatetime/construct.xml @@ -1,5 +1,5 @@ - + @@ -11,7 +11,7 @@ &reftitle.description; final public MongoDB\BSON\UTCDateTime::__construct - intfloatstringMongoDB\BSON\Int64DateTimeInterfacenullmilliseconds&null; + intMongoDB\BSON\Int64DateTimeInterfacenullmilliseconds&null; @@ -19,7 +19,7 @@ &reftitle.parameters; - milliseconds (intfloatstringDateTimeInterfacenull) + milliseconds (intMongoDB\BSON\Int64DateTimeInterfacenull) Количество миллисекунд с начала Unix-эпохи — 1 января 1970 г. Отрицательные значения @@ -58,6 +58,15 @@ + + PECL-модуль mongodb 2.0.0 + + + Параметр milliseconds больше не принимает + аргументы с типом string или float. + + + PECL-модуль mongodb 1.20.0 diff --git a/reference/mongodb/bson/utcdatetimeinterface.xml b/reference/mongodb/bson/utcdatetimeinterface.xml index 3e7e5266aa..fea58289e3 100644 --- a/reference/mongodb/bson/utcdatetimeinterface.xml +++ b/reference/mongodb/bson/utcdatetimeinterface.xml @@ -1,7 +1,6 @@ - + - Интерфейс MongoDB\BSON\UTCDateTimeInterface @@ -11,9 +10,9 @@
&reftitle.intro; - Этот интерфейс реализован с помощью - MongoDB\BSON\UTCDateTime, но также может использоваться - в качестве параметра, возвращаемого значения или типа свойства в классах пользовательского пространства. + Интерфейс реализуется классом + MongoDB\BSON\UTCDateTime, но интерфейсный тип также возможно указать + для параметра, значения возврата или типа свойства в классах пользовательского пространства.
@@ -43,6 +42,7 @@ + &mongodb.changelog.tentative-return-types-enforced; &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/bson/utcdatetimeinterface/todatetimeimmutable.xml b/reference/mongodb/bson/utcdatetimeinterface/todatetimeimmutable.xml new file mode 100644 index 0000000000..59ba7d5c3f --- /dev/null +++ b/reference/mongodb/bson/utcdatetimeinterface/todatetimeimmutable.xml @@ -0,0 +1,60 @@ + + + + + + MongoDB\BSON\UTCDateTimeInterface::toDateTimeImmutable + Возвращает объект DateTimeImmutable, который представляет объект UTCDateTimeInterface + + + + &reftitle.description; + + abstract public DateTimeImmutableMongoDB\BSON\UTCDateTimeInterface::toDateTimeImmutable + + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Метод возвращает объект DateTimeImmutable, который представляет + объект UTCDateTimeInterface. Объект DateTimeImmutable вернётся + в часовом поясе UTC. + + + + + &reftitle.seealso; + + MongoDB\BSON\UTCDateTime::toDateTimeImmutable + + + + + + diff --git a/reference/mongodb/functions/bson/fromjson.xml b/reference/mongodb/functions/bson/fromjson.xml index 3a5d46a323..197667c1f7 100644 --- a/reference/mongodb/functions/bson/fromjson.xml +++ b/reference/mongodb/functions/bson/fromjson.xml @@ -1,5 +1,5 @@ - + @@ -10,8 +10,8 @@ - Метод УСТАРЕЛ с версии модуля - 1.20.0, а в версии 2.0 метод удалят. Вместо этого метода приложениям лучше вызывать метод + Метод УСТАРЕЛ с модуля версии + 1.20.0, а в версии 2.0 метод удалили. Вместо этого метода приложениям лучше вызывать метод MongoDB\BSON\Document::fromJSON. @@ -62,6 +62,25 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.function-removed; + + + + + + &reftitle.examples; diff --git a/reference/mongodb/functions/bson/fromphp.xml b/reference/mongodb/functions/bson/fromphp.xml index 95fe175985..a6a23fe57c 100644 --- a/reference/mongodb/functions/bson/fromphp.xml +++ b/reference/mongodb/functions/bson/fromphp.xml @@ -1,5 +1,5 @@ - + @@ -11,8 +11,8 @@ - Метод УСТАРЕЛ с версии модуля - 1.20.0, а в версии 2.0 метод удалят. Вместо этого метода приложениям лучше вызывать метод + Метод УСТАРЕЛ с модуля версии + 1.20.0, а в версии 2.0 метод удалили. Вместо этого метода приложениям лучше вызывать метод MongoDB\BSON\Document::fromPHP. @@ -67,6 +67,25 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.function-removed; + + + + + + &reftitle.examples; diff --git a/reference/mongodb/functions/bson/tocanonicalextendedjson.xml b/reference/mongodb/functions/bson/tocanonicalextendedjson.xml index 8a3ae6452a..009959458a 100644 --- a/reference/mongodb/functions/bson/tocanonicalextendedjson.xml +++ b/reference/mongodb/functions/bson/tocanonicalextendedjson.xml @@ -1,5 +1,5 @@ - + @@ -10,8 +10,8 @@ - Метод УСТАРЕЛ с версии модуля - 1.20.0, а в версии 2.0 метод удалят. Вместо этого метода приложениям лучше вызывать метод + Метод УСТАРЕЛ с модуля версии + 1.20.0, а в версии 2.0 метод удалили. Вместо этого метода приложениям лучше вызывать метод MongoDB\BSON\Document::toCanonicalExtendedJSON. @@ -61,6 +61,25 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.function-removed; + + + + + + &reftitle.examples; diff --git a/reference/mongodb/functions/bson/tojson.xml b/reference/mongodb/functions/bson/tojson.xml index 70003a611d..20dfe1cea7 100644 --- a/reference/mongodb/functions/bson/tojson.xml +++ b/reference/mongodb/functions/bson/tojson.xml @@ -1,7 +1,6 @@ - + - MongoDB\BSON\toJSON @@ -11,8 +10,8 @@ - Метод УСТАРЕЛ с версии модуля - 1.20.0, а в версии 2.0 метод удалят. Вместо этого метода приложениям лучше вызывать метод + Метод УСТАРЕЛ с модуля версии + 1.20.0, а в версии 2.0 метод удалили. Вместо этого метода приложениям лучше вызывать метод MongoDB\BSON\Document::toCanonicalExtendedJSON или MongoDB\BSON\Document::toRelaxedExtendedJSON. @@ -86,6 +85,25 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.function-removed; + + + + + + &reftitle.examples; diff --git a/reference/mongodb/functions/bson/tophp.xml b/reference/mongodb/functions/bson/tophp.xml index 5f0f120741..14ad8a8b3b 100644 --- a/reference/mongodb/functions/bson/tophp.xml +++ b/reference/mongodb/functions/bson/tophp.xml @@ -1,5 +1,5 @@ - + @@ -10,8 +10,8 @@ - Метод УСТАРЕЛ с версии модуля - 1.20.0, а в версии 2.0 метод удалят. Вместо этого метода приложениям лучше вызывать метод + Метод УСТАРЕЛ с модуля версии + 1.20.0, а в версии 2.0 метод удалили. Вместо этого метода приложениям лучше вызывать метод MongoDB\BSON\Document::toPHP. @@ -39,7 +39,7 @@ bson (string) - Значение BSON для десериализации. + BSON-значение для десериализации. @@ -79,6 +79,7 @@ + &mongodb.changelog.function-removed; PECL-модуль mongodb 1.4.0 diff --git a/reference/mongodb/functions/bson/torelaxedextendedjson.xml b/reference/mongodb/functions/bson/torelaxedextendedjson.xml index 23bdf809b8..d4cbe18282 100644 --- a/reference/mongodb/functions/bson/torelaxedextendedjson.xml +++ b/reference/mongodb/functions/bson/torelaxedextendedjson.xml @@ -1,5 +1,5 @@ - + @@ -10,8 +10,8 @@ - Метод УСТАРЕЛ с версии модуля - 1.20.0, а в версии 2.0 метод удалят. Вместо этого метода приложениям лучше вызывать метод + Метод УСТАРЕЛ с модуля версии + 1.20.0, а в версии 2.0 метод удалили. Вместо этого метода приложениям лучше вызывать метод MongoDB\BSON\Document::toRelaxedExtendedJSON. @@ -62,6 +62,25 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.function-removed; + + + + + + &reftitle.examples; diff --git a/reference/mongodb/mongodb/driver/clientencryption.xml b/reference/mongodb/mongodb/driver/clientencryption.xml index 9189f5d33f..949abb560a 100644 --- a/reference/mongodb/mongodb/driver/clientencryption.xml +++ b/reference/mongodb/mongodb/driver/clientencryption.xml @@ -1,5 +1,5 @@ - + @@ -67,12 +67,6 @@ MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE Range - - const - string - MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW - RangePreview - const string @@ -85,12 +79,6 @@ MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE range - - const - string - MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW - rangePreview - &Methods; @@ -168,13 +156,6 @@ - - MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW - - Эту константу объявили устаревшей и удалят в будущей основной версии. - - - MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY @@ -195,13 +176,6 @@ - - MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW - - Эту константу объявили устаревшей и удалят в будущей основной версии. - - -
@@ -219,27 +193,36 @@ - PECL mongodb 1.20.0 + PECL-модуль mongodb 2.0.0 + + + Удалили константы MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW + и MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW. + + + + + PECL-модуль mongodb 1.20.0 Добавили опции MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE и MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE. - Объявили устаревшими опции MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW - и MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW. + Опции MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW + и MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW устарели. - PECL mongodb 1.16.0 + PECL-модуль mongodb 1.16.0 Добавили константы MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW и MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW. - PECL mongodb 1.14.0 + PECL-модуль mongodb 1.14.0 Добавили опции MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED, MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED, diff --git a/reference/mongodb/mongodb/driver/cursor.xml b/reference/mongodb/mongodb/driver/cursor.xml index a856f81271..5b025f51a2 100644 --- a/reference/mongodb/mongodb/driver/cursor.xml +++ b/reference/mongodb/mongodb/driver/cursor.xml @@ -1,7 +1,6 @@ - + - Класс MongoDB\Driver\Cursor @@ -38,10 +37,6 @@ MongoDB\Driver\CursorInterface - - - Iterator - @@ -65,15 +60,15 @@ - PECL mongodb 1.9.0 + PECL-модуль mongodb 1.9.0 - Реализует Iterator. + Класс теперь реализует интерфейс Iterator. - PECL mongodb 1.6.0 + PECL-модуль mongodb 1.6.0 - Реализует MongoDB\Driver\CursorInterface, который наследует Traversable. + Класс теперь реализует интерфейс MongoDB\Driver\CursorInterface, который наследует Traversable. @@ -88,14 +83,14 @@ Reading a result set - Как MongoDB\Driver\Manager::executeCommand, так - MongoDB\Driver\Manager::executeQuery, возвращают - свои результаты в виде объекта MongoDB\Driver\Cursor. + Методы MongoDB\Driver\Manager::executeCommand + и MongoDB\Driver\Manager::executeQuery возвращают + результаты в виде объекта MongoDB\Driver\Cursor. - Поскольку MongoDB\Driver\Cursor реализует интерфейс - Traversable, вы можете - итерировать по набору результата с помощью + Поскольку класс MongoDB\Driver\Cursor реализует интерфейс + Traversable, программистам доступна + итерация по набору результата конструкцией foreach. @@ -157,32 +152,32 @@ stdClass Object Чтение набора результатов для хвостового курсора - Хвостовые курсоры - - - это особый тип курсора MongoDB, который позволяет клиенту читать некоторые результаты, + Хвостовые курсоры — + особый тип курсора СУБД MongoDB, который разрешает клиенту читать отдельные результаты, а затем ждать, пока не появятся дополнительные документы. - Эти курсоры в основном используются с - Capped Collections + Эти курсоры часто используются + с Capped Collections и Change Streams. - Хотя обычные курсоры можно итерировать один раз с помощью foreach, - этот подход не будет работать с хвостовыми курсорами. - Когда foreach используется с хвостовым курсором, - цикл останавливается по достижении конца начального набора результатов. + Хотя стандартные курсоры возможно перебрать конструкцией foreach один раз, + этот подход не сработает с хвостовыми курсорами. + Цикл останавливается по достижении конца начального набора результатов, + когда хвостовой курсор перебирают конструкцией foreach. Попытка продолжить итерацию курсора со вторым foreach выбросить исключение, поскольку PHP пытается перемотать курсор. Подобно объектам результатов в других драйверах баз данных, - курсоры в MongoDB поддерживают только итерацию вперёд, что означает, что они не могут быть перемотаны. + курсоры в СУБД MongoDB поддерживают только продвижение вперёд, поэтому их нельзя перемотать. - Для непрерывного считывания с хвостового курсора объект курсора должен быть завернут - с помощью IteratorIterator. Это позволяет приложению напрямую управлять + Для непрерывного считывания с хвостового курсора объект курсора заворачивают + в объект IteratorIterator. Это разрешает приложению напрямую управлять итерацией курсора, избегать непреднамеренного перемотки курсора и решать, когда ждать новых результатов - или полностью прекратить итерацию. + или прекратить итерацию. - Чтобы продемонстрировать хвостовой курсор в действии, - будут использоваться два скрипта: "производитель" (producer) и "потребитель" (consumer). - Скрипт продюсера создаст новую capped-коллекцию, используя команду + Продемонстрируем хвостовой курсор в действии, + для этого напишем два скрипта: «производитель» (producer) и «потребитель» (consumer). + Скрипт продюсера создаст новую capped-коллекцию командой create и начнёт вставку нового документа в эту коллекцию каждую секунду. @@ -210,11 +205,11 @@ while (true) { ]]> - Когда скрипт продюсера (producer) всё ещё запущен, - может быть выполнен второй пользовательский скрипт для чтения вставленных документов + Пока скрипт продюсера (producer) запущен, + выполняют второй пользовательский скрипт для чтения вставленных документов с помощью хвостового (tailable) курсора, обозначенного параметрами tailable и awaitData - для MongoDB\Driver\Query::__construct. + в методе MongoDB\Driver\Query::__construct. Пользовательский скрипт начнёт с быстрой печати всех доступных документов - в заблокированной коллекции (как если бы использовался foreach); - однако при достижении конца начального набора результатов он не завершится. - Так как курсор является хвостовым, вызов IteratorIterator::valid + в заблокированной коллекции, как если бы коллекцию перебирали конструкцией foreach; + но при достижении конца начального набора результатов перебор не завершится. + Поскольку курсор хвостовой, вызов метода IteratorIterator::valid будет блокировать и ждать дополнительных результатов. - IteratorIterator::valid также используется для проверки наличия на - каждом этапе данных, доступных для чтения. + Метод IteratorIterator::valid также используется для проверки наличия + на каждом этапе данных, доступных для чтения. @@ -271,14 +266,14 @@ while (true) {
&reftitle.errors; - При итерации по объекту курсора данные BSON преобразуются в переменные PHP. - Эта итерация может вызвать следующие исключения: + При итерации по объекту курсора BSON-данные преобразовываются в PHP-переменные. + Эта итерация иногда вызывает следующие исключения: - Выбрасывает + Выбрасывает исключение MongoDB\Driver\Exception\InvalidArgumentException, - если класс на карте типов не может быть создан или не реализует + если невозможно создать класс на карте типов или класс не реализует интерфейс MongoDB\BSON\Unserializable. &mongodb.throws.bson.unexpected; diff --git a/reference/mongodb/mongodb/driver/cursor/getid.xml b/reference/mongodb/mongodb/driver/cursor/getid.xml index d95fbcd858..a54b24fe74 100644 --- a/reference/mongodb/mongodb/driver/cursor/getid.xml +++ b/reference/mongodb/mongodb/driver/cursor/getid.xml @@ -1,7 +1,6 @@ - + - MongoDB\Driver\Cursor::getId @@ -11,22 +10,13 @@ &reftitle.description; - final public MongoDB\Driver\CursorIdMongoDB\BSON\Int64MongoDB\Driver\Cursor::getId - + final public MongoDB\BSON\Int64MongoDB\Driver\Cursor::getId + Метод возвращает идентификатор текущего курсора. На сервере каждому курсору присваивается уникальный идентификатор. - - - Возврат объекта MongoDB\Driver\CursorId из метода - УСТАРЕЛ с версии модуля - 1.20.0. В версии 2.0 параметр asInt64 удалят, - а метод будет возвращать объект - MongoDB\BSON\Int64. - - @@ -38,10 +28,7 @@ &reftitle.returnvalues; Метод возвращает идентификатор текущего курсора. Метод вернёт идентификатор - как объект MongoDB\BSON\Int64, если для параметра - asInt64 установили значение &true;, - иначе вернёт объект MongoDB\Driver\CursorId - и выдаст уведомление об устаревании. + как объект MongoDB\BSON\Int64. @@ -64,6 +51,13 @@ + + PECL-модуль mongodb 2.0.0 + + Тип значения возврата изменили на MongoDB\BSON\Int64. + Параметр asInt64 удалили. + + PECL-модуль mongodb 1.20.0 @@ -122,7 +116,6 @@ object(MongoDB\BSON\Int64)#5 (1) { &reftitle.seealso; - MongoDB\Driver\CursorId MongoDB\BSON\Int64 diff --git a/reference/mongodb/mongodb/driver/cursorid.xml b/reference/mongodb/mongodb/driver/cursorid.xml index 0d98a4c728..73b00c8c67 100644 --- a/reference/mongodb/mongodb/driver/cursorid.xml +++ b/reference/mongodb/mongodb/driver/cursorid.xml @@ -1,5 +1,5 @@ - + @@ -19,7 +19,7 @@ Класс УСТАРЕЛ с версии модуля - 1.20.0, а в версии 2.0 класс удалят. В приложениях требуется обновить + 1.20.0, а в версии 2.0 класс удалили. В приложениях требуется обновить метод MongoDB\Driver\Cursor::getId, чтобы вместо объектов этого класса метод возвращал объекты класса MongoDB\BSON\Int64. @@ -70,6 +70,7 @@ + &mongodb.changelog.class-removed; PECL-модуль mongodb 1.20.0 @@ -79,13 +80,13 @@ PECL mongodb 1.12.0 - Реализовали интерфейс Stringable для PHP 8.0+. + Класс теперь реализует интерфейс Stringable для PHP 8.0+. PECL-модуль mongodb 1.7.0 - Реализовали интерфейс Serializable. + Класс теперь реализует интерфейс Serializable. diff --git a/reference/mongodb/mongodb/driver/cursorinterface.xml b/reference/mongodb/mongodb/driver/cursorinterface.xml index fedfdb0f9e..677bc82a9e 100644 --- a/reference/mongodb/mongodb/driver/cursorinterface.xml +++ b/reference/mongodb/mongodb/driver/cursorinterface.xml @@ -1,5 +1,5 @@ - + @@ -33,7 +33,7 @@ - Traversable + Iterator @@ -57,6 +57,17 @@ + + PECL-модуль mongodb 2.0.0 + + + Интерфейс теперь расширяет интерфейс Iterator. + + + Типы значений возврата, которые прежде объявили предварительными, стали обязательными. + + + &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/mongodb/driver/cursorinterface/getid.xml b/reference/mongodb/mongodb/driver/cursorinterface/getid.xml index efef3f7136..925ccdf065 100644 --- a/reference/mongodb/mongodb/driver/cursorinterface/getid.xml +++ b/reference/mongodb/mongodb/driver/cursorinterface/getid.xml @@ -1,5 +1,5 @@ - + @@ -10,7 +10,7 @@ &reftitle.description; - abstract public MongoDB\Driver\CursorIdMongoDB\BSON\Int64MongoDB\Driver\CursorInterface::getId + abstract public MongoDB\BSON\Int64MongoDB\Driver\CursorInterface::getId diff --git a/reference/mongodb/mongodb/driver/exception/bulkwriteexception.xml b/reference/mongodb/mongodb/driver/exception/bulkwriteexception.xml index b66c76a76b..66c1abe1d8 100644 --- a/reference/mongodb/mongodb/driver/exception/bulkwriteexception.xml +++ b/reference/mongodb/mongodb/driver/exception/bulkwriteexception.xml @@ -1,7 +1,6 @@ - + - Класс MongoDB\Driver\Exception\BulkWriteException @@ -13,7 +12,7 @@
&reftitle.intro; - Выбрасывается в случае неудачной массовой операции записи. + Исключение выбрасывается при неудачной массовой операции записи.
@@ -33,24 +32,28 @@ extends - MongoDB\Driver\Exception\WriteException + MongoDB\Driver\Exception\ServerException MongoDB\Driver\Exception\Exception + &Properties; + + protected + MongoDB\Driver\WriteResult + writeResult + &InheritedProperties; - - + &InheritedMethods; - - + @@ -60,6 +63,52 @@
+ +
+ &reftitle.properties; + + + writeResult + + + Объект MongoDB\Driver\WriteResult, который связан + с неудачной операцией записи. + + + + +
+ + +
+ &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + PECL-модуль mongodb 2.0.0 + + + Класс теперь расширяет класс + MongoDB\Driver\Exception\ServerException, + а не + MongoDB\Driver\Exception\WriteException. + + + + + + + +
+ diff --git a/reference/mongodb/mongodb/driver/exception/sslconnectionexception.xml b/reference/mongodb/mongodb/driver/exception/sslconnectionexception.xml index 2d624e2ab0..e0082ab18b 100644 --- a/reference/mongodb/mongodb/driver/exception/sslconnectionexception.xml +++ b/reference/mongodb/mongodb/driver/exception/sslconnectionexception.xml @@ -1,7 +1,6 @@ - + - Класс MongoDB\Driver\Exception\SSLConnectionException @@ -11,8 +10,8 @@ - Класс исключений УСТАРЕЛ с версии модуля - 1.5.0, а в версии 2.0 исключение удалят. Модуль никогда не выбрасывал + Класс исключений УСТАРЕЛ с модуля версии + 1.5.0, а в версии 2.0 исключение удалили. Модуль никогда не выбрасывал это исключение. Вместо этого исключения в приложениях лучше выбрасывать исключение MongoDB\Driver\Exception\ConnectionException. diff --git a/reference/mongodb/mongodb/driver/exception/writeexception.xml b/reference/mongodb/mongodb/driver/exception/writeexception.xml index 7c0f24f273..502ff3fc6d 100644 --- a/reference/mongodb/mongodb/driver/exception/writeexception.xml +++ b/reference/mongodb/mongodb/driver/exception/writeexception.xml @@ -1,7 +1,6 @@ - + - Класс MongoDB\Driver\Exception\WriteException @@ -12,7 +11,7 @@ Класс исключений УСТАРЕЛ с версии модуля - 1.20.0, а в версии 2.0 исключение удалят. Модуль напрямую никогда не выбрасывал + 1.20.0, а в версии 2.0 исключение удалили. Сам модуль не выбрасывал это исключение. Вместо этого исключения в приложениях лучше выбрасывать исключение MongoDB\Driver\Exception\BulkWriteException. @@ -109,14 +108,21 @@ + &mongodb.changelog.class-removed; + + PECL-модуль mongodb 1.20.0 + + Класс устарел, а в версии 2.0 его удалят. + + - PECL mongodb 1.5.0 + PECL-модуль mongodb 1.5.0 - Теперь вместо класса исключения - MongoDB\Driver\Exception\RuntimeException - класс расширяет исключение - MongoDB\Driver\Exception\ServerException. + Класс теперь расширяет исключение + MongoDB\Driver\Exception\ServerException, + а не + MongoDB\Driver\Exception\RuntimeException. @@ -126,7 +132,6 @@ - &reference.mongodb.mongodb.driver.exception.entities.writeexception; diff --git a/reference/mongodb/mongodb/driver/manager/construct.xml b/reference/mongodb/mongodb/driver/manager/construct.xml index 4082947548..e76e715abd 100644 --- a/reference/mongodb/mongodb/driver/manager/construct.xml +++ b/reference/mongodb/mongodb/driver/manager/construct.xml @@ -1,5 +1,5 @@ - + @@ -170,36 +170,18 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ - - canonicalizeHostname - bool - - - Если &true;, драйвер будет преобразовывать реальное имя хоста для - IP-адреса сервера перед аутентификацией через SASL. Некоторые базовые - слои GSSAPI уже делают это, но эта функциональность может быть отключена - в их конфигурации (например, krb.conf). По умолчанию - &false;. - - - Этот параметр является устаревшим псевдонимом для свойства - "CANONICALIZE_HOST_NAME" параметра URI - "authMechanismProperties". - - - compressors string - Имеющий приоритет, список разделённых запятыми компрессоров, - которые клиент хочет использовать. Сообщения сжаты только в том случае, - если клиент и сервер совместно используют любые компрессоры, + Приоритетный список разделённых запятыми компрессоров, + которые требуется использовать клиенту. Сообщения сжаты, только если + клиент и сервер совместно используют любые компрессоры, а компрессор, используемый в каждом направлении, будет зависеть от индивидуальной конфигурации сервера или драйвера. - Смотрите Спецификация компрессии драйвера - для получения дополнительной информации. + Дополнительную информацию даёт страница + Спецификация компрессии драйвера. @@ -209,7 +191,7 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ Время ожидания в миллисекундах при попытке соединения. - По умолчанию — 10 000 миллисекунд. + Значение по умолчанию равно 10 000 миллисекунд. @@ -218,33 +200,15 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ bool - Этот параметр можно использовать для управления поведением обнаружения набора реплик, - если в строке подключения указан только один хост. По умолчанию, - предоставление одного члена в строке подключения приведёт к - установлению прямого подключения или обнаружению дополнительных членов - в зависимости от того, отсутствует или отсутствует опция - URI "replicaSet" соответственно. Укажите &false;, чтобы вызвать - обнаружение (если "replicaSet" опущен) - или укажите &true;, чтобы форсировать прямое соединение (если - "replicaSet" присутствует). - - - - - gssapiServiceName - string - - - Устанавливает имя службы Kerberos при подключении к керберизованными - экземплярам MongoDB. Это значение должно совпадать именем службы, - установленным в экземплярах MongoDB (т. е. с параметром сервер, - saslServiceName - ). По умолчанию используется "mongodb". - - - Этот параметр является устаревшим псевдонимом для свойства - "SERVICE_NAME" параметра URI - "authMechanismProperties". + Параметр управляет поведением при обнаружении набора реплик, + если в строке подключения указали только один хост. По умолчанию + предоставление одного члена в строке подключения + устанавливается прямое подключение или обнаруживается дополнительное количество членов + в зависимости от того, указали ли + URI-параметр "replicaSet". Укажите &false; для принудительного + обнаружения, если опустили параметр "replicaSet", + или укажите &true;, чтобы форсировать прямое соединение, если + параметр "replicaSet" указали. @@ -254,14 +218,14 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ Задаёт интервал в миллисекундах между проверками драйвера - топологии MongoDB, отсчитываемыми с конца предыдущей проверки - до начала следующей. По умолчанию — 60 000 + топологии MongoDB, которые отсчитываются с конца предыдущей проверки + до начала следующей. Значение по умолчанию равно 60 000 миллисекунд. Согласно Спецификации по обнаружению и мониторингу сервера, - это значение не может быть меньше 500 миллисекунд. + нельзя указывать значение меньше 500 миллисекунд. @@ -411,22 +375,6 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ - - safe - bool - - - Если &true;, указывает 1 для - параметра w - гарантии записи по умолчанию. Если &false;, указывается - 0. Подробнее смотрите - MongoDB\Driver\WriteConcern. - - - Эта опция устарела и не должна использоваться. - - - serverSelectionTimeoutMS int @@ -442,12 +390,12 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ bool - Если &true;, то сообщает драйверу сканировать развёртывание MongoDB - только один раз после неудачной попытки выбора сервера, а затем либо - выбрать сервер или создать ошибку. Когда &false;, драйвер блокирует выбор и - выполняет поиск сервера до истечения времени, указанного в параметре - "serverSelectionTimeoutMS". По умолчанию - - &true;. + Со значением &true; сообщает драйверу сканировать развёртывание MongoDB + только один раз после неудачной попытки выбора сервера, а затем + или выбрать сервер, или создать ошибку. Со значением &false; драйвер блокирует выбор + и выполняет поиск сервера до истечения времени, которое указали в параметре + "serverSelectionTimeoutMS". Значение по умолчанию + равно &true;. @@ -494,27 +442,13 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ - - ssl - bool - - - Создаёт соединение с TLS/SSL, если &true;. По умолчанию - - &false;. - - - Параметр является устаревшим псевдонимом для параметра - URI "tls". - - - tls bool - Инициирует соединение с TLS/SSL, если &true;. - По умолчанию &false;. + Со значением &true; инициирует соединение с TLS/SSL. + Значение по умолчанию равно &false;. @@ -523,9 +457,9 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ bool - Указывает, должен ли драйвер выдавать ошибку, если - сертификат TLS сервера недействителен. По умолчанию - &false;. + Указывает драйверу, выдавать ли ошибку, + если TLS-сертификат сервера недействителен. Значение по умолчанию + равно &false;. @@ -694,24 +628,6 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ - - allow_invalid_hostname - bool - - - Отключает проверку имени хоста, если &true;. По умолчанию — &false;. - - - Разрешение недопустимых имён хоста может привести к атаке типа - "человек посередине" (man-in-the-middle). - - - Этот параметр является устаревшим псевдонимом - для параметра URI - "tlsAllowInvalidHostnames" - - - autoEncryption array @@ -882,73 +798,6 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ - - ca_file - string - - - Путь к файлу с одним или несколькими центрами сертификации, - которые следует считать доверенными при установлении соединения TLS. - По умолчанию будет - использоваться хранилище системных сертификатов. - - - Параметр является устаревшим псевдонимом - для параметра URI "tlsCAFile". - - - - - context - resource - - - Параметры SSL-контекста, которые будут использоваться - как запасной вариант, если опцию драйвера или эквивалентную ей URI-опцию, если имеется, не указали. - Обратите внимание, что модуль не обращается к контексту - потока по умолчанию (т. е. к функции stream_context_get_default). - Поддерживаются следующие параметры контекста: - - - - Резервные параметры контекста SSL - - - - Параметр драйвера - Параметр контекста (запасной вариант) - - - - - ca_dir - capath - - - ca_file - cafile - - - pem_file - local_cert - - - pem_pwd - passphrase - - - weak_cert_validation - allow_self_signed - - - -
- - Параметр поддерживается для обратной совместимости, - но его следует считать устаревшим. - - - crl_file string @@ -959,10 +808,10 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ bool - Если значение равно &true;, этот менеджер будет использовать новый клиент библиотеки libmongoc, который не будет + Со значением &true; менеджер будет использовать новый клиент библиотеки libmongoc, который не будет сохраняться или использоваться другими объектами Manager. - Когда этот объект Manager будет освобождён, его клиент будет уничтожен, - а все соединения будут закрыты. По умолчанию &false;. + Когда этот объект Manager освободится, его клиент уничтожится, + а все соединения закроются. Значение по умолчанию равно &false;. @@ -992,52 +841,13 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ - - pem_file - string - - - Путь к сертификату в формате PEM для аутентификации клиента. - - - Этот параметр является устаревшим псевдонимом - для параметра URI "tlsCertificateKeyFile". - - - - - pem_pwd - string - - - Парольная фраза к PEM-закодированному сертификату (если есть). - - - Этот параметр является устаревшим псевдонимом - для параметра URI "tlsCertificateKeyFilePassword". - - - serverApi MongoDB\Driver\ServerApi - Опция используется для объявления версии API сервера для менеджера. - Если не указана, версия API не объявляется. - - - - - weak_cert_validation - bool - - - Отключает проверку сертификат, если &true;. По умолчанию — &false; - - - Этот параметр является устаревшим псевдонимом - для параметра URI "tlsAllowInvalidCertificates". + Опция обновляет версию API-интерфейса сервера для менеджера. + Без опции API-версия не объявляется. @@ -1071,7 +881,55 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ - PECL mongodb 1.16.0 + PECL-модуль mongodb 2.0.0 + + + Удалили URI-параметр "canonicalizeHostname". + Вместо него указывают свойство URI-параметра "authMechanismProperties" — + "CANONICALIZE_HOST_NAME". + + + Удалили URI-параметр "gssapiServiceName". + Вместо него указывают свойство URI-параметра "authMechanismProperties" — + "SERVICE_NAME". + + + Удалили URI-параметр "safe" URI. Вместо него указывают + URI-параметры "w" и "wTimeoutMS". + + + Удалили URI-параметр "ssl". Вместо него указывают + URI-параметр "tls". + + + Удалили драйверный параметр "allow_invalid_hostname". + Вместо него указывают URI-параметр "tlsAllowInvalidHostnames". + + + Удалили драйверный параметр "ca_file". Вместо него указывают + URI-параметр "tlsCAFile". + + + Удалили драйверный параметр "context". Параметры + контекста устарели в пользу URI-параметров, которые связаны + с TLS. + + + Удалили драйверный параметр "pem_file". Вместо него указывают + URI-параметр "tlsCertificateKeyFile". + + + Удалили драйверный параметр "pem_pwd". Вместо него указывают + URI-параметр "tlsCertificateKeyFilePassword". + + + Удалили драйверный параметр "weak_cert_validation". + Вместо него указывают URI-параметр "tlsAllowInvalidCertificates". + + + + + PECL-модуль mongodb 1.16.0 Провайдер AWS KMS для шифрования на стороне клиента теперь принимает параметр @@ -1079,200 +937,200 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ с временными учётными данными AWS. - Добавлено "tlsDisableOCSPEndpointCheck" в поле + Добавили "tlsDisableOCSPEndpointCheck" в поле "tlsOptions" поля "autoEncryption" опции драйвера. - Если для KMS-провайдеров "azure" или - "gcp" указан пустой документ, - драйвер попытается сконфигурировать провайдера, заполнив - Автоматические учётные данные. + Драйвер попытается сконфигурировать провайдера, заполнив + Автоматические учётные данные, + если для KMS-провайдеров "azure" + или "gcp" указали пустой документ. - PECL mongodb 1.15.0 + PECL-модуль mongodb 1.15.0 - Если для KMS-провайдера "aws" указан пустой документ, - драйвер попытается сконфигурировать провайдера, заполнив - Автоматические учётные данные. + Драйвер попытается сконфигурировать провайдера, заполнив + Автоматические учётные данные, + если для KMS-провайдера "aws" указали пустой документ. - PECL mongodb 1.14.0 + PECL-модуль mongodb 1.14.0 - Добавлены опции автоматического шифрования "bypassQueryAnalysis" и "encryptedFieldsMap". + Добавили опции автоматического шифрования "bypassQueryAnalysis" и "encryptedFieldsMap". Дополнительные опции, относящиеся к crypt_shared, теперь поддерживаются в опции автоматического шифрования "extraOptions". option. - PECL mongodb 1.13.0 + PECL-модуль mongodb 1.13.0 - Добавлены URI опции "srvMaxHosts" и - "srvServiceName". + Добавили URI-параметры "srvMaxHosts" + и "srvServiceName". - PECL mongodb 1.12.0 + PECL-модуль mongodb 1.12.0 - KMIP теперь поддерживается в качестве KMS провайдера для шифрования на стороне клиента - и может быть настроен с помощью поля "kmsProviders" + KMIP теперь поддерживается как KMS-провайдер для шифрования на стороне клиента + и настраивается через поле "kmsProviders" параметра драйвера "autoEncryption". - Кроме того, параметры TLS для KMS-провайдеров теперь можно настроить в поле "tlsOptions" + Кроме того, параметры TLS для KMS-провайдеров теперь настраиваются в поле "tlsOptions" параметра драйвера "autoEncryption". - PECL mongodb 1.11.0 + PECL-модуль mongodb 1.11.0 - Добавлена опция URI "loadBalanced". + Добавили URI-параметр "loadBalanced". - PECL mongodb 1.10.0 + PECL-модуль mongodb 1.10.0 - Добавлена опция драйвера "disableClientPersistence". + Добавили драйверный параметр "disableClientPersistence". - Azure и GCP теперь поддерживаются в качестве поставщиков KMS + Azure и GCP теперь поддерживаются как поставщик KMS для шифрования на стороне клиента и могут быть настроены в поле "kmsProviders" параметра драйвера "autoEncryption". - Строки в кодировке Base64 теперь принимаются в качестве альтернативы MongoDB\BSON\Binary + Строки в кодировке Base64 теперь принимаются как альтернатива MongoDB\BSON\Binary для параметров внутри "kmsProviders". - PECL mongodb 1.8.0 + PECL-модуль mongodb 1.8.0 - Добавлены опции URI "directConnection", - "tlsDisableCertificateRevocationCheck", и - "tlsDisableOCSPEndpointCheck". + Добавили URI-параметры "directConnection", + "tlsDisableCertificateRevocationCheck" + и "tlsDisableOCSPEndpointCheck". - Добавлен параметр драйвера "driver". + Добавили драйверный параметр "driver". - PECL mongodb 1.7.0 + PECL-модуль mongodb 1.7.0 - Добавлена опция драйвера "autoEncryption". + Добавили драйверный параметр "autoEncryption". - Указание любой опции SSL или TLS в - параметре driverOptions теперь неявно включает TLS, как это делается для - соответствующих опций URI. + Указание любой опции SSL или TLS + в параметре driverOptions теперь неявно включает TLS, как это делается для + соответствующих URI-параметров. - PECL mongodb 1.6.0 + PECL-модуль mongodb 1.6.0 - Добавлены параметры URI "retryReads", "tls", + Добавили URI-параметры "retryReads", "tls", "tlsAllowInvalidCertificates", "tlsAllowInvalidHostnames", "tlsCAFile", "tlsCertificateKeyFile", - "tlsCertificateKeyFilePassword", и - "tlsInsecure". + "tlsCertificateKeyFilePassword" + и "tlsInsecure". - Параметр URI "retryWrites" по умолчанию &true;. + Значение URI-параметра "retryWrites" теперь по умолчанию равно &true;. Передача URI-опции SSL или TLS через строку подключения или параметр uriOptions - теперь неявно включает TLS, при условии, если - ssl или - tls не равны &false;. TSL не - включается неявно для - любых опций в параметре driverOptions, + теперь неявно включает TLS, при условии, + если значения ssl + или tls не равны &false;. TSL не + включается неявно + для любых опций в параметре driverOptions, как в предыдущих версиях. - PECL mongodb 1.5.0 + PECL-модуль mongodb 1.5.0 - "wtimeoutMS" теперь всегда проверяется и применяется к - гарантии записи. Ранее эта опция игнорировалась, если - "w" был <= 1, поскольку время ожидания применяется только к - репликации. + Параметр "wtimeoutMS" теперь всегда проверяется и применяется + к гарантии записи. Раньше параметр игнорировался, + если значение параметра "w" оказывалось <= 1, поскольку время ожидания применяется только + к репликации. - PECL mongodb 1.4.0 + PECL-модуль mongodb 1.4.0 - Добавлены опции URI "compressors", - "retryWrites" и - "zlibCompressionLevel". + Добавили URI-параметры "compressors", + "retryWrites" + и "zlibCompressionLevel". - PECL mongodb 1.3.0 + PECL-модуль mongodb 1.3.0 - В аргументе uriOptions теперь есть опции - "authMechanism" и - "authMechanismProperties". Раньше эти опции + В аргументе uriOptions появились опции + "authMechanism" + и "authMechanismProperties". Раньше эти опции поддерживались только в аргументе uri. - PECL mongodb 1.2.0 + PECL-модуль mongodb 1.2.0 - Аргумент uri по умолчанию теперь - "mongodb://127.0.0.1/". Порт по умолчанию не изменился - + Аргумент uri по умолчанию теперь равен + "mongodb://127.0.0.1/". Порт по умолчанию не изменился — 27017. - Добавлен URI-параметр "appname". + Добавили URI-параметр "appname". - Добавлены параметры драйвера "allow_invalid_hostname", + Добавили драйверные параметры "allow_invalid_hostname", "ca_file", "ca_dir", "clr_file", "pem_file", - "pem_pwd" и - "weak_cert_validation". + "pem_pwd" + и "weak_cert_validation". - API PHP-потоков больше не используется для соединения с сокетом. Значение URI-параметра - connectTimeoutMS теперь по умолчанию равно 10 секундам + API-интерфейс PHP-потоков больше не задействуется для соединения с сокетом. Значение URI-параметра + connectTimeoutMS по умолчанию теперь равно 10 секундам вместо значения опции default_socket_timeout, - как было в предыдущих версиях. Кроме того, модуль больше не поддерживает все + как было в предыдущих версиях. Кроме того, модуль больше не поддерживает параметры SSL-контекста через параметр драйвера context. - PECL mongodb 1.1.0 + PECL-модуль mongodb 1.1.0 - Аргумент uri является необязательный и по умолчанию равен + Аргумент uri стал необязательным и по умолчанию равен "mongodb://localhost:27017/". @@ -1286,7 +1144,7 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][ &reftitle.examples; - Примеры использования <function>MongoDB\Driver\Manager::__construct</function> + Примеры работы метода <function>MongoDB\Driver\Manager::__construct</function> Подключение к автономному узлу MongoDB: - Подключение к автономному узлу MongoDB через доменный сокет Unix. Путь сокета - может содержать специальные символы, например слеши, которые должны закодированы - с помощью rawurlencode. + Подключение к автономному узлу СУБД MongoDB через доменный сокет Unix. Путь сокета + допускает специальные символы наподобие слешей, которые требуется закодировать + функцией rawurlencode. - + @@ -98,6 +98,13 @@ + + PECL-модуль mongodb 2.0.0 + + Параметр options больше не принимает + объекты MongoDB\Driver\WriteConcern. + + PECL-модуль mongodb 1.21.0 @@ -159,7 +166,7 @@ $bulk->delete(['x' => 1], ['limit' => 1]); $manager = new MongoDB\Driver\Manager('mongodb://localhost:27017'); $writeConcern = new MongoDB\Driver\WriteConcern(MongoDB\Driver\WriteConcern::MAJORITY, 100); -$result = $manager->executeBulkWrite('db.collection', $bulk, $writeConcern); +$result = $manager->executeBulkWrite('db.collection', $bulk, ['writeConcern' => $writeConcern]); printf("Добавлено %d документ(ов)\n", $result->getInsertedCount()); printf("Найдено %d документ(ов)\n", $result->getMatchedCount()); @@ -172,12 +179,12 @@ foreach ($result->getUpsertedIds() as $index => $id) { var_dump($id); } -/* Если WriteConcern не может быть выполнен */ +/* При невозможности выполнить WriteConcern */ if ($writeConcernError = $result->getWriteConcernError()) { printf("%s (%d): %s\n", $writeConcernError->getMessage(), $writeConcernError->getCode(), var_export($writeConcernError->getInfo(), true)); } -/* Если запись не может произойти вообще*/ +/* Если запись недоступна */ foreach ($result->getWriteErrors() as $writeError) { printf("Операция#%d: %s (%d)\n", $writeError->getIndex(), $writeError->getMessage(), $writeError->getCode()); } diff --git a/reference/mongodb/mongodb/driver/manager/executecommand.xml b/reference/mongodb/mongodb/driver/manager/executecommand.xml index 284f10ef7b..5bbda1709b 100644 --- a/reference/mongodb/mongodb/driver/manager/executecommand.xml +++ b/reference/mongodb/mongodb/driver/manager/executecommand.xml @@ -1,5 +1,5 @@ - + @@ -100,6 +100,13 @@ + + PECL-модуль mongodb 2.0.0 + + Параметр options больше не принимает + объекты MongoDB\Driver\ReadPreference. + + PECL-модуль mongodb 1.21.0 diff --git a/reference/mongodb/mongodb/driver/manager/executequery.xml b/reference/mongodb/mongodb/driver/manager/executequery.xml index 5b90fc0fe9..a5ceaceb55 100644 --- a/reference/mongodb/mongodb/driver/manager/executequery.xml +++ b/reference/mongodb/mongodb/driver/manager/executequery.xml @@ -1,5 +1,5 @@ - + @@ -86,6 +86,13 @@ + + PECL-модуль mongodb 2.0.0 + + Параметр options больше не принимает + объекты MongoDB\Driver\ReadPreference. + + PECL-модуль mongodb 1.21.0 diff --git a/reference/mongodb/mongodb/driver/monitoring/commandfailedevent/getserver.xml b/reference/mongodb/mongodb/driver/monitoring/commandfailedevent/getserver.xml index 27e3ce726e..39401ec09f 100644 --- a/reference/mongodb/mongodb/driver/monitoring/commandfailedevent/getserver.xml +++ b/reference/mongodb/mongodb/driver/monitoring/commandfailedevent/getserver.xml @@ -1,7 +1,6 @@ - + - MongoDB\Driver\Monitoring\CommandFailedEvent::getServer @@ -12,7 +11,7 @@ Метод УСТАРЕЛ с версии модуля - 1.20.0, а версии 2.0 метод удалят. Вместо этого метода приложениям лучше вызывать методы + 1.20.0, а версии 2.0 метод удалили. Вместо этого метода приложениям лучше вызывать методы MongoDB\Driver\Monitoring\CommandFailedEvent::getHost и MongoDB\Driver\Monitoring\CommandFailedEvent::getPort. @@ -51,6 +50,25 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.method-removed; + + + + + + &reftitle.seealso; diff --git a/reference/mongodb/mongodb/driver/monitoring/commandstartedevent/getserver.xml b/reference/mongodb/mongodb/driver/monitoring/commandstartedevent/getserver.xml index c49e86c4cc..f3a3e2e99e 100644 --- a/reference/mongodb/mongodb/driver/monitoring/commandstartedevent/getserver.xml +++ b/reference/mongodb/mongodb/driver/monitoring/commandstartedevent/getserver.xml @@ -1,7 +1,6 @@ - + - MongoDB\Driver\Monitoring\CommandStartedEvent::getServer @@ -12,7 +11,7 @@ Метод УСТАРЕЛ с версии модуля - 1.20.0, а версии 2.0 метод удалят. Вместо этого метода приложениям лучше вызывать методы + 1.20.0, а версии 2.0 метод удалили. Вместо этого метода приложениям лучше вызывать методы MongoDB\Driver\Monitoring\CommandStartedEvent::getHost и MongoDB\Driver\Monitoring\CommandStartedEvent::getPort. @@ -51,6 +50,25 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.method-removed; + + + + + + &reftitle.seealso; diff --git a/reference/mongodb/mongodb/driver/monitoring/commandsubscriber.xml b/reference/mongodb/mongodb/driver/monitoring/commandsubscriber.xml index c3e6ee1513..da696a6586 100644 --- a/reference/mongodb/mongodb/driver/monitoring/commandsubscriber.xml +++ b/reference/mongodb/mongodb/driver/monitoring/commandsubscriber.xml @@ -1,7 +1,6 @@ - + - Интерфейс The MongoDB\Driver\Monitoring\CommandSubscriber @@ -13,8 +12,8 @@
&reftitle.intro; - Классы могут реализовать этот интерфейс для регистрации подписчика событий, который - уведомляется о каждом, успешном или неудачном событии команды. Для подробной информации смотрите + Классы реализуют этот интерфейс для регистрации подписчика событий, который + уведомляется о каждом успешном или неудачном событии команды. Более подробная информация доступна на странице .
@@ -58,6 +57,7 @@ + &mongodb.changelog.tentative-return-types-enforced; &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/mongodb/driver/monitoring/commandsucceededevent/getserver.xml b/reference/mongodb/mongodb/driver/monitoring/commandsucceededevent/getserver.xml index e435b7cc55..f99eb0ee53 100644 --- a/reference/mongodb/mongodb/driver/monitoring/commandsucceededevent/getserver.xml +++ b/reference/mongodb/mongodb/driver/monitoring/commandsucceededevent/getserver.xml @@ -1,7 +1,6 @@ - + - MongoDB\Driver\Monitoring\CommandSucceededEvent::getServer @@ -12,7 +11,7 @@ Метод УСТАРЕЛ с версии модуля - 1.20.0, а версии 2.0 метод удалят. Вместо этого метода приложениям лучше вызывать методы + 1.20.0, а версии 2.0 метод удалили. Вместо этого метода приложениям лучше вызывать методы MongoDB\Driver\Monitoring\CommandSucceededEvent::getHost и MongoDB\Driver\Monitoring\CommandSucceededEvent::getPort. @@ -51,6 +50,25 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.method-removed; + + + + + + &reftitle.seealso; diff --git a/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber.xml b/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber.xml index 672e727afa..b7c62367e0 100644 --- a/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber.xml +++ b/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber.xml @@ -1,5 +1,5 @@ - + @@ -12,10 +12,10 @@
&reftitle.intro; - Классы могут реализовать этот интерфейс для регистрации подписчика событий, - который получает уведомления о различных событиях SDAM. Дополнительную информацию смотрите - в руководстве по Обнаружению и мониторингу серверов - и Мониторингу SDAM. + Классы реализуют этот интерфейс для регистрации подписчика событий, + который получает уведомления о различных событиях SDAM. Дополнительная информация доступна + в руководстве «Обнаружение и мониторинг серверов» + и «Мониторинг SDAM».
@@ -58,6 +58,7 @@ + &mongodb.changelog.tentative-return-types-enforced; &mongodb.changelog.tentative-return-types; diff --git a/reference/mongodb/mongodb/driver/query/construct.xml b/reference/mongodb/mongodb/driver/query/construct.xml index ebf719531a..fac43b94e2 100644 --- a/reference/mongodb/mongodb/driver/query/construct.xml +++ b/reference/mongodb/mongodb/driver/query/construct.xml @@ -1,5 +1,5 @@ - + @@ -172,15 +172,9 @@ int - Устанавливает максимальное количество документов для возврата. По умолчанию ограничений нет, + Параметр устанавливает максимальное количество документов для возврата. По умолчанию ограничений нет, если опцию не указали. Значение 0 — то же, что отмена ограничения. - - Отрицательное значение метод интерпретирует как положительное ограничение - с опцией "singleBatch" со значением &true;. - Это поведение поддерживается в целях обратной совместимости, - но рассматривается как устаревшее. - @@ -208,25 +202,6 @@ - - maxScan - int - - - - Опция устарела, и лучше не включать её в запрос. - - - - Принимает целое положительное число, которое устанавливает максимальное количество документов - или индексных ключей для сканирования при выполнении запроса. - - - Драйвер откатится к считыванию устаревшего модификатора "$maxScan", - если эту опцию не указали. - - - maxTimeMS int @@ -255,15 +230,6 @@ - - modifiers - array - - Метаоператоры, - которые изменяют вывод или поведение запроса. Эти операторы устарели, - вместо них лучше пользоваться именованными опциями. - - noCursorTimeout bool @@ -272,24 +238,6 @@ бездействия, который составляет 10 минут. - - oplogReplay - bool - - - Опция для внутренних операций с наборами реплик. Опция oplogReplay будет работать, - только если включить в фильтр следующее условие: - - - - [ '$gte' => ] ] -]]> - - - Опция устарела с версии 1.8.0. - - projection arrayobject @@ -369,25 +317,6 @@ Значение по умолчанию равно 0. - - snapshot - bool - - - - Опция устарела, и лучше не включать её в запрос. - - - - Запрещает курсору возвращать документ больше одного раза - из-за промежуточной операции записи. - - - Драйвер откатится к считыванию устаревшего модификатора "$snapshot", - если эту опцию не указали. - - - sort arrayobject @@ -434,6 +363,38 @@ + + PECL mongodb 2.0.0 + + + Параметр "partial" удалили. Вместо него указывают + параметр "allowPartialResults". + + + Параметр "maxScan" удалили. Поддержку параметра + удалили в MongoDB 4.2. + + + Параметр "modifiers" удалили. Параметр указывали + для устаревших модификаторов запроса, которые устарели. + + + Параметр "oplogReplay" удалили. Параметр игнорировали + СУБД MongoDB 4.4 и новее. + + + Параметр "snapshot" удалили. Поддержку параметра + удалили в MongoDB 4.0. + + + Отрицательное значение в параметре "limit" больше + не интерпретируется как значение &true; для параметра "singleBatch". Одну + часть результатов получают путём объединения положительного значения + в параметре "limit" + с параметром "singleBatch". + + + PECL-модуль mongodb 1.14.0 @@ -450,7 +411,7 @@ Добавили опцию "allowDiskUse". - Опцию "oplogReplay" объявили устаревшей. + Опция "oplogReplay" устарела. @@ -538,7 +499,7 @@ $query = new MongoDB\Driver\Query($filter, $options); $manager = new MongoDB\Driver\Manager('mongodb://localhost:27017'); $readPreference = new MongoDB\Driver\ReadPreference(MongoDB\Driver\ReadPreference::PRIMARY); -$cursor = $manager->executeQuery('databaseName.collectionName', $query, $readPreference); +$cursor = $manager->executeQuery('databaseName.collectionName', $query, ['readPreference' => $readPreference]); foreach ($cursor as $document) { var_dump($document); diff --git a/reference/mongodb/mongodb/driver/readpreference.xml b/reference/mongodb/mongodb/driver/readpreference.xml index a610e7012c..3f60aa89e7 100644 --- a/reference/mongodb/mongodb/driver/readpreference.xml +++ b/reference/mongodb/mongodb/driver/readpreference.xml @@ -1,7 +1,6 @@ - + - Класс MongoDB\Driver\ReadPreference @@ -42,36 +41,6 @@ &Constants; - - const - int - MongoDB\Driver\ReadPreference::RP_PRIMARY - 1 - - - const - int - MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED - 5 - - - const - int - MongoDB\Driver\ReadPreference::RP_SECONDARY - 2 - - - const - int - MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED - 6 - - - const - int - MongoDB\Driver\ReadPreference::RP_NEAREST - 10 - const string @@ -126,97 +95,12 @@
&reftitle.constants; - - - MongoDB\Driver\ReadPreference::RP_PRIMARY - - - Все операции считываются из текущего первичного узла набора реплик. Это - предпочтение чтения по умолчанию для MongoDB. - - - - Константа УСТАРЕЛА с версии модуля - 1.20.0, а в версии 2.0 константу удалят. Вместо этой константы в приложениях лучше указывать - константу MongoDB\Driver\ReadPreference::PRIMARY. - - - - - - - MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED - - - В больше части случаев операции считываются из первичного узла, но если он - недоступен, операции считываются из вторичных членов. - - - - Константа УСТАРЕЛА с версии модуля - 1.20.0, а в версии 2.0 константу удалят. Вместо этой константы в приложениях лучше указывать - константу MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED. - - - - - - - MongoDB\Driver\ReadPreference::RP_SECONDARY - - - Все операции считываются из вторичных членов набора реплик. - - - - Константа УСТАРЕЛА с версии модуля - 1.20.0, а в версии 2.0 константу удалят. Вместо этой константы в приложениях лучше указывать - константу MongoDB\Driver\ReadPreference::SECONDARY. - - - - - - - MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED - - - В больше части случаев операции считываются из вторичных узлов, но если - они недоступны, операции считываются из первичного узла. - - - - Константа УСТАРЕЛА с версии модуля - 1.20.0, а в версии 2.0 константу удалят. Вместо этой константы в приложениях лучше указывать - константу MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED. - - - - - - - MongoDB\Driver\ReadPreference::RP_NEAREST - - - Операции считываются из члена набора реплик с наименьшей задержкой сети, - независимо от типа члена. - - - - Константа УСТАРЕЛА с версии модуля - 1.20.0, а в версии 2.0 константу удалят. Вместо этой константы в приложениях лучше указывать - константу MongoDB\Driver\ReadPreference::NEAREST. - - - - - MongoDB\Driver\ReadPreference::PRIMARY - Все операции чтения из текущей реплики установлены первичными. - Это предпочтение чтения по умолчанию для MongoDB. + Каждую операцию чтения из текущей реплики установили первичными. + Это предпочтение чтения по умолчанию для СУБД MongoDB. @@ -225,8 +109,8 @@ MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED - В большинстве случаев операции читаются из первичного узла, но - если он недоступен, операции читаются с вторичных узлов. + В большей части случаев операции считываются из первичного узла, + но если узел недоступен, операции считываются со вторичных узлов. @@ -235,7 +119,7 @@ MongoDB\Driver\ReadPreference::SECONDARY - Все операции читаются из вторичных узлов набора реплик. + Каждая операция считывается из вторичных узлов набора реплик. @@ -244,8 +128,8 @@ MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED - В большинстве случаев операции читаются из вторичных узлов, но если они недоступны, - операции читаются с первичного. + В большей части случаев операции считываются из вторичных узлов, но если узлы недоступны, + операции считываются с первичного. @@ -278,9 +162,9 @@ Минимальное значение для параметра "maxStalenessSeconds" равно 90 секундам. Драйвер оценивает запаздывание (staleness) вторичных узлов, периодически проверяя последнюю дату записи - каждого члена набора реплик. Поскольку эти проверки являются нечастыми, - оценка запаздывания является грубой. Таким образом, драйвер не может обеспечить максимальную величину - запаздывания менее 90 секунд. + каждого члена набора реплик. Поскольку эти проверки нечастые, + оценка запаздывания грубая. Поэтому драйвер не обеспечивает максимальную величину + запаздывания меньше 90 секунд. @@ -301,6 +185,20 @@ + + PECL-модуль mongodb 2.0.0 + + + Удалили константы + MongoDB\Driver\ReadPreference::RP_PRIMARY, + MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED, + MongoDB\Driver\ReadPreference::RP_SECONDARY, + MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED + и MongoDB\Driver\ReadPreference::RP_NEAREST. + Метод getMode тоже удалили. + + + PECL-модуль mongodb 1.20.0 @@ -309,9 +207,9 @@ MongoDB\Driver\ReadPreference::RP_PRIMARY, MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED, MongoDB\Driver\ReadPreference::RP_SECONDARY, - MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED, + MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED и MongoDB\Driver\ReadPreference::RP_NEAREST - объявили устаревшими. + устарели. @@ -327,7 +225,7 @@ и MongoDB\Driver\ReadPreference::NEAREST. - Реализует Serializable. + Класс теперь реализует интерфейс Serializable. @@ -340,7 +238,7 @@ и MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS. - Реализует MongoDB\BSON\Serializable. + Класс теперь реализует интерфейс MongoDB\BSON\Serializable. diff --git a/reference/mongodb/mongodb/driver/readpreference/construct.xml b/reference/mongodb/mongodb/driver/readpreference/construct.xml index a48bf32b56..9902afc4f0 100644 --- a/reference/mongodb/mongodb/driver/readpreference/construct.xml +++ b/reference/mongodb/mongodb/driver/readpreference/construct.xml @@ -1,7 +1,6 @@ - + - MongoDB\Driver\ReadPreference::__construct @@ -12,7 +11,7 @@ &reftitle.description; final public MongoDB\Driver\ReadPreference::__construct - stringintmode + stringmode arraynulltagSets&null; arraynulloptions&null; @@ -218,6 +217,13 @@ + + PECL-модуль mongodb 2.0.0 + + Передача значения с типом int в аргументе mode + больше не поддерживается. + + PECL-модуль mongodb 1.20.0 diff --git a/reference/mongodb/mongodb/driver/readpreference/getmode.xml b/reference/mongodb/mongodb/driver/readpreference/getmode.xml index 3d53d3aa7d..46fa80b368 100644 --- a/reference/mongodb/mongodb/driver/readpreference/getmode.xml +++ b/reference/mongodb/mongodb/driver/readpreference/getmode.xml @@ -1,7 +1,6 @@ - + - MongoDB\Driver\ReadPreference::getMode @@ -11,8 +10,8 @@ - Метод УСТАРЕЛ с версии модуля - 1.20.0, а в версии 2.0 метод удалят. Вместо этого метода приложениям лучше вызывать + Метод УСТАРЕЛ с модуля версии + 1.20.0, а в версии 2.0 метод удалили. Вместо этого метода приложениям лучше вызывать метод MongoDB\Driver\ReadPreference::getModeString. @@ -45,6 +44,24 @@ + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.method-removed; + + + + + &reftitle.examples; diff --git a/reference/mongodb/mongodb/driver/server/executebulkwrite.xml b/reference/mongodb/mongodb/driver/server/executebulkwrite.xml index b033808edd..ffc415f26c 100644 --- a/reference/mongodb/mongodb/driver/server/executebulkwrite.xml +++ b/reference/mongodb/mongodb/driver/server/executebulkwrite.xml @@ -1,5 +1,5 @@ - + @@ -104,7 +104,14 @@ - PECL mongodb 1.21.0 + PECL-модуль mongodb 2.0.0 + + Параметр options больше не принимает + объекты MongoDB\Driver\WriteConcern. + + + + PECL-модуль mongodb 1.21.0 Передача объекта MongoDB\Driver\WriteConcern как опции параметра options устарела, а в версии 2.0 передачу объекта запретят. diff --git a/reference/mongodb/mongodb/driver/server/executecommand.xml b/reference/mongodb/mongodb/driver/server/executecommand.xml index c0a1311886..48f53f63e2 100644 --- a/reference/mongodb/mongodb/driver/server/executecommand.xml +++ b/reference/mongodb/mongodb/driver/server/executecommand.xml @@ -1,5 +1,5 @@ - + @@ -99,6 +99,13 @@ + + PECL-модуль mongodb 2.0.0 + + Параметр options больше не принимает + объекты MongoDB\Driver\ReadPreference. + + PECL-модуль mongodb 1.21.0 diff --git a/reference/mongodb/mongodb/driver/server/executequery.xml b/reference/mongodb/mongodb/driver/server/executequery.xml index f27527ab97..902e93d126 100644 --- a/reference/mongodb/mongodb/driver/server/executequery.xml +++ b/reference/mongodb/mongodb/driver/server/executequery.xml @@ -1,5 +1,5 @@ - + @@ -87,6 +87,13 @@ + + PECL-модуль mongodb 2.0.0 + + Параметр options больше не принимает + объекты MongoDB\Driver\ReadPreference. + + PECL-модуль mongodb 1.21.0 diff --git a/reference/mongodb/mongodb/driver/writeresult/getdeletedcount.xml b/reference/mongodb/mongodb/driver/writeresult/getdeletedcount.xml index 961aa837dd..f58482113d 100644 --- a/reference/mongodb/mongodb/driver/writeresult/getdeletedcount.xml +++ b/reference/mongodb/mongodb/driver/writeresult/getdeletedcount.xml @@ -1,7 +1,6 @@ - + - MongoDB\Driver\WriteResult::getDeletedCount @@ -11,7 +10,7 @@ &reftitle.description; - final public intnullMongoDB\Driver\WriteResult::getDeletedCount + final public intMongoDB\Driver\WriteResult::getDeletedCount @@ -28,28 +27,46 @@ &reftitle.returnvalues; - Возвращает количество удалённых документов или &null; если запись - не была подтверждена. + Метод возвращает количество удалённых документов. &reftitle.errors; + &mongodb.throws.unacknowledged; &mongodb.throws.argumentparsing; + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.throw-unacknowledged-write; + + + + + &reftitle.examples; - Пример использования <function>MongoDB\Driver\WriteResult::getDeletedCount</function> + Пример получения количества удалённых документов методом <function>MongoDB\Driver\WriteResult::getDeletedCount</function> insert(['x' => 1]); diff --git a/reference/mongodb/mongodb/driver/writeresult/getinsertedcount.xml b/reference/mongodb/mongodb/driver/writeresult/getinsertedcount.xml index 95f8192233..bee4498d11 100644 --- a/reference/mongodb/mongodb/driver/writeresult/getinsertedcount.xml +++ b/reference/mongodb/mongodb/driver/writeresult/getinsertedcount.xml @@ -1,17 +1,16 @@ - + - MongoDB\Driver\WriteResult::getInsertedCount - Возвращает количество вставленных документов (исключая слияния) + Возвращает количество вставленных документов без учёта операций upsert &reftitle.description; - final public intnullMongoDB\Driver\WriteResult::getInsertedCount + final public intMongoDB\Driver\WriteResult::getInsertedCount @@ -28,28 +27,46 @@ &reftitle.returnvalues; - Возвращает количество вставленных документов (исключая слияния) или &null; - если запись не была подтверждена. + Метод возвращает количество вставленных документов без учёта операций upsert. &reftitle.errors; + &mongodb.throws.unacknowledged; &mongodb.throws.argumentparsing; + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.throw-unacknowledged-write; + + + + + &reftitle.examples; - Пример использования <function>MongoDB\Driver\WriteResult::getInsertedCount</function> + Пример получения количества вставленных документов методом <function>MongoDB\Driver\WriteResult::getInsertedCount</function> insert(['x' => 1]); diff --git a/reference/mongodb/mongodb/driver/writeresult/getmatchedcount.xml b/reference/mongodb/mongodb/driver/writeresult/getmatchedcount.xml index 8924ff05c8..24dd81822b 100644 --- a/reference/mongodb/mongodb/driver/writeresult/getmatchedcount.xml +++ b/reference/mongodb/mongodb/driver/writeresult/getmatchedcount.xml @@ -1,7 +1,6 @@ - + - MongoDB\Driver\WriteResult::getMatchedCount @@ -11,7 +10,7 @@ &reftitle.description; - final public intnullMongoDB\Driver\WriteResult::getMatchedCount + final public intMongoDB\Driver\WriteResult::getMatchedCount @@ -30,28 +29,46 @@ &reftitle.returnvalues; - Возвращает количество документов, выбранных для обновления, или &null; если запись - не была подтверждена. + Метод возвращает количество документов, выбранных для обновления. &reftitle.errors; + &mongodb.throws.unacknowledged; &mongodb.throws.argumentparsing; + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.throw-unacknowledged-write; + + + + + &reftitle.examples; - Пример использования <function>MongoDB\Driver\WriteResult::getMatchedCount</function> + Пример получения количества документов, выбранных для обновления, методом <function>MongoDB\Driver\WriteResult::getMatchedCount</function> insert(['x' => 1]); @@ -76,7 +93,6 @@ int(1) - &reftitle.seealso; diff --git a/reference/mongodb/mongodb/driver/writeresult/getmodifiedcount.xml b/reference/mongodb/mongodb/driver/writeresult/getmodifiedcount.xml index 81a1fa95ac..1cd5988154 100644 --- a/reference/mongodb/mongodb/driver/writeresult/getmodifiedcount.xml +++ b/reference/mongodb/mongodb/driver/writeresult/getmodifiedcount.xml @@ -1,7 +1,6 @@ - + - MongoDB\Driver\WriteResult::getModifiedCount @@ -11,13 +10,13 @@ &reftitle.description; - final public intnullMongoDB\Driver\WriteResult::getModifiedCount + final public intMongoDB\Driver\WriteResult::getModifiedCount - Если операция обновления не приводит к изменению документа (например, установка - значения поля в его текущее значение), изменённое число может быть меньше, - чем значение, возвращаемое + При операциях обновления, которые не изменяют документ, наподобие установки + значения поля в его текущее значение изменённое число иногда становится меньше, + чем значение, которое возвращает метод MongoDB\Driver\WriteResult::getMatchedCount. @@ -30,33 +29,46 @@ &reftitle.returnvalues; - Возвращает количество существующих обновлённых документов или &null;, если запись - не была подтверждена. - - - Изменённый счётчик недоступен в версиях MongoDB до версии 2.6, в которой - использовалась устаревшая версия проводного протокола (т.е. OP_UPDATE). В этом случае - изменённое количество также будет равно &null;. + Метод возвращает количество существующих обновлённых документов. &reftitle.errors; + &mongodb.throws.unacknowledged; &mongodb.throws.argumentparsing; + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.throw-unacknowledged-write; + + + + + &reftitle.examples; - Пример использования <function>MongoDB\Driver\WriteResult::getModifiedCount</function> + Пример получения количества существующих обновлённых документов методом <function>MongoDB\Driver\WriteResult::getModifiedCount</function> insert(['x' => 1]); diff --git a/reference/mongodb/mongodb/driver/writeresult/getupsertedcount.xml b/reference/mongodb/mongodb/driver/writeresult/getupsertedcount.xml index 0b0c0b493a..2d4862b003 100644 --- a/reference/mongodb/mongodb/driver/writeresult/getupsertedcount.xml +++ b/reference/mongodb/mongodb/driver/writeresult/getupsertedcount.xml @@ -1,17 +1,16 @@ - + - MongoDB\Driver\WriteResult::getUpsertedCount - Возвращает количество документов, вставленных слиянием + Возвращает количество документов, вставленных операцией upsert &reftitle.description; - final public intnullMongoDB\Driver\WriteResult::getUpsertedCount + final public intMongoDB\Driver\WriteResult::getUpsertedCount @@ -28,27 +27,46 @@ &reftitle.returnvalues; - Возвращает количество документов, вставленных слиянием. + Метод возвращает количество документов, вставленных операцией upsert. &reftitle.errors; + &mongodb.throws.unacknowledged; &mongodb.throws.argumentparsing; + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + &mongodb.changelog.throw-unacknowledged-write; + + + + + &reftitle.examples; - Пример использования <function>MongoDB\Driver\WriteResult::getUpsertedCount</function> + Пример получения количества документов, вставленных операцией upsert, методом <function>MongoDB\Driver\WriteResult::getUpsertedCount</function> insert(['x' => 1]);