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
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
- MongoClient::getConnections() - Devuelve información sobre todas las conexiones abiertas
add a note
