Memcache::connect

memcache_connect

(PECL memcache >= 0.2.0)

Memcache::connect -- memcache_connectОткрывает соединение с сервером memcached

Описание

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

Метод Memcache::connect() устанавливает соединение с сервером memcached. Соединение, которое открыли методом Memcache::connect(), автоматически закрывается при завершении работы скрипта. Соединение закрывают методом Memcache::close().

Список параметров

host

В параметре указывается хост, на котором сервер memcached прослушивает соединения, или другие транспортные протоколы наподобие unix:///path/to/memcached.sock для соединения с сокетом Unix-домена; при соединении с сокетом для параметра port потребуется установить значение 0.

port

В параметре указывается порт, на котором сервер memcached прослушивает соединения. При соединении с сокетом Unix-домена для параметра устанавливают значение 0.

Обратите внимание: при пропуске аргумента значение параметра port становится равным значению директивы memcache.default_port. Поэтому при вызове метода лучше явно указывать порт.

timeout

Время ожидания в секундах для подключения к демону. Изменение значения по умолчанию в 1 секунду часто нивелирует преимущества кеширования на медленных соединениях.

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Примеры

Пример #1 Пример установки соединения с memcached-сервером методом Memcache::connect()

<?php

/* Процедурный API */

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

/* Объектно-ориентированный API */

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

?>

Примечания

Внимание

При пропуске параметра port метод извлекает значение ini-директивы PHP memcache.default_port. При изменении значения директивы в коде приложения поведение метода становится непредсказуемым. Поэтому при вызове метода лучше явно указывать порт.

Смотрите также

  • Memcache::pconnect() - Открывает постоянное соединение с сервером memcached
  • Memcache::close() - Закрывает соединение с сервером memcached