Memcache::connect

memcache_connect

(PECL memcache >= 0.2.0)

Memcache::connect -- memcache_connectAbre a conexão do servidor memcached

Descrição

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

Memcache::connect() estabelece uma conexão com o servidor memcached. A conexão, que foi aberta usando Memcache::connect() será fechada automaticamente no fim da execução do script. Pode-se também fechá-la com Memcache::close().

Parâmetros

host

Aponta para o host onde o memcached está escutando conexões. Este parâmetro também pode especificar outros transportes como unix:///path/to/memcached.sock para usar soquetes de domínio UNIX, neste caso port também deve ser definido como 0.

port

Aponta para a porta onde o memcached está escutando conexões. Defina este parâmetro como 0 ao usar sockets de domínio UNIX.

Observe: port assume como padrão memcache.default_port se não for especificado. Por esse motivo, é sensato especificar a porta explicitamente nessa chamada de método.

timeout

Valor em segundos que será usado para conectar ao daemon. Pense duas vezes antes de alterar o valor padrão de 1 segundo - pode-se perder todas as vantagens do cache se a conexão for muito lenta.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Exemplo #1 Exemplo de Memcache::connect()

<?php

/* API procedural */

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

/* API orientada a objeto */

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

?>

Notas

Aviso

Quando o port não é especificado, este método assume como padrão o conjunto de valores da diretiva INI memcache.default_port do PHP. Se este valor foi alterado em outro lugar no seu aplicativo, isso pode levar a resultados inesperados: por este motivo, é sensato sempre especificar a porta explicitamente nesta chamada de método.

Veja Também