Skip to content

Sync EN: MongoDB readonly properties and IWM URI options #1302

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lacatoire wants to merge 5 commits into
base: master
Choose a base branch
from
Open

Sync EN: MongoDB readonly properties and IWM URI options #1302

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
d14a20f
Sync EN mongodb: readonly props on exceptions, topology events; IWM U…
lacatoire May 11, 2026
6f7b22b
Sync EN mongodb: readonly props on server/heartbeat monitoring events
lacatoire May 11, 2026
9239c6a
Sync EN mongodb: readonly props on command monitoring events
lacatoire May 11, 2026
8b0138e
Sync EN mongodb: readonly props on readconcern, writeconcern, readpre…
lacatoire May 11, 2026
355ba69
Sync EN mongodb: readonly props on writeresult, writeerror, writeconc…
lacatoire May 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions reference/mongodb/mongodb/driver/exception/bulkwriteexception.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e3c3525f7f288bc3a455a9619215fa759c2a9f5f Maintainer: lex Status: ready -->
<!-- EN-Revision: 36c32a2a930308443ad7fcbbc373c31cc02b9a4e Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.mongodb-driver-exception-bulkwriteexception" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

Expand Down Expand Up @@ -42,7 +42,8 @@
<!-- }}} -->
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>protected</modifier>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>MongoDB\Driver\WriteResult</type>
<varname linkend="mongodb-driver-exception-bulkwriteexception.props.writeresult">writeResult</varname>
</fieldsynopsis>
Expand Down Expand Up @@ -96,6 +97,15 @@
</row>
</thead>
<tbody>
<row>
<entry>PECL-модуль mongodb 2.3.0</entry>
<entry>
<para>
Свойство <varname>writeResult</varname> теперь является
<modifier>public</modifier> <modifier>readonly</modifier>.
</para>
</entry>
</row>
<row>
<entry>PECL-модуль mongodb 2.0.0</entry>
<entry>
Expand Down
28 changes: 26 additions & 2 deletions reference/mongodb/mongodb/driver/exception/commandexception.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 0df9823f6a218f95f8aa9f5c0460009cec9ecfd0 Maintainer: lex Status: ready -->
<!-- EN-Revision: 36c32a2a930308443ad7fcbbc373c31cc02b9a4e Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.mongodb-driver-exception-commandexception" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

Expand Down Expand Up @@ -43,7 +43,8 @@
<!-- }}} -->
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>protected</modifier>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>object</type>
<varname linkend="mongodb-driver-exception-commandexception.props.resultdocument">resultDocument</varname>
</fieldsynopsis>
Expand Down Expand Up @@ -85,6 +86,29 @@
</section>
<!-- }}} -->

<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL-модуль mongodb 2.3.0</entry>
<entry>
Свойство <varname>resultDocument</varname> теперь является
<modifier>public</modifier> <modifier>readonly</modifier>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

</partintro>

&reference.mongodb.mongodb.driver.exception.entities.commandexception;
Expand Down
23 changes: 22 additions & 1 deletion reference/mongodb/mongodb/driver/manager/construct.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7ba4efc7524c06343c6e9f1fc2b10f91cfdfd945 Maintainer: lex Status: ready -->
<!-- EN-Revision: 36c32a2a930308443ad7fcbbc373c31cc02b9a4e Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mongodb-driver-manager.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand Down Expand Up @@ -212,6 +212,16 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
</para>
</entry>
</row>
<row>
<entry>enableOverloadRetargeting</entry>
<entry><type>bool</type></entry>
<entry>
<simpara>
Если установлено в &true;, форсирует выбор сервера после ошибки
<literal>SystemOverloadedError</literal>. По умолчанию &false;.
</simpara>
</entry>
</row>
<row>
<entry>heartbeatFrequencyMS</entry>
<entry><type>int</type></entry>
Expand Down Expand Up @@ -263,6 +273,17 @@ mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][
</para>
</entry>
</row>
<row>
<entry>maxAdaptiveRetries</entry>
<entry><type>int</type></entry>
<entry>
<simpara>
Опция используется для изменения максимального числа повторов
при возникновении ошибки <literal>SystemOverloadedError</literal>.
Значение должно быть положительным целым; по умолчанию <literal>2</literal>.
</simpara>
</entry>
</row>
<row>
<entry>maxStalenessSeconds</entry>
<entry><type>int</type></entry>
Expand Down
183 changes: 182 additions & 1 deletion reference/mongodb/mongodb/driver/monitoring/commandfailedevent.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e9366ee458b2900c53a503b1ad97664e1d9a8859 Maintainer: lex Status: ready -->
<!-- EN-Revision: 36c32a2a930308443ad7fcbbc373c31cc02b9a4e Maintainer: lex Status: ready -->
<!-- Reviewed: no -->

<reference xml:id="class.mongodb-driver-monitoring-commandfailedevent" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
Expand Down Expand Up @@ -35,13 +35,194 @@
</classsynopsisinfo>
<!-- }}} -->

<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>string</type>
<varname linkend="mongodb-driver-monitoring-commandfailedevent.props.host">host</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>int</type>
<varname linkend="mongodb-driver-monitoring-commandfailedevent.props.port">port</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>string</type>
<varname linkend="mongodb-driver-monitoring-commandfailedevent.props.commandname">commandName</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>string</type>
<varname linkend="mongodb-driver-monitoring-commandfailedevent.props.databasename">databaseName</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>int</type>
<varname linkend="mongodb-driver-monitoring-commandfailedevent.props.duration">duration</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>Exception</type>
<varname linkend="mongodb-driver-monitoring-commandfailedevent.props.error">error</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>object</type>
<varname linkend="mongodb-driver-monitoring-commandfailedevent.props.reply">reply</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>string</type>
<varname linkend="mongodb-driver-monitoring-commandfailedevent.props.operationid">operationId</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>string</type>
<varname linkend="mongodb-driver-monitoring-commandfailedevent.props.requestid">requestId</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type class="union"><type>MongoDB\BSON\ObjectId</type><type>null</type></type>
<varname linkend="mongodb-driver-monitoring-commandfailedevent.props.serviceid">serviceId</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type class="union"><type>int</type><type>null</type></type>
<varname linkend="mongodb-driver-monitoring-commandfailedevent.props.serverconnectionid">serverConnectionId</varname>
</fieldsynopsis>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.mongodb-driver-monitoring-commandfailedevent')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
</classsynopsis>
<!-- }}} -->

</section>

<!-- {{{ MongoDB\Driver\Monitoring\CommandFailedEvent properties -->
<section xml:id="mongodb-driver-monitoring-commandfailedevent.props">
&reftitle.properties;
<variablelist>
<varlistentry xml:id="mongodb-driver-monitoring-commandfailedevent.props.host">
<term><varname>host</varname></term>
<listitem>
<simpara>Имя хоста сервера, который выполнил команду.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="mongodb-driver-monitoring-commandfailedevent.props.port">
<term><varname>port</varname></term>
<listitem>
<simpara>Порт сервера, который выполнил команду.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="mongodb-driver-monitoring-commandfailedevent.props.commandname">
<term><varname>commandName</varname></term>
<listitem>
<simpara>Имя команды.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="mongodb-driver-monitoring-commandfailedevent.props.databasename">
<term><varname>databaseName</varname></term>
<listitem>
<simpara>Имя базы данных.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="mongodb-driver-monitoring-commandfailedevent.props.duration">
<term><varname>duration</varname></term>
<listitem>
<simpara>
Длительность команды в микросекундах. Длительность представляет собой
расчётное значение, которое включает время отправки сообщения
и получения ответа от сервера.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="mongodb-driver-monitoring-commandfailedevent.props.error">
<term><varname>error</varname></term>
<listitem>
<simpara>Исключение, которое было выброшено при сбое команды.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="mongodb-driver-monitoring-commandfailedevent.props.reply">
<term><varname>reply</varname></term>
<listitem>
<simpara>Документ ответа об ошибке, который вернул сервер.</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="mongodb-driver-monitoring-commandfailedevent.props.operationid">
<term><varname>operationId</varname></term>
<listitem>
<simpara>
Идентификатор операции. Используется для связывания событий между собой,
например, для bulk-операций записи, которые могут порождать несколько команд.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="mongodb-driver-monitoring-commandfailedevent.props.requestid">
<term><varname>requestId</varname></term>
<listitem>
<simpara>
Идентификатор запроса. Используется для связывания события
<classname>MongoDB\Driver\Monitoring\CommandFailedEvent</classname>
с соответствующим
<classname>MongoDB\Driver\Monitoring\CommandStartedEvent</classname>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="mongodb-driver-monitoring-commandfailedevent.props.serviceid">
<term><varname>serviceId</varname></term>
<listitem>
<simpara>
Идентификатор службы или &null;, если сервер не поддерживает его
(то есть когда не используется режим балансировки нагрузки).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="mongodb-driver-monitoring-commandfailedevent.props.serverconnectionid">
<term><varname>serverConnectionId</varname></term>
<listitem>
<simpara>Идентификатор соединения с сервером или &null;, если недоступен.</simpara>
</listitem>
</varlistentry>
</variablelist>
</section>
<!-- }}} -->

<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL-модуль mongodb 2.3.0</entry>
<entry>
Добавлены свойства <modifier>public</modifier> <modifier>readonly</modifier>.
Свойство <varname>duration</varname> заменяет метод
<methodname>getDurationMicros</methodname>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>

</partintro>

&reference.mongodb.mongodb.driver.monitoring.entities.commandfailedevent;
Expand Down
Loading
Loading