Memcache::connect

memcache_connect

(PECL memcache >= 0.2.0)

Memcache::connect -- memcache_connectEstablece una conexión con el servidor Memcache

Descripción

Memcache::connect(string $host, int $port = ?, int $timeout = ?): bool
memcache_connect(string $host, int $port = ?, int $timeout = ?): Memcache

Memcache::connect() establece una conexión con el servidor de caché Memcache. La conexión, que ha sido abierta utilizando la función Memcache::connect() se cerrará automáticamente al final del script. No obstante, puede cerrarse manualmente utilizando la función Memcache::close().

Parámetros

host

Especifica el host donde memcache escucha para conexiones. Este parámetro puede también especificar otros transportes como unix:///path/to/memcached.sock para utilizar sockets Unix, y en este caso, port debe también ser definido a 0.

port

Especifica el puerto donde memcache escucha para conexiones. Defina este parámetro a 0 al utilizar sockets Unix.

Nota: Por omisión, el parámetro port toma el valor de la opción de configuración memcache.default_port si no es especificado. Por esta razón, es recomendable especificar explícitamente el puerto al llamar a este método.

timeout

Valor en segundos que será utilizado para conectarse al demonio. Considérelo dos veces antes de cambiar el valor por omisión de un segundo - podría perderse todos los beneficios de utilizar la caché si la conexión es demasiado lenta.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ejemplos

Ejemplo #1 Ejemplo con Memcache::connect()

<?php

/* API procedimental */

$memcache_obj = memcache_connect('memcache_host', 11211);

/* API orientada a objetos */

$memcache = new Memcache;
$memcache->connect('memcache_host', 11211);

?>

Notas

Advertencia

Cuando el parámetro port no es especificado, este método tomará el valor de la directiva de configuración INI memcache.default_port. Si este valor ha sido modificado en otro lugar de la aplicación, esto puede conducir a resultados inesperados: por esta razón, es recomendable siempre especificar el puerto explícitamente al llamar al método.

Ver también