Memcache::connect

    memcache_connect

    (PECL memcache >= 0.2.0)

    Memcache::connect -- memcache_connect — Establece 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

    Esta función retorna true en caso de éxito o false si ocurre un 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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    11
    geoffrey dot hoffman at gmail dot com
    15 years ago
    If memcached is working, calling memcache_connect( ) returns an Object instance, not a boolean. If memcached is not working, calling memcache_connect( ) throws a notice AND a warning (and returns false as expected). 

<?php
/* memcache is running */
$test1 = memcache_connect('127.0.0.1',11211);
echo gettype($test1);
// object
echo get_class($test1);
// Memcache

/* memcached is stopped */
$test2 = memcache_connect('127.0.0.1',11211);

/*
Notice: memcache_connect(): Server 127.0.0.1 (tcp 11211) failed with: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.
 (10060) in C:\Program Files\Support Tools\- on line 1

Warning: memcache_connect(): Can't connect to 127.0.0.1:11211, A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.
 (10060) in C:\Program Files\Support Tools\- on line 1
*/

echo gettype($test2);
// boolean
echo $test2===false;
// 1
?>

There appears to be no way to check whether memcached is actually running without resorting to error suppression:

<?php
$test3 = @memcache_connect('127.0.0.1',11211);
if( $test3===false ){
   // memcached is _probably_ not running
}
?>
    ＋add a note
    To Top