array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'memcache.setserverparams.php', 1 => 'Memcache::setServerParams', 2 => 'Изменяет параметры и статус сервера во время выполнения', ), 'up' => array ( 0 => 'class.memcache.php', 1 => 'Memcache', ), 'prev' => array ( 0 => 'memcache.setcompressthreshold.php', 1 => 'Memcache::setCompressThreshold', ), 'next' => array ( 0 => 'ref.memcache.php', 1 => 'Функции Memcache', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/memcache/memcache/setserverparams.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Memcache::setServerParams

memcache_set_server_params

(PECL memcache >= 2.1.0)

Memcache::setServerParams -- memcache_set_server_params — Изменяет параметры и статус сервера во время выполнения

Описание

Memcache::setServerParams(
    string $host,
    int $port = 11211,
    int $timeout = ?,
    int $retry_interval = false,
    bool $status = ?,
    callable $failure_callback = ?
): bool
memcache_set_server_params(
    Memcache $memcache,
    string $host,
    int $port = 11211,
    int $timeout = ?,
    int $retry_interval = false,
    bool $status = ?,
    callable $failure_callback = ?
): bool

Метод Memcache::setServerParams() изменяет параметры сервера на лету.

Замечание: Функцию добавили в модуль Memcache версии 2.1.0.

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

host
В параметре указывается хост, на котором сервер memcached прослушивает соединения.
port
В параметре указывается порт, на котором сервер memcached прослушивает соединения.
timeout
Время ожидания в секундах для подключения к демону. Изменение значения по умолчанию в 1 секунду часто нивелирует преимущества кеширования на медленных соединениях.
retry_interval
Параметр управляет частотой проверки доступности отказавшего сервера. Значение по умолчанию равно 15 секундам. Значение "-1" отключает автоматические повторные проверки. Ни этот параметр, ни параметр persistent не влияют на работу метода, если модуль загружается динамически функцией dl().
status
Параметр определяет, помечать ли сервер флагом "онлайн". Одновременная установка значения false для этого параметра и значения -1 для параметра retry_interval оставит отказавший сервер в пуле, чтобы не влиять на алгоритм распределения ключей. Запрос к этому серверу либо запустит механизм отказоустойчивости, либо сразу же прервётся с ошибкой, в зависимости от настройки директивы memcache.allow_failover. Значение по умолчанию равно true — сервер активен и готов принимать запросы.
failure_callback
Пользовательская callback-функция, которая запустится при ошибке. Эта функция вызывается до запуска механизма отказоустойчивости. Функция принимает два параметра — имя хоста и порт отказавшего сервера.

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

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

Примеры

Пример #1 Пример изменения параметров и статуса сервера методом Memcache::setServerParams()

<?php

function _callback_memcache_failure($host, $port)
{
print "неудачное подключение memcache - '$host:$port'";
}

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

$memcache = new Memcache();

// Добавить сервер в офлайн-режиме
$memcache->addServer('memcache_host', 11211, false, 1, 1, -1, false);

// Перевести сервер обратно в онлайн
$memcache->setServerParams('memcache_host', 11211, 1, 15, true, '_callback_memcache_failure');

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

$memcache_obj = memcache_connect('memcache_host', 11211);
memcache_set_server_params($memcache_obj, 'memcache_host', 11211, 1, 15, true, '_callback_memcache_failure');

?>

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