<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/mongodb.mongodb.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'class.mongodb-driver-readpreference.php',
    1 => 'MongoDB\\Driver\\ReadPreference',
    2 => 'La classe MongoDB\\Driver\\ReadPreference',
  ),
  'up' => 
  array (
    0 => 'mongodb.mongodb.php',
    1 => 'MongoDB\\Driver',
  ),
  'prev' => 
  array (
    0 => 'mongodb-driver-writeconcern.isdefault.php',
    1 => 'MongoDB\\Driver\\WriteConcern::isDefault',
  ),
  'next' => 
  array (
    0 => 'mongodb-driver-readpreference.bsonserialize.php',
    1 => 'MongoDB\\Driver\\ReadPreference::bsonSerialize',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'reference/mongodb/mongodb/driver/readpreference.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/class.mongodb-driver-readpreference.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="class.mongodb-driver-readpreference" class="reference">

 <h1 class="title">La classe MongoDB\Driver\ReadPreference</h1>
 

 <div class="partintro"><p class="verinfo">(mongodb &gt;=1.0.0)</p>


  <div class="section" id="mongodb-driver-readpreference.intro">
   <h2 class="title">Introduction</h2>
   <p class="para">

   </p>
  </div>


  <div class="section" id="mongodb-driver-readpreference.synopsis">
   <h2 class="title">Synopsis de la classe</h2>


   <div class="classsynopsis">
    <span class="ooclass"><strong class="classname"></strong></span>


    <div class="classsynopsisinfo">
     <span class="modifier">final</span>
     <span class="ooclass">
      <span class="modifier">class</span> <strong class="classname">MongoDB\Driver\ReadPreference</strong>
     </span>

     <span class="oointerface"><span class="modifier">implements</span> 
       <a href="class.mongodb-bson-serializable.php" class="interfacename">MongoDB\BSON\Serializable</a></span><span class="oointerface">,  <a href="class.serializable.php" class="interfacename">Serializable</a></span> {</div>

    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Constantes */</div>
    <div class="fieldsynopsis">
     <span class="modifier">const</span>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
      <var class="fieldsynopsis_varname"><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.primary"><var class="varname">PRIMARY</var></a></var><span class="initializer"> = primary</span>;</div>

    <div class="fieldsynopsis"><span class="modifier">const</span>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
      <var class="fieldsynopsis_varname"><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.primary-preferred"><var class="varname">PRIMARY_PREFERRED</var></a></var><span class="initializer"> = primaryPreferred</span>;</div>

    <div class="fieldsynopsis"><span class="modifier">const</span>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
      <var class="fieldsynopsis_varname"><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.secondary"><var class="varname">SECONDARY</var></a></var><span class="initializer"> = secondary</span>;</div>

    <div class="fieldsynopsis"><span class="modifier">const</span>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
      <var class="fieldsynopsis_varname"><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.secondary-preferred"><var class="varname">SECONDARY_PREFERRED</var></a></var><span class="initializer"> = secondaryPreferred</span>;</div>

    <div class="fieldsynopsis"><span class="modifier">const</span>
     <span class="type"><a href="language.types.string.php" class="type string">string</a></span>
      <var class="fieldsynopsis_varname"><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.nearest"><var class="varname">NEAREST</var></a></var><span class="initializer"> = nearest</span>;</div>

    <div class="fieldsynopsis"><span class="modifier">const</span>
     <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
      <var class="fieldsynopsis_varname"><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.no-max-staleness"><var class="varname">NO_MAX_STALENESS</var></a></var><span class="initializer"> = -1</span>;</div>

    <div class="fieldsynopsis"><span class="modifier">const</span>
     <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>
      <var class="fieldsynopsis_varname"><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.smallest-max-staleness-seconds"><var class="varname">SMALLEST_MAX_STALENESS_SECONDS</var></a></var><span class="initializer"> = 90</span>;</div>


    <div class="classsynopsisinfo classsynopsisinfo_comment">/* Méthodes */</div>
    <div class="methodsynopsis dc-description">
   <span class="modifier">final</span> <span class="modifier">public</span> <span class="methodname"><a href="mongodb-driver-readpreference.bsonserialize.php" class="methodname">bsonSerialize</a></span>(): <span class="type"><a href="class.stdclass.php" class="type stdClass">stdClass</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">final</span> <span class="modifier">public</span> <span class="methodname"><a href="mongodb-driver-readpreference.construct.php" class="methodname">__construct</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$mode</code></span>, <span class="methodparam"><span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.array.php" class="type array">array</a></span></span> <code class="parameter">$tagSets</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>, <span class="methodparam"><span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.array.php" class="type array">array</a></span></span> <code class="parameter">$options</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>)</div>
<div class="methodsynopsis dc-description"><span class="modifier">final</span> <span class="modifier">public</span> <span class="methodname"><a href="mongodb-driver-readpreference.gethedge.php" class="methodname">getHedge</a></span>(): <span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.object.php" class="type object">object</a></span></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">final</span> <span class="modifier">public</span> <span class="methodname"><a href="mongodb-driver-readpreference.getmaxstalenessseconds.php" class="methodname">getMaxStalenessSeconds</a></span>(): <span class="type"><a href="language.types.integer.php" class="type int">int</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">final</span> <span class="modifier">public</span> <span class="methodname"><a href="mongodb-driver-readpreference.getmode.php" class="methodname">getMode</a></span>(): <span class="type"><a href="language.types.integer.php" class="type int">int</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">final</span> <span class="modifier">public</span> <span class="methodname"><a href="mongodb-driver-readpreference.getmodestring.php" class="methodname">getModeString</a></span>(): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">final</span> <span class="modifier">public</span> <span class="methodname"><a href="mongodb-driver-readpreference.gettagsets.php" class="methodname">getTagSets</a></span>(): <span class="type"><a href="language.types.array.php" class="type array">array</a></span></div>

   }</div>


  </div>
  

  <div class="section" id="mongodb-driver-readpreference.constants">
   <h2 class="title">Constantes pré-définies</h2>
   <dl>

    
     <dt id="mongodb-driver-readpreference.constants.primary"><strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.primary">MongoDB\Driver\ReadPreference::PRIMARY</a></code></strong></dt>
     <dd>
      <p class="para">
       Toutes les opérations lues à partir du jeu de réplicas actuel primaire.
       Il s&#039;agit de la préférence de lecture par défaut pour MongoDB.
      </p>
     </dd>
    

    
     <dt id="mongodb-driver-readpreference.constants.primary-preferred"><strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.primary-preferred">MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED</a></code></strong></dt>
     <dd>
      <p class="para">
       Dans la plupart des situations, les opérations sont lues à partir du 
       primaire, mais s&#039;il n&#039;est pas disponible, les opérations sont lues à partir 
       de membres secondaires.
      </p>
     </dd>
    

    
     <dt id="mongodb-driver-readpreference.constants.secondary"><strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.secondary">MongoDB\Driver\ReadPreference::SECONDARY</a></code></strong></dt>
     <dd>
      <p class="para">
       Toutes les opérations sont lues à partir des membres secondaires du jeu de réplicas.
      </p>
     </dd>
    

    
     <dt id="mongodb-driver-readpreference.constants.secondary-preferred"><strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.secondary-preferred">MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED</a></code></strong></dt>
     <dd>
      <p class="para">
       Dans la plupart des cas, les opérations sont lues par des membres 
       secondaires, mais si aucun membre secondaire n&#039;est disponible, les 
       opérations sont lues à partir du primaire.
      </p>
     </dd>
    

    
     <dt id="mongodb-driver-readpreference.constants.nearest"><strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.nearest">MongoDB\Driver\ReadPreference::NEAREST</a></code></strong></dt>
     <dd>
      <p class="para">
       Les opérations sont lues à partir du membre du jeu de réplicas avec la 
       latence de réseau la moins élevée, quel que soit le type du membre.
      </p>
     </dd>
    

    
     <dt id="mongodb-driver-readpreference.constants.no-max-staleness"><strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.no-max-staleness">MongoDB\Driver\ReadPreference::NO_MAX_STALENESS</a></code></strong></dt>
     <dd>
      <p class="para">
       La valeur par défaut de l&#039;option <code class="literal">&quot;maxStalenessSeconds&quot;</code> 
       est de ne spécifier aucune limite sur l&#039;obsolescence maximale, ce qui 
       signifie que le pilote ne prendra pas en compte le décalage d&#039;un 
       secondaire lors du choix de l&#039;endroit où diriger une opération de lecture.
      </p>
     </dd>
    

    
     <dt id="mongodb-driver-readpreference.constants.smallest-max-staleness-seconds"><strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.smallest-max-staleness-seconds">MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS</a></code></strong></dt>
     <dd>
      <p class="para">
       La valeur minimale de l&#039;option <code class="literal">&quot;maxStalenessSeconds&quot;</code> 
       est de 90 secondes. Le pilote estime l&#039;obsolescence des secondes en 
       vérifiant périodiquement la dernière date d&#039;écriture de chaque membre du 
       jeu de réplicas. Comme ces contrôles sont peu fréquents, l&#039;estimation de 
       l&#039;obsolescence est grossière. Ainsi, le pilote ne peut pas appliquer une 
       valeur d&#039;obsolescence maximale inférieure à 90 secondes.
      </p>
     </dd>
    

   </dl>
  </div>


  <div class="section">
   <h2 class="title">Historique</h2>
   <p class="para">
    <table class="doctable informaltable">
     
      <thead>
       <tr>
        <th>Version</th>
        <th>Description</th>
       </tr>

      </thead>

      <tbody class="tbody">
       <tr>
        <td>PECL mongodb 2.0.0</td>
        <td>
         <p class="para">
          Supprimer les constantes
          <strong><code>MongoDB\Driver\ReadPreference::RP_PRIMARY</code></strong>,
          <strong><code>MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED</code></strong>,
          <strong><code>MongoDB\Driver\ReadPreference::RP_SECONDARY</code></strong>,
          <strong><code>MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED</code></strong>,
          et <strong><code>MongoDB\Driver\ReadPreference::RP_NEAREST</code></strong>.
          La méthode <span class="methodname"><strong>getMode()</strong></span> a également été supprimée.
         </p>
        </td>
       </tr>

       <tr>
        <td>PECL mongodb 1.20.0</td>
        <td>
         <p class="para">
          Les constantes
          <strong><code>MongoDB\Driver\ReadPreference::RP_PRIMARY</code></strong>,
          <strong><code>MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED</code></strong>,
          <strong><code>MongoDB\Driver\ReadPreference::RP_SECONDARY</code></strong>,
          <strong><code>MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED</code></strong>,
          et <strong><code>MongoDB\Driver\ReadPreference::RP_NEAREST</code></strong>
          sont obsolètes.
         </p>
        </td>
       </tr>

       <tr>
        <td>PECL mongodb 1.7.0</td>
        <td>
         <p class="para">
          Ajout des constantes
          <strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.primary">MongoDB\Driver\ReadPreference::PRIMARY</a></code></strong>,
          <strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.primary-preferred">MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED</a></code></strong>,
          <strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.secondary">MongoDB\Driver\ReadPreference::SECONDARY</a></code></strong>,
          <strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.secondary-preferred">MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED</a></code></strong>,
          <strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.nearest">MongoDB\Driver\ReadPreference::NEAREST</a></code></strong>.
         </p>
         <p class="para">
          Implémente <span class="interfacename"><a href="class.serializable.php" class="interfacename">Serializable</a></span>.
         </p>
        </td>
       </tr>

       <tr>
        <td>PECL mongodb 1.2.0</td>
        <td>
         <p class="para">
          Ajout des constantes
          <strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.no-max-staleness">MongoDB\Driver\ReadPreference::NO_MAX_STALENESS</a></code></strong>
          et
          <strong><code><a href="class.mongodb-driver-readpreference.php#mongodb-driver-readpreference.constants.smallest-max-staleness-seconds">MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS</a></code></strong>.
         </p>
         <p class="para">
          Implémente <span class="interfacename"><a href="class.mongodb-bson-serializable.php" class="interfacename">MongoDB\BSON\Serializable</a></span>.
         </p>
        </td>
       </tr>

      </tbody>
     
    </table>

   </p>
  </div>

 </div>

 


















































<h2>Sommaire</h2><ul class="chunklist chunklist_reference"><li><a href="mongodb-driver-readpreference.bsonserialize.php">MongoDB\Driver\ReadPreference::bsonSerialize</a> — Renvoie un objet pour la s&eacute;rialisation BSON</li><li><a href="mongodb-driver-readpreference.construct.php">MongoDB\Driver\ReadPreference::__construct</a> — Cr&eacute;er un nouveau ReadPreference</li><li><a href="mongodb-driver-readpreference.gethedge.php">MongoDB\Driver\ReadPreference::getHedge</a> — Renvoie l'option &quot;hedge&quot; du ReadPreference</li><li><a href="mongodb-driver-readpreference.getmaxstalenessseconds.php">MongoDB\Driver\ReadPreference::getMaxStalenessSeconds</a> — Renvoie l'option &quot;maxStalenessSeconds&quot; du ReadPreference</li><li><a href="mongodb-driver-readpreference.getmode.php">MongoDB\Driver\ReadPreference::getMode</a> — Renvoie l'option &quot;mode&quot; du ReadPreference</li><li><a href="mongodb-driver-readpreference.getmodestring.php">MongoDB\Driver\ReadPreference::getModeString</a> — Renvoie l'option &quot;mode&quot; du ReadPreference</li><li><a href="mongodb-driver-readpreference.gettagsets.php">MongoDB\Driver\ReadPreference::getTagSets</a> — Renvoie l'option &quot;tagSets&quot; de ReadPreference</li></ul>
</div>
<?php manual_footer($setup); ?>