MongoClient::getHosts

(PECL mongo >=1.3.0)

MongoClient::getHosts — Actualiza el estado de todos los hosts asociados

Esta extenisón que define este método está obsoleta. En su lugar debe usarse la extensión MongoDB. Las alternativas a este método son:

Descripción

public MongoClient::getHosts ( void ) : array

Este método solamente es útil con una conexión a un conjunto de réplica. Devuelve el estado de todos los hosts del conjunto. Sin un conjunto de réplica, solamente devolverá un array con un elemento que contiene el host al que se está conectado.

Véase la sección de consultas de este manula para información sobre la distribución de lecturas a secundarios.

Parámetros

Esta función no tiene parámetros.

Valores devueltos

Devuelve un array con la información sobre los hosts del conjunto. Incluye el nombre de cada host, su salud (1 para saludable), su estado (1 para primario, 2 para secundairo, 0 para lo demás), el tiempo que toma en realizar un 'ping' al servidor, y cúando ocurrió el último 'ping'. Por ejemplo, en un conjunto de réplica de tres miembros, el array podría parecerse a esto: 

array(3) {
  ["A:27017"]=>
  array(4) {
    ["host"]=>
    "A"
    ["port"]=>
    27017
    ["health"]=>
    int(1)
    ["state"]=>
    int(2)
    ["ping"]=>
    int(369)
    ["lastPing"]=>
    int(1309470644)
  }
  ["B:27017"]=>
  array(4) {
    ["host"]=>
    "B"
    ["port"]=>
    27017
    ["health"]=>
    int(1)
    ["state"]=>
    int(1)
    ["ping"]=>
    int(139)
    ["lastPing"]=>
    int(1309470644)
  }
  ["C:27017"]=>
  array(4) {
    ["host"]=>
    "C"
    ["port"]=>
    27017
    ["health"]=>
    int(1)
    ["state"]=>
    int(2)
    ["ping"]=>
    int(1012)
    ["lastPing"]=>
    int(1309470644)
  }
}

Historial de cambios

Versión Descripción
1.2.10

Se añadió el soporte para hosts que no pertenecen a un conjunto de réplica.

Los elementos del array devuelto ahora también incluyen hostname y port.

Ver también