mongodb sync with EN (#1517)

php · Sep 27, 2024 · 429a65d · 429a65d
1 parent 8cf92b6
commit 429a65d
Show file tree

Hide file tree

Showing 15 changed files with 82 additions and 29 deletions.
diff --git a/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/serverchanged.xml b/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/serverchanged.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e9214a2619efc5906fab59cd42fb7404c4dc49a5 Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="mongodb-driver-monitoring-sdamsubscriber.serverchanged" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -15,7 +15,8 @@
   </methodsynopsis>
   <para>
    Si un observateur est enregistré, cette méthode est appelée lorsqu'une
-   description de serveur change.
+   description de serveur change. Par exemple, le type d'un serveur passant de secondaire à
+   primaire entraînerait un changement de la description de ce serveur.
   </para>
  </refsect1>
 

diff --git a/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/serverclosed.xml b/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/serverclosed.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e9214a2619efc5906fab59cd42fb7404c4dc49a5 Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="mongodb-driver-monitoring-sdamsubscriber.serverclosed" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -14,8 +14,8 @@
    <methodparam><type>MongoDB\Driver\Monitoring\ServerClosedEvent</type><parameter>event</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Si un observateur est enregistré, cette méthode est appelée lorsqu'un serveur est
-   fermé.
+   Si un observateur est enregistré, cette méthode est appelée lorsqu'un serveur existant
+   est retiré de la topologie.
   </para>
  </refsect1>
 

diff --git a/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/serveropening.xml b/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/serveropening.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e9214a2619efc5906fab59cd42fb7404c4dc49a5 Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="mongodb-driver-monitoring-sdamsubscriber.serveropening" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -14,8 +14,8 @@
    <methodparam><type>MongoDB\Driver\Monitoring\ServerOpeningEvent</type><parameter>event</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Si un observateur est enregistré, cette méthode est appelée lorsqu'un serveur est
-   ouvert.
+   Si un observateur est enregistré, cette méthode est appelée lorsqu'un serveur existant
+   est retiré de la topologie.
   </para>
  </refsect1>
 

diff --git a/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/topologychanged.xml b/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/topologychanged.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e9214a2619efc5906fab59cd42fb7404c4dc49a5 Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="mongodb-driver-monitoring-sdamsubscriber.topologychanged" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -15,7 +15,8 @@
   </methodsynopsis>
   <para>
    Si un observateur est enregistré, cette méthode est appelée lorsqu'une
-   description de topologie change.
+   description de topologie change. Par exemple, la découverte d'un nouveau primaire dans un ensemble de répliques
+   entraînerait un changement de la description de la topologie.
   </para>
  </refsect1>
 

diff --git a/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/topologyclosed.xml b/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/topologyclosed.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e9214a2619efc5906fab59cd42fb7404c4dc49a5 Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="mongodb-driver-monitoring-sdamsubscriber.topologyclosed" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,15 @@
    Si un observateur est enregistré, cette méthode est appelée lorsqu'une
    topologie est fermée.
   </para>
+  <note>
+   <simpara>
+    En raison du comportement du pilote
+    <link linkend="mongodb.connection-handling">de gestion et de persistance des connexions</link>,
+    cet événement ne peut être observé que lorsqu'un
+    <classname>MongoDB\Driver\Manager</classname> est créé avec l'option du pilote
+    <literal>"disableClientPersistence"</literal> et libéré avant la fermeture de la requête (RSHUTDOWN).
+   </simpara>
+  </note>
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/topologyopening.xml b/reference/mongodb/mongodb/driver/monitoring/sdamsubscriber/topologyopening.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e9214a2619efc5906fab59cd42fb7404c4dc49a5 Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="mongodb-driver-monitoring-sdamsubscriber.topologyopening" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -17,6 +17,15 @@
    Si un observateur est enregistré, cette méthode est appelée lorsqu'une
    topologie est ouverte.
   </para>
+  <note>
+   <simpara>
+    En raison du comportement du pilote
+    <link linkend="mongodb.connection-handling">de gestion et de persistance des connexions</link>,
+    cet événement peut ne pas être observé si un
+    <classname>MongoDB\Driver\Manager</classname> utilise un client
+    <link xlink:href="&url.mongodb.libmongoc;">libmongoc</link> précédemment persistant.
+   </simpara>
+  </note>
  </refsect1>
 
  <refsect1 role="parameters">

diff --git a/reference/mongodb/mongodb/driver/monitoring/serverchangedevent.xml b/reference/mongodb/mongodb/driver/monitoring/serverchangedevent.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes --> 
 <reference xml:id="class.mongodb-driver-monitoring-serverchangedevent" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>La classe MongoDB\Driver\Monitoring\ServerChangedEvent</title>
@@ -12,7 +12,9 @@
    &reftitle.intro;
    <para>
     La classe <classname>MongoDB\Driver\Monitoring\ServerChangedEvent</classname>
-    encapsule des informations sur une description de serveur modifiée.
+    encapsule des informations sur une description de serveur modifiée. Par
+    exemple, le type d'un serveur passant de secondaire à primaire entraînerait
+    un changement de la description de ce serveur.
    </para>
   </section>
 <!-- }}} -->

diff --git a/reference/mongodb/mongodb/driver/monitoring/serverclosedevent.xml b/reference/mongodb/mongodb/driver/monitoring/serverclosedevent.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes --> 
 <reference xml:id="class.mongodb-driver-monitoring-serverclosedevent" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>La classe MongoDB\Driver\Monitoring\ServerClosedEvent</title>
@@ -12,7 +12,8 @@
    &reftitle.intro;
    <para>
     La classe <classname>MongoDB\Driver\Monitoring\ServerClosedEvent</classname>
-    encapsule des informations sur un serveur fermé.
+    encapsule des informations sur un serveur fermé. Cela correspond à un
+    serveur existant étant retiré de la topologie.
    </para>
   </section>
 <!-- }}} -->

diff --git a/reference/mongodb/mongodb/driver/monitoring/serverheartbeatfailedevent.xml b/reference/mongodb/mongodb/driver/monitoring/serverheartbeatfailedevent.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes --> 
 <reference xml:id="class.mongodb-driver-monitoring-serverheartbeatfailedevent" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>La classe MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent</title>
@@ -12,7 +12,10 @@
    &reftitle.intro;
    <para>
     La classe <classname>MongoDB\Driver\Monitoring\ServerHeartbeatFailedEvent</classname>
-    encapsule des informations sur un échec de battement de coeur de serveur.
+    encapsule des informations sur un échec de battement de coeur de serveur (c'est-à-dire
+   <link xlink:href="&url.mongodb.docs;reference/command/hello/">hello</link>
+   commande émise par le biais de
+   <link xlink:href="&url.mongodb.sdam;">surveillance du serveur</link>).
    </para>
   </section>
 <!-- }}} -->

diff --git a/reference/mongodb/mongodb/driver/monitoring/serverheartbeatstartedevent.xml b/reference/mongodb/mongodb/driver/monitoring/serverheartbeatstartedevent.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes --> 
 <reference xml:id="class.mongodb-driver-monitoring-serverheartbeatstartedevent" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>La classe MongoDB\Driver\Monitoring\ServerHeartbeatStartedEvent</title>
@@ -12,7 +12,10 @@
    &reftitle.intro;
    <para>
     La classe <classname>MongoDB\Driver\Monitoring\ServerHeartbeatStartedEvent</classname>
-    encapsule des informations sur un battement de coeur de serveur démarré.
+    encapsule des informations sur un battement de coeur de serveur démarré (c'est-à-dire
+   <link xlink:href="&url.mongodb.docs;reference/command/hello/">commande hello</link>
+   émise par le biais de
+   <link xlink:href="&url.mongodb.sdam;">la surveillance du serveur</link>).
    </para>
   </section>
 <!-- }}} -->

diff --git a/reference/mongodb/mongodb/driver/monitoring/serverheartbeatsucceededevent.xml b/reference/mongodb/mongodb/driver/monitoring/serverheartbeatsucceededevent.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes --> 
 <reference xml:id="class.mongodb-driver-monitoring-serverheartbeatsucceededevent" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>La classe MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent</title>
@@ -12,7 +12,10 @@
    &reftitle.intro;
    <para>
     La classe <classname>MongoDB\Driver\Monitoring\ServerHeartbeatSucceededEvent</classname>
-    encapsule des informations sur un battement de coeur de serveur réussi.
+    encapsule des informations sur un battement de coeur de serveur réussi (c'est-à-dire
+   <link xlink:href="&url.mongodb.docs;reference/command/hello/">commande hello</link>
+   émise via
+   <link xlink:href="&url.mongodb.sdam;">la surveillance du serveur</link>).
    </para>
   </section>
 <!-- }}} -->

diff --git a/reference/mongodb/mongodb/driver/monitoring/serveropeningevent.xml b/reference/mongodb/mongodb/driver/monitoring/serveropeningevent.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes --> 
 <reference xml:id="class.mongodb-driver-monitoring-serveropeningevent" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>La classe MongoDB\Driver\Monitoring\ServerOpeningEvent</title>
@@ -12,7 +12,8 @@
    &reftitle.intro;
    <para>
     La classe <classname>MongoDB\Driver\Monitoring\ServerOpeningEvent</classname>
-    encapsule des informations sur un serveur ouvert.
+    encapsule des informations sur un serveur ouvert. Cela correspond à un
+    nouveau serveur étant ajouté à la topologie.
    </para>
   </section>
 <!-- }}} -->

diff --git a/reference/mongodb/mongodb/driver/monitoring/topologychangedevent.xml b/reference/mongodb/mongodb/driver/monitoring/topologychangedevent.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes --> 
 <reference xml:id="class.mongodb-driver-monitoring-topologychangedevent" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>La classe MongoDB\Driver\Monitoring\TopologyChangedEvent</title>
@@ -12,7 +12,9 @@
    &reftitle.intro;
    <para>
     La classe <classname>MongoDB\Driver\Monitoring\TopologyChangedEvent</classname>
-    encapsule des informations sur une description de topologie modifiée.
+    encapsule des informations sur une description de topologie modifiée. Par
+    exemple, la découverte d'un nouveau primaire dans un ensemble de répliques
+    entraînerait un changement de la description de la topologie.
    </para>
   </section>
 <!-- }}} -->

diff --git a/reference/mongodb/mongodb/driver/monitoring/topologyclosedevent.xml b/reference/mongodb/mongodb/driver/monitoring/topologyclosedevent.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
 <reference xml:id="class.mongodb-driver-monitoring-topologyclosedevent" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>La classe MongoDB\Driver\Monitoring\TopologyClosedEvent</title>
@@ -14,8 +14,17 @@
     La classe <classname>MongoDB\Driver\Monitoring\TopologyClosedEvent</classname>
     encapsule des informations sur une topologie fermée.
    </para>
+   <note>
+    <simpara>
+     En raison du comportement
+     <link linkend="mongodb.connection-handling">de gestion et de persistance des connexions</link>
+     du pilote, cet événement ne peut être observé que lorsqu'un
+     <classname>MongoDB\Driver\Manager</classname> est créé avec l'option du pilote
+     <literal>"disableClientPersistence"</literal> et libéré avant la fermeture de la requête (RSHUTDOWN).
+    </simpara>
+   </note>
   </section>
-<!-- }}} -->
+  <!-- }}} -->
 
   <section xml:id="mongodb-driver-monitoring-topologyclosedevent.synopsis">
    &reftitle.classsynopsis;

diff --git a/reference/mongodb/mongodb/driver/monitoring/topologyopeningevent.xml b/reference/mongodb/mongodb/driver/monitoring/topologyopeningevent.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: Fan2Shrek Status: ready -->
+<!-- EN-Revision: a74c03c56bfe3a14a02380a47e33604b1249dde5 Maintainer: Fan2Shrek Status: ready -->
 <!-- Reviewed: yes -->
 <reference xml:id="class.mongodb-driver-monitoring-topologyopeningevent" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>La classe MongoDB\Driver\Monitoring\TopologyOpeningEvent</title>
@@ -14,6 +14,15 @@
     La classe <classname>MongoDB\Driver\Monitoring\TopologyOpeningEvent</classname>
     encapsule des informations sur une topologie ouverte.
    </para>
+   <note>
+    <simpara>
+     En raison du comportement
+     <link linkend="mongodb.connection-handling">de gestion et de persistance des connexions</link>
+     du pilote, cet événement peut ne pas être observé si un
+     <classname>MongoDB\Driver\Manager</classname> utilise un client
+     <link xlink:href="&url.mongodb.libmongoc;">libmongoc</link> précédemment persistant.
+    </simpara>
+   </note>
   </section>
 <!-- }}} -->