<?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 => 'es',
  ),
  'this' => 
  array (
    0 => 'class.mongodb-driver-readpreference.php',
    1 => 'MongoDB\\Driver\\ReadPreference',
    2 => 'La clase 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' => 'es',
    '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 clase 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">Introducción</h2>
   <p class="para">

   </p>
  </div>


  <div class="section" id="mongodb-driver-readpreference.synopsis">
   <h2 class="title">Sinopsis de la Clase</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étodos */</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 predefinidas</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">
       Todas las operaciones se leen desde el primario actual del conjunto de réplicas.
       Esta es la preferencia de lectura por omisión para 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">
       En la mayoría de las situaciones, las operaciones se leen desde el
       primario, pero si no está disponible, las operaciones se leen desde
       los miembros secundarios.
      </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">
       Todas las operaciones se leen desde los miembros secundarios del conjunto 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">
       En la mayoría de los casos, las operaciones se leen desde los miembros
       secundarios, pero si ningún miembro secundario está disponible, las
       operaciones se leen desde el primario.
      </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">
       Las operaciones se leen desde el miembro del conjunto de réplicas con la
       menor latencia de red, independientemente del tipo de miembro.
      </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">
       El valor por omisión de la opción <code class="literal">&quot;maxStalenessSeconds&quot;</code>
       es no especificar ningún límite sobre la obsolescencia máxima, lo que
       significa que el controlador no tendrá en cuenta el desfase de un
       secundario al elegir dónde dirigir una operación de lectura.
      </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">
       El valor mínimo de la opción <code class="literal">&quot;maxStalenessSeconds&quot;</code>
       es de 90 segundos. El controlador estima la obsolescencia de los segundos verificando
       periódicamente la última fecha de escritura de cada miembro del conjunto de réplicas. Como
       estos controles son poco frecuentes, la estimación de la obsolescencia es aproximada. Por
       lo tanto, el controlador no puede aplicar un valor de obsolescencia máxima inferior a 90 segundos.
      </p>
     </dd>
    

   </dl>
  </div>


  <div class="section">
   <h2 class="title">Historial de cambios</h2>
   <p class="para">
    <table class="doctable informaltable">
     
      <thead>
       <tr>
        <th>Versión</th>
        <th>Descripción</th>
       </tr>

      </thead>

      <tbody class="tbody">
       <tr>
        <td>PECL mongodb 2.0.0</td>
        <td>
         <p class="para">
          Eliminar las 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>,
          y <strong><code>MongoDB\Driver\ReadPreference::RP_NEAREST</code></strong>.
          El método <span class="methodname"><strong>getMode()</strong></span> también fue eliminado.
         </p>
        </td>
       </tr>

       <tr>
        <td>PECL mongodb 1.7.0</td>
        <td>
         <p class="para">
          Añadir las 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">
          Implementa <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">
          Añadir las 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>
          y
          <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">
          Implementa <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>Tabla de contenidos</h2><ul class="chunklist chunklist_reference"><li><a href="mongodb-driver-readpreference.bsonserialize.php">MongoDB\Driver\ReadPreference::bsonSerialize</a> — Devuelve un objeto para la serializaci&oacute;n BSON</li><li><a href="mongodb-driver-readpreference.construct.php">MongoDB\Driver\ReadPreference::__construct</a> — Crear una nueva ReadPreference</li><li><a href="mongodb-driver-readpreference.gethedge.php">MongoDB\Driver\ReadPreference::getHedge</a> — Devuelve la opci&oacute;n &quot;hedge&quot; del ReadPreference</li><li><a href="mongodb-driver-readpreference.getmaxstalenessseconds.php">MongoDB\Driver\ReadPreference::getMaxStalenessSeconds</a> — Devuelve la opci&oacute;n &quot;maxStalenessSeconds&quot; del ReadPreference</li><li><a href="mongodb-driver-readpreference.getmode.php">MongoDB\Driver\ReadPreference::getMode</a> — Devuelve la opci&oacute;n &quot;mode&quot; del ReadPreference</li><li><a href="mongodb-driver-readpreference.getmodestring.php">MongoDB\Driver\ReadPreference::getModeString</a> — Devuelve la opci&oacute;n &quot;mode&quot; del ReadPreference</li><li><a href="mongodb-driver-readpreference.gettagsets.php">MongoDB\Driver\ReadPreference::getTagSets</a> — Devuelve la opci&oacute;n &quot;tagSets&quot; de ReadPreference</li></ul>
</div>
<?php manual_footer($setup); ?>