Memcached::addServer
(PECL memcached >= 0.1.0)
Memcached::addServer — Додає сервер до пулу
Опис
public Memcached::addServer(string $host, int $port, int $weight = 0): bool
Memcached::addServer() додає вказаний сервер у пул. При цьому з'єднання встановлено не буде, але якщо ви використовуєте налаштування консистентного розподілу ключів (за допомогою Memcached::DISTRIBUTION_CONSISTENT
або Memcached::OPT_LIBKETAMA_COMPATIBLE
), деякі внутрішні структури даних буде оновлено. Таким чином, якщо вам необхідно додати кілька серверів, краще використовувати Memcached::addServers() т.к. оновлення даних відбувається одноразово.
Один і той самий сервер може зустрічатися в пулі кілька разів, тому що жодних перевірок на дублювання входжень немає. Але це недоцільно; натомість потрібно використовувати параметр weight
підвищення пріоритету даного сервера.
Список параметрів
host
Ім'я хоста memcache сервера. Якщо ім'я хоста буде недійсним, функції, що працюють з даними, встановлять результуючий код Memcached::RES_HOST_LOOKUP_FAILURE
. У версії 2.0.0b1, цей параметр також може визначати шлях до unix сокет файлу, наприклад, /path/to/memcached.sock
для использования сокета домена UNIX (UDS), в данном случаеport
повинен бути встановлений у
port
Порт, на якому працює сервер memcache. Зазвичай це 11211
порт. У версії 2.0.0b1, встановіть цей параметр у при використанні сокету домену UNIX (UDS).
weight
Ваговий коефіцієнт для заданого сервера стосовно загальної ваги всіх серверів у пулі. Ця установка керує ймовірністю сервера бути вибраним для використання. Вона використовується лише у разі консистентного розподілу і зазвичай відповідає кількості пам'яті, доступній для memcache на сервері.
Значення, що повертаються
Повертає true
у разі успішного виконання або **false
**в случае возникновения ошибки.
Приклади
Приклад #1 Приклад використання Memcached::addServer()****
Loading...
Дивіться також
- Memcached::addServers() - Додає кілька серверів у пул
- Memcached::resetServerList() - Очищає список серверів