MongoPool::setSize

(PECL mongo >= 1.2.3)

MongoPool::setSizeEstablece el tamaño de los nuevos agrupamientos de conexiones

Descripción

public static MongoPool::setSize ( int $size ) : bool

Establece el número máximo de conexiones que podrán crear los nuevos agrupamientos.

Parámetros

size

El número máximo de conexiones que podrán crear los nuevos agrupamientos. Un número negativo indica que el agrupamiento podrá generar un número infinito de conexiones.

Valores devueltos

Devuelve el valor del tamaño anterior del agrupamiento.

Historial de cambios

Versión Descripción
1.2.11 Emite un error de nivel E_DEPRECATED cuando se usa.

Ejemplos

Ejemplo #1 Ejemplo de Mongo::setPoolSize()

Si se establece un tamaño de agrupamiento de n y se crean n conexiones, al intentar crear la conexión n+1 se lanzará una excepción de tipo MongoConnectionException.

<?php

// permitir solamente una conexión al servidor
MongoPool::setSize(1);

// crear una conexión a localhost:27017
$m1 = new Mongo();

// intentar crear una segunda conexión a localhost:27017
// puesto que sólo se permite una, se lanzará una excepción
$m2 = new Mongo();

?>

El resultado del ejemplo sería algo similar a:

Fatal error: Uncaught exception 'MongoConnectionException' with message 'no more connections in pool' in /path/to/php/script.php:10
Stack trace:
#0 /path/to/php/script.php(10): Mongo->__construct()
#1 {main}
  thrown in /path/to/php/script.php on line 10

Ver también