Налаштування під час виконання
Поведінка цих функцій залежить від установок у php.ini.
Опції налаштування Memcached
| Имя | По умолчанию | Место изменения | Список изменений |
|---|---|---|---|
| memcached.sess_locking | On | INI_ALL | Доступно з memcached 0.1.0. |
| memcached.sess_consistent_hash | On | INI_ALL | Доступно з memcached 2.1.0. Значення за замовчуванням - Onпочинаючи з memcached 3.0.0. |
| memcached.sess_binary | Off | INI_ALL | Доступно з memcached 2.0.0. Замінено на memcached.sess_binary_protocol в memcached 3.0.0. |
| memcached.sess_lock_wait | 150000 | INI_ALL | Доступно з memcached 0.1.0. Видалено в memcached 3.0.0. |
| memcached.sess_prefix | memc.sess.key. | INI_ALL | Доступно з memcached 0.1.0. |
| memcached.sess_number_of_replicas | INI_ALL | Доступно з memcached 2.1.0. | |
| memcached.sess_randomize_replica_read | Off | INI_ALL | Доступно з memcached 2.1.0. |
| memcached.sess_remove_failed | On | INI_ALL | Доступно з memcached 2.1.0. Замінено на memcached.sess_remove_failed_servers в memcached 3.0.0. |
| memcached.compression_type | fastlz | INI_ALL | Доступно з memcached 0.1.0. |
| memcached.compression_factor | 1.3 | INI_ALL | Доступно з memcached 0.1.0. |
| memcached.compression_threshold | 2000 | INI_ALL | Доступно з memcached 0.1.0. |
| memcached.serializer | igbinary | INI_ALL | Доступно з memcached 0.1.0. |
| memcached.use_sasl | Off | INI_SYSTEM | Доступно з memcached 2.2.0. Видалено в memcached 3.0.0. |
| memcached.default_binary_protocol | Off | INI_ALL | Доступно з memcached 3.0.0. |
| memcached.default_connect_timeout | INI_ALL | Доступно з memcached 3.0.0. | |
| memcached.default_consistent_hash | Off | INI_ALL | Доступно з memcached 3.0.0. |
| memcached.sess_binary_protocol | On | INI_ALL | Доступно з memcached 3.0.0. Замінено на memcached.sess_binary |
| memcached.sess_connect_timeout | 1000 | INI_ALL | Доступно з memcached 2.2.0. |
| memcached.sess_consistent_hash_type | ketama | INI_ALL | Доступно з memcached 3.1.0. |
| memcached.sess_lock_expire | INI_ALL | Доступно з memcached 2.2.0. | |
| memcached.sess_lock_retries | 5 | INI_ALL | Доступно з memcached 3.0.0. |
| memcached.sess_lock_wait_max | 150 | INI_ALL | Доступно з memcached 3.0.0. Значення за замовчуванням 150 з memcached 3.1.0 (попереднє значення 2000 |
| memcached.sess_lock_wait_min | 150 | INI_ALL | Доступно з memcached 3.0.0. Значення за замовчуванням 150 з memcached 3.1.0 (попереднє значення 1000 |
| memcached.sess_persistent | Off | INI_ALL | Доступно з memcached 3.0.0. |
| memcached.sess_remove_failed_servers | Off | INI_ALL | Доступно з memcached 3.0.0. Замінено на memcached.sess_remove_failed |
| memcached.sess_server_failure_limit | INI_ALL | Доступно з memcached 3.0.0. | |
| memcached.sess_sasl_password | null | INI_ALL | Доступно з memcached 2.2.0. |
| memcached.sess_sasl_username | null | INI_ALL | Доступно з memcached 2.2.0. |
| memcached.store_retry_count | INI_ALL | Доступно з memcached 2.2.0. Значення за замовчуванням з memcached 3.2.0 (попереднє значення |
Коротке пояснення конфігураційних директив.
memcached.sess_lockingbool
Використовувати блокування сесій. Допустимі значення: On OffПо умолчанию —On
memcached.sess_consistent_hashbool
Если установлено значениеOn, то для обробки сесій буде використано узгоджене хешування (libketama). У разі використання погодженого хешування можна додавати або видаляти вузли кешування без великих втрат кешованих ключів. За замовчуванням -On
memcached.sess_binarybool
Використовувати бінарний режим сесії. Репліки модуля libmemcached працюють тільки якщо включений цей режим. За замовчуванням - Off
memcached.sess_lock_waitint
Час очікування повторної синхронізації сесії у мікросекундах. Під час встановлення цього значення потрібно бути обережним. Допустимі цілочисельні значення. Якщо встановлено значення , то буде використано значення за промовчанням. Негативні значення зменшують блокування спроб блокування. За замовчуванням - 150000
memcached.sess_prefixstring
Префикс ключа сессии. Строка длиной не более 219 байтов. По умолчанию —memc.sess.key
memcached.sess_number_of_replicasint
Записувати дані на ряд додаткових серверів memcached. Це "висока доступність для бідняків", як її називає модуль libmemcached. Якщо це значення позитивне та активований режим sessions_remove_failed_serversКоли сервер memcached виходить з ладу, сесія, як і раніше, доступна з репліки. Однак, якщо сервер memcache, що відмовив, знову стає доступним, він буде читати сесію звідти, яка може мати старі дані або взагалі не мати даних. За замовчуванням -
memcached.sess_randomize_replica_readbool
Випадкове читання репліки memcached сесією.
memcached.sess_remove_failedint
Дозволити автоматичне видалення недоступних серверів memcached.
memcached.compression_typestring
Налаштування типу стиснення, коректні значення: fastlz zlibПо умолчанию —fastlz
memcached.compression_factorfloat
Коефіцієнт стиснення. Зберігати значення стиснутими лише якщо коефіцієнт стиснення перевищує заданий. Зберігаємо стиснутим, якщо: plain_len > comp_len * factorПо умолчанию —1.3 (Економія місця 23%).
memcached.compression_thresholdint
Поріг стиснення. Не стискати серіалізовані значення менше вказаного розміру. За замовчуванням 2000байтов.
memcached.serializerstring
Встановлює стандартний серіалізатор для нових об'єктів memcached. Допустимі значення: php igbinary json json_array msgpack
json
Стандартне для PHP кодування у форматі JSON. Цей серіалізатор швидкий і компактний, але працює тільки з даними в кодуванні UTF-8 і не повністю реалізує серіалізацію. Докладніше про це описано в описі модуля JSON. Доступно з memcached 0.2.0.
json_array
Той же jsonале декодується в масиви. Доступно з memcached 2.0.0.
php
Стандартний серіалізатор PHP.
igbinary
Бінарний серіалізатор. Доступно з memcached 0.1.4
msgpack
Міжмовний двійковий серіалізатор. Доступно з memcached 2.2.0.
По умолчаниюigbinary, якщо доступний, потім igbinaryякщо доступний, інакше PHP.
memcached.use_saslbool
Використовувати автентифікацію SASL під час з'єднання. Допустимі значення: On OffПо умолчанию —Off
memcached.default_binary_protocolbool
Встановлює протокол memcached за промовчанням для нових підключень. (Щоб налаштувати протокол memcached для з'єднань, що використовуються сесіями, замість неї використовують директиву memcached.sess_binary_protocol.) Если установлено значениеOnЗа замовчуванням буде використано двійковий протокол memcached. Якщо встановлено значення Off, буде використаний текстовий протокол memcached. За замовчуванням - Off
memcached.default_connect_timeoutint
Встановлює час очікування з'єднання memcached за промовчанням для нових з'єднань. (Щоб налаштувати час очікування з'єднання memcached для сесій, натомість використовують memcached.sess_connect_timeout.) У неблокуючому режимі це змінює значення часу очікування під час підключення до сокету в мілісекундах. Вказівка -1 означає нескінченний час очікування. Вказівка означает использование времени ожидания соединения по умолчанию для библиотеки memcached. По умолчанию —
memcached.default_consistent_hashbool
Встановлює значення за промовчанням для узгодженого хешування нових підключень. (Щоб налаштувати узгоджене хешування для сесій, натомість використовують memcached.sess_consistent_hash.) Если установлено значениеOnДля обробки сесії використовується узгоджене хешування (libketama). Коли використовується узгоджене хешування, можна додавати або видаляти вузли кеша, не турбуючись про те, що ключі за замовчуванням відключені.
memcached.sess_binary_protocolbool
Використовувати двійковий протокол memcached для сесій memcached (замість текстового протоколу). Репліки модуля libmemcached працюють, тільки якщо включено двійковий режим. Однак деякі проксі (наприклад, twemproxy) працюватимуть, лише якщо двійковий протокол вимкнено. За замовчуванням -On з libmemcached 1.0.18 або більше. До libmemcached 1.0.18 значення за промовчанням Off
Зауваження: У більш старих версіях php-memcached ця директива була вимкнена і називалася
memcached.sess_binary
memcached.sess_connect_timeoutint
Значення часу очікування з'єднання memcached. У неблокувальному режимі це змінює значення часу очікування під час з'єднання сокету в мілісекундах. Вказівка -1 означає нескінченний час очікування.
memcached.sess_consistent_hash_typestring
Тип согласованного хеширования сессии Memcached. Если установлено значениеketama(по умолчанию для php-memcached 3.x), для обработки сессии используется согласованное хеширование модуля libketama, если установлено значениеketama_weighted (за промовчанням для php-memcached 2.x), для обробки сесії використовується зважене узгоджене хешування (модуль libketama). За замовчуванням - ketama
memcached.sess_lock_expireint
Час у секундах до того, як має спрацювати блокування. Встановлення значення приводит к поведению по умолчанию — будет использована PHP-директиваmax_execution_timeПо умолчанию —
memcached.sess_lock_retriesint
Кількість спроб повторного блокування сесії, не включаючи першу спробу. За замовчуванням - 5
memcached.sess_lock_wait_maxint
Максимальний час очікування у мілісекундах між спробами блокування сесії. За замовчуванням - 150
memcached.sess_lock_wait_minint
Мінімальний час очікування у мілісекундах між спробами блокування сесії. Це значення подвоюється при кожній спробі блокування, доки не буде досягнуто значення, задане директивою memcached.sess_lock_wait_max, чергові спроби займатимуть час досягнутого значення. За замовчуванням - 150
memcached.sess_persistentbool
Чи слід повторно використовувати з'єднання memcached, що відповідають значенню (значенням) директиви session.save_path після завершення виконання сценарію. Цю директиву не використовують, якщо певні налаштування (наприклад, SASL, sess_binary_protocol) будуть перевизначені між запитами. За замовчуванням - Off
memcached.sess_remove_failed_serversbool
Дозволити автоматичне видалення сервера, що відмовив, memcached. За замовчуванням - Off
Зауваження: У попередніх версіях ця директива називалася
memcached.sess_remove_failed
memcached.sess_server_failure_limitint
Встановлення більшого, ніж встановлене за умовчанням, значення дозволить видалення сервера після заданої кількості безперервних збоїв підключення. За замовчуванням -
memcached.sess_sasl_passwordstring
Пароль сесії SASL. Для включення SASL необхідно вказати ім'я користувача та пароль.
memcached.sess_sasl_usernamestring
Ім'я користувача SASL. Для включення SASL необхідно вказати ім'я користувача та пароль.
memcached.store_retry_countint
Кількість повторних спроб невдалих команд збереження. Цей механізм прозоро перемикає на вторинні сервери при збої операцій set/increment/decrement/setMulti на бажаному сервері серед безлічі серверів. За замовчуванням -