From 3cfc2aa255531db2b914e33518257591e63303da Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 17:52:58 +0300 Subject: [PATCH 01/64] Create todatetimeimmutable.xml --- .../todatetimeimmutable.xml | 60 +++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 reference/mongodb/bson/utcdatetimeinterface/todatetimeimmutable.xml 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 + + + + + + From e4f71f9f52622cbe9fb959cf5d75a22498586016 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 18:42:34 +0300 Subject: [PATCH 02/64] Update language-snippets.ent to en --- language-snippets.ent | 181 ++++++++++++++++++++++++++++-------------- 1 file changed, 121 insertions(+), 60 deletions(-) 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 также может + дополнять нулями справа. + + + + '(символ) + + Дополняет результат символом (символ). + + + + + + + Ширина From 417fbcc7e68bd7337be097b9eaf78417f8ff3756 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 18:44:31 +0300 Subject: [PATCH 03/64] Update binary.xml to en --- reference/mongodb/bson/binary.xml | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) 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. From f6d814464c7fc2c1a6082c7e02a17afaeff48049 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 18:45:13 +0300 Subject: [PATCH 04/64] Update binaryinterface.xml to en --- reference/mongodb/bson/binaryinterface.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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; From b64f6d8271d44520c6999a38beb456af477ae4dc Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 18:47:13 +0300 Subject: [PATCH 05/64] Update dbpointer.xml to en --- reference/mongodb/bson/dbpointer.xml | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) 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+. From af1e73e4a3a40130bf94ee27e67088c3c034c7db Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 18:57:29 +0300 Subject: [PATCH 06/64] =?UTF-8?q?Update=20decimal128.xml=20to=20en=20+=20?= =?UTF-8?q?=D0=BE=D0=BF=D0=B5=D1=87=D0=B0=D1=82=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/mongodb/bson/decimal128.xml | 29 ++++++++++++--------------- 1 file changed, 13 insertions(+), 16 deletions(-) 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. From 4ff838f3bd76b0681510d2bed4c2fe294b6c0fe1 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 18:59:41 +0300 Subject: [PATCH 07/64] Update decimal128interface.xml to en --- reference/mongodb/bson/decimal128interface.xml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/reference/mongodb/bson/decimal128interface.xml b/reference/mongodb/bson/decimal128interface.xml index 11644b874e..66ea62080e 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; From 755d093d66dbb7c52414fa04b791738fa8e251c8 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:00:46 +0300 Subject: [PATCH 08/64] Update document.xml to en --- reference/mongodb/bson/document.xml | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) 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. From ced1e4b44ee71f8a7d081560a7ea7f7e8c870280 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:12:12 +0300 Subject: [PATCH 09/64] Update int64.xml to en + infostyle --- reference/mongodb/bson/int64.xml | 45 +++++++++++++++----------------- 1 file changed, 21 insertions(+), 24 deletions(-) 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+. From 10d32a967c8510af16556a57962c499e33471fef Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:16:24 +0300 Subject: [PATCH 10/64] Update javascript.xml to en --- reference/mongodb/bson/javascript.xml | 29 ++++++++++++--------------- 1 file changed, 13 insertions(+), 16 deletions(-) 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. From 6b0ace614f620c6e820ed94bb6976c4141a3f388 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:19:45 +0300 Subject: [PATCH 11/64] =?UTF-8?q?decimal128interface.xml=20=D0=B8=D1=81?= =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=20=D1=84=D0=BE=D1=80=D0=BC?= =?UTF-8?q?=D1=83=D0=BB=D0=B8=D1=80=D0=BE=D0=B2=D0=BA=D1=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/mongodb/bson/decimal128interface.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/mongodb/bson/decimal128interface.xml b/reference/mongodb/bson/decimal128interface.xml index 66ea62080e..58bbb84fe3 100644 --- a/reference/mongodb/bson/decimal128interface.xml +++ b/reference/mongodb/bson/decimal128interface.xml @@ -10,8 +10,8 @@
&reftitle.intro; - Этот интерфейс реализует класс - MongoDB\BSON\Decimal128, но также возможно указать этот тип + Интерфейс реализуется классом + MongoDB\BSON\Decimal128, но интерфейсный тип также возможно указать для параметра, значения возврата или типа свойства в классах пользовательского пространства.
From 2191268a16c2b31ac82bb78bc498b9d0cbfce4d8 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:20:07 +0300 Subject: [PATCH 12/64] Update javascriptinterface.xml to en --- reference/mongodb/bson/javascriptinterface.xml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) 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; From 9bae6b4aa1de9388c856af71f62a4a1c856cfe3e Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:27:36 +0300 Subject: [PATCH 13/64] Update maxkey.xml to en --- reference/mongodb/bson/maxkey.xml | 26 +++++++++++--------------- 1 file changed, 11 insertions(+), 15 deletions(-) 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. From 3410df8b0b70edf8045a7b9d851bea08481f77e7 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:29:22 +0300 Subject: [PATCH 14/64] Update minkey.xml to en --- reference/mongodb/bson/minkey.xml | 24 ++++++++++-------------- 1 file changed, 10 insertions(+), 14 deletions(-) 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. From 8565408fdce9007c104a11e37418fda52de0057c Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:30:25 +0300 Subject: [PATCH 15/64] Update objectid.xml to en --- reference/mongodb/bson/objectid.xml | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) 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. From d931dcd619c1ebf5c6176dd425d7fbef0d21bba6 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:32:01 +0300 Subject: [PATCH 16/64] Update objectidinterface.xml to en --- reference/mongodb/bson/objectidinterface.xml | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) 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; From d346467d10434ba6b3c92ddf54ba17a4936d8fb5 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:41:30 +0300 Subject: [PATCH 17/64] Update packedarray.xml to en --- reference/mongodb/bson/packedarray.xml | 23 ++++++++++------------- 1 file changed, 10 insertions(+), 13 deletions(-) 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-массив требовалось преобразовывать в документ. From 870041b6a41658b7d605c7bf83b46d6aa89f4d74 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:47:17 +0300 Subject: [PATCH 18/64] Update regex.xml to en --- reference/mongodb/bson/regex.xml | 27 ++++++++++++--------------- 1 file changed, 12 insertions(+), 15 deletions(-) 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. From fd1cabee623dc489900c69436b2f35aca8d7e678 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 19:48:27 +0300 Subject: [PATCH 19/64] Update regexinterface.xml to en --- reference/mongodb/bson/regexinterface.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) 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; From 6c791210b5693d90351afec5e618398f795a4d18 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:44:32 +0300 Subject: [PATCH 20/64] Update serializable.xml to en --- reference/mongodb/bson/serializable.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) 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; From 275c369985d4f6495076bce2c9de920a4b7063f6 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:45:25 +0300 Subject: [PATCH 21/64] Update symbol.xml to en --- reference/mongodb/bson/symbol.xml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) 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+. From 2c81ae30179639b36b9ba6765cac44ec01d0acaf Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:48:16 +0300 Subject: [PATCH 22/64] Update timestamp.xml to en --- reference/mongodb/bson/timestamp.xml | 33 +++++++++++++--------------- 1 file changed, 15 insertions(+), 18 deletions(-) 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. From 3faf84ff0d333d2e3eeae32684e182912202db10 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:49:24 +0300 Subject: [PATCH 23/64] Update timestampinterface.xml to en --- reference/mongodb/bson/timestampinterface.xml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) 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; From 8aaec48a1218c2f3b1e6e29cd280a3170efe615e Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:50:26 +0300 Subject: [PATCH 24/64] Update undefined.xml to en --- reference/mongodb/bson/undefined.xml | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) 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+. From e991e0e966e6e84d240eadce4a38d63fdbf4344d Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:51:42 +0300 Subject: [PATCH 25/64] Update unserializable.xml to en --- reference/mongodb/bson/unserializable.xml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) 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; From 73189c484d6f5ed645d1f7cde5802d7e290e0b9c Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:54:29 +0300 Subject: [PATCH 26/64] Update utcdatetime.xml to en --- reference/mongodb/bson/utcdatetime.xml | 27 ++++++++++++-------------- 1 file changed, 12 insertions(+), 15 deletions(-) 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. From 0ba34e99b212c1b6e21a678f56eb70022c800b5a Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:55:19 +0300 Subject: [PATCH 27/64] Update utcdatetimeinterface.xml to en --- reference/mongodb/bson/utcdatetimeinterface.xml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) 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; From 19bff67a7552dc110152d63a3dbb8d38a902aca0 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:56:52 +0300 Subject: [PATCH 28/64] Update construct.xml to en --- reference/mongodb/bson/utcdatetime/construct.xml | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) 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 From e2dedfbc2cbc123e8545f3ecf8d80b4990d7d412 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:58:15 +0300 Subject: [PATCH 29/64] Update fromjson.xml to en --- reference/mongodb/functions/bson/fromjson.xml | 25 ++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) 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; From d894ec1de79d4f18fa1e677f7360d6a59ac79dbb Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:59:06 +0300 Subject: [PATCH 30/64] Update fromphp.xml to en --- reference/mongodb/functions/bson/fromphp.xml | 25 +++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) 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; From 150a9f5d71b039f7be1b34128d547eeb41352c92 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 21:59:52 +0300 Subject: [PATCH 31/64] Update tocanonicalextendedjson.xml to en --- .../bson/tocanonicalextendedjson.xml | 25 ++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) 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; From cec0563dab6afbc71420f001364911646e414ec7 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:00:40 +0300 Subject: [PATCH 32/64] Update tojson.xml to en --- reference/mongodb/functions/bson/tojson.xml | 26 +++++++++++++++++---- 1 file changed, 22 insertions(+), 4 deletions(-) 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; From 00c34fc8d0d4737a794aaecd7ea40360ba6e77bb Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:01:29 +0300 Subject: [PATCH 33/64] Update tophp.xml to en --- reference/mongodb/functions/bson/tophp.xml | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) 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 From c6fc0492c7b388cf9bb118e7dba852954013fc09 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:02:09 +0300 Subject: [PATCH 34/64] Update torelaxedextendedjson.xml to en --- .../functions/bson/torelaxedextendedjson.xml | 25 ++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) 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; From 2bbc3b4340779a08ba636e3bd8c8366a540ccca1 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:06:36 +0300 Subject: [PATCH 35/64] Update clientencryption.xml to en --- .../mongodb/driver/clientencryption.xml | 47 ++++++------------- 1 file changed, 15 insertions(+), 32 deletions(-) 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, From fcdda40f230c0f67ed623a8b5563cbb84b57134a Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:26:32 +0300 Subject: [PATCH 36/64] Update cursor.xml to en --- reference/mongodb/mongodb/driver/cursor.xml | 81 ++++++++++----------- 1 file changed, 38 insertions(+), 43 deletions(-) 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; From 8e4507df693c1d2f6c9874e4b86c454bfae8462e Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:27:55 +0300 Subject: [PATCH 37/64] Update cursorid.xml to en --- reference/mongodb/mongodb/driver/cursorid.xml | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) 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. From 8b4c0c5f922db514fa1806b9947b364b02c41e50 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:29:32 +0300 Subject: [PATCH 38/64] Update cursorinterface.xml to en --- .../mongodb/mongodb/driver/cursorinterface.xml | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) 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; From 1bd311c65ecfb6532e0bfd302f72bab114186175 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:35:46 +0300 Subject: [PATCH 39/64] Update readpreference.xml to en --- .../mongodb/mongodb/driver/readpreference.xml | 160 ++++-------------- 1 file changed, 29 insertions(+), 131 deletions(-) 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. From fe877fb7210672cc2497eeea4a3a46ac9bb7446a Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:40:02 +0300 Subject: [PATCH 40/64] Update getid.xml to en --- .../mongodb/mongodb/driver/cursor/getid.xml | 29 +++++++------------ 1 file changed, 11 insertions(+), 18 deletions(-) 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 From 6dc109747b4d924e65f051e2209ff65006952242 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:40:39 +0300 Subject: [PATCH 41/64] Update getid.xml to en --- reference/mongodb/mongodb/driver/cursorinterface/getid.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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 From 449630eca390b7805843fe0ab225419a447372e3 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:45:26 +0300 Subject: [PATCH 42/64] Update bulkwriteexception.xml to en --- .../driver/exception/bulkwriteexception.xml | 65 ++++++++++++++++--- 1 file changed, 57 insertions(+), 8 deletions(-) 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. + + + + + + + +
+ From 730be2254b839b4859f5cd0e1d35663eb9947768 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:46:06 +0300 Subject: [PATCH 43/64] Update sslconnectionexception.xml to en --- .../mongodb/driver/exception/sslconnectionexception.xml | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) 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. From 4f2862dde1e1c607d0da85b8768e4d9e5039e1d5 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 22:48:47 +0300 Subject: [PATCH 44/64] Update writeexception.xml to en --- .../driver/exception/writeexception.xml | 23 +++++++++++-------- 1 file changed, 14 insertions(+), 9 deletions(-) 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; From 324d602501a4bac241e2bce70fe430d576ead077 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 23:23:17 +0300 Subject: [PATCH 45/64] Update construct.xml to en --- .../mongodb/driver/manager/construct.xml | 456 ++++++------------ 1 file changed, 157 insertions(+), 299 deletions(-) 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. Date: Sat, 26 Apr 2025 23:25:26 +0300 Subject: [PATCH 46/64] Update executebulkwrite.xml to en --- .../mongodb/driver/manager/executebulkwrite.xml | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/reference/mongodb/mongodb/driver/manager/executebulkwrite.xml b/reference/mongodb/mongodb/driver/manager/executebulkwrite.xml index 51474c3354..155e1c4a0c 100644 --- a/reference/mongodb/mongodb/driver/manager/executebulkwrite.xml +++ b/reference/mongodb/mongodb/driver/manager/executebulkwrite.xml @@ -1,5 +1,5 @@ - + @@ -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()); } From f50fde6d7e9c89e31299c6356c25a23c747847fb Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 23:26:20 +0300 Subject: [PATCH 47/64] Update executecommand.xml to en --- .../mongodb/mongodb/driver/manager/executecommand.xml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) 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 From 9e0318e177d547a54e460cfdbc19ef8943a2f30e Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 23:27:09 +0300 Subject: [PATCH 48/64] Update executequery.xml to en --- .../mongodb/mongodb/driver/manager/executequery.xml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) 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 From ed9d968d94fbc9df28fc40ac032bc8e2dbaf4b80 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 23:28:38 +0300 Subject: [PATCH 49/64] Update commandsubscriber.xml to en --- .../mongodb/driver/monitoring/commandsubscriber.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) 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; From d4c1d1423db60eae7f86a717034000fe55d454cb Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 23:29:56 +0300 Subject: [PATCH 50/64] Update sdamsubscriber.xml to en --- .../mongodb/driver/monitoring/sdamsubscriber.xml | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) 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; From 0b87e325484fe34d9b849719d6cee8ce03210392 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 23:30:38 +0300 Subject: [PATCH 51/64] Update getserver.xml to en --- .../commandfailedevent/getserver.xml | 24 ++++++++++++++++--- 1 file changed, 21 insertions(+), 3 deletions(-) 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; From 5b5044143b7715f1d93edd575a345c8f617e9e1e Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 23:31:21 +0300 Subject: [PATCH 52/64] Update getserver.xml to en --- .../commandstartedevent/getserver.xml | 24 ++++++++++++++++--- 1 file changed, 21 insertions(+), 3 deletions(-) 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; From 74053a08f786cd80f097d441cd0fe8be4e4c11e1 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 23:31:58 +0300 Subject: [PATCH 53/64] Update getserver.xml to en --- .../commandsucceededevent/getserver.xml | 24 ++++++++++++++++--- 1 file changed, 21 insertions(+), 3 deletions(-) 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; From c82536672497af9cad004ee47dc5b494bb27049d Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 23:42:35 +0300 Subject: [PATCH 54/64] Update construct.xml to en --- .../mongodb/driver/query/construct.xml | 111 ++++++------------ 1 file changed, 36 insertions(+), 75 deletions(-) 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); From af1c899635d88f4205e245a15a525c78d2e799d8 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sat, 26 Apr 2025 23:43:55 +0300 Subject: [PATCH 55/64] Update construct.xml to en --- .../mongodb/driver/readpreference/construct.xml | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) 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 From 030f5ba23f8ff2465772801904b9a7220d729ca0 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sun, 27 Apr 2025 00:24:23 +0300 Subject: [PATCH 56/64] Update getmode.xml to en --- .../mongodb/driver/readpreference/getmode.xml | 25 ++++++++++++++++--- 1 file changed, 21 insertions(+), 4 deletions(-) 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; From 3ac095e463189239b8f811b736df90f820aa3cfb Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sun, 27 Apr 2025 00:25:33 +0300 Subject: [PATCH 57/64] Update executebulkwrite.xml to en --- .../mongodb/driver/server/executebulkwrite.xml | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) 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 передачу объекта запретят. From 7236e66adb2ea930b88cbb78623fcf36e389b89e Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sun, 27 Apr 2025 00:26:30 +0300 Subject: [PATCH 58/64] Update executecommand.xml to en --- .../mongodb/mongodb/driver/server/executecommand.xml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) 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 From 5b716e899f254fac25fc711694e8ff418423fb7f Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sun, 27 Apr 2025 00:27:19 +0300 Subject: [PATCH 59/64] Update executequery.xml to en --- reference/mongodb/mongodb/driver/server/executequery.xml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) 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 From 31e4661d6a0dd47d8a56af6830bbb18d86e8fd00 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sun, 27 Apr 2025 00:29:37 +0300 Subject: [PATCH 60/64] Update getdeletedcount.xml to en --- .../driver/writeresult/getdeletedcount.xml | 31 ++++++++++++++----- 1 file changed, 24 insertions(+), 7 deletions(-) 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]); From 75a95ea010cb1723016a8b369a9d23be6865122b Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sun, 27 Apr 2025 00:37:30 +0300 Subject: [PATCH 61/64] Update getinsertedcount.xml to en --- .../driver/writeresult/getinsertedcount.xml | 33 ++++++++++++++----- 1 file changed, 25 insertions(+), 8 deletions(-) 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]); From 041bbb076cb77f46f74ad0f8dc0f705f728f9c6b Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sun, 27 Apr 2025 00:39:07 +0300 Subject: [PATCH 62/64] Update getmatchedcount.xml to en --- .../driver/writeresult/getmatchedcount.xml | 32 ++++++++++++++----- 1 file changed, 24 insertions(+), 8 deletions(-) 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; From be9df4272398b69f48885dcc11241de7864cdac5 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sun, 27 Apr 2025 00:43:26 +0300 Subject: [PATCH 63/64] Update getmodifiedcount.xml to en --- .../driver/writeresult/getmodifiedcount.xml | 42 ++++++++++++------- 1 file changed, 27 insertions(+), 15 deletions(-) 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]); From 84f677f8bf114b4e99f3e3ca288457cdc767a74e Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Sun, 27 Apr 2025 00:46:05 +0300 Subject: [PATCH 64/64] Update getupsertedcount.xml to en --- .../driver/writeresult/getupsertedcount.xml | 32 +++++++++++++++---- 1 file changed, 25 insertions(+), 7 deletions(-) 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]);