簡介：

memcached是一個高性能的、分布式內存對象緩存系統。通常被用于降低數據庫教程加載壓力以提高動態web應用的響應速度。

此擴展使用了libmemcached庫提供的api與memcached服務端進行交互。它同樣提供了一個session處理器（memcached）。 它同時提供了一個session處理器

關于libmemcached的更多信息可以在http://libmemcached.org/libmemcached.html查看。

memcache 需求：

這個擴展需要libmemcached客戶端庫。

memcache 安裝：

安裝此 pecl 擴展相關的信息可在手冊中標題為 pecl 擴展的安裝 章節中找到。另外的信息，如新的發行版本、下載、源文件、 additional information such as new releases,維護人員信息及變更日志等，都在此處：http://pecl.php教程.net/package/memcached.

如果libmemcached被安裝在一個非標準路徑，使用--with-libmemcached-dir=dir 來指定路徑，dir就是libmemcached安裝時的prefix參數。這個路徑需要包含文件include/libmemcached/memcached.h。

如果要支持壓縮就需要zlib。對于非標準安裝的zlib庫，使用--with-zlib-dir=dir 來指定zlib安裝路徑，dir就是zib安裝時的prefix參數。

session處理器的支持默認是開啟的。如果要關閉它，使用選項--disable-memcached-session 。

預定義常量：

下列常量由此擴展定義，且僅在此擴展編譯入 php 或在運行時動態載入時可用。

memcached::opt_compression
開啟或關閉壓縮功能。當開啟的時候，item的值超過某個閾值（當前是100bytes）時，會首先對值進行壓縮然后存儲，并 在獲取該值時進行解壓縮然后返回，使得壓縮對應用層透明。

類型: boolean, 默認: true.

memcached::opt_serializer
指定對于非標量值進行序列化的序列化工具。可用的值有memcached::serializer_php 和memcached::serializer_igbinary。后者僅在memcached配置時開啟 --enable-memcached-igbinary選項并且 igbinary擴展被加載時才有效。

類型: integer, 默認: memcached::serializer_php.

memcached::serializer_php
默認的php序列化工具（即serialize方法）。

memcached::serializer_igbinary
» igbinary序列化工具。它將php的數據結構 存儲為緊密的二進制形式，在時間和空間上都有所改進。

memcached::serializer_json
json序列化，需要 php 5.2.10以上。

memcached::opt_prefix_key
可以用于為key創建“域”。這個值將會被作為每個key的前綴，它不能長于128個字符， 并且將會縮短最大可允許的key的長度。這個前綴僅僅用于被存儲的元素的key，而不會用于服務器key。

類型: string, 默認: "".

memcached::opt_hash
指定存儲元素key使用的hash算法。可用的值是memcached::hash_*系列的常量。 每種hash算法都有它的優勢和劣勢，在你不了解或不確定哪種算法對你更有利時，請使用默認值。

類型: integer, 默認: memcached::hash_default

memcached::hash_default
默認的(jenkins one-at-a-time)元素key hash算法

memcached::hash_md5
md5元素key hash算法。

memcached::hash_crc
crc元素key hash算法。

memcached::hash_fnv1_64
fnv1_64元素key hash算法。

memcached::hash_fnv1a_64
fnv1_64a元素key hash算法。

memcached::hash_fnv1_32
fnv1_32元素key hash算法。

memcached::hash_fnv1a_32
fnv1_32a元素key hash算法。

memcached::hash_hsieh
hsieh元素key hash算法。

memcached::hash_murmur
murmur元素key hash算法。

memcached::opt_distribution
指定元素key分布到各個服務器的方法。當前支持的方法有余數分步法合一致性hash算法兩種。一致性hash算法提供 了更好的分配策略并且在添加服務器到集群時可以最小化緩存丟失。

類型: integer, 默認: memcached::distribution_modula.

memcached::distribution_modula
余數分布算法。

memcached::distribution_consistent
一致性分布算法(基于libketama).

memcached::opt_libketama_compatible
開啟或關閉兼容的libketama類行為。當開啟此選項后，元素key的hash算法將會被設置為md5并且分布算法將會 采用帶有權重的一致性hash分布。這一點非常有用因為其他基于libketama的客戶端（比如python，urby）在同樣 的服務端配置下可以透明的訪問key。

note:

如果你要使用一致性hash算法強烈建議開啟此選項，并且這個選項可能在未來的發布版中被設置為默認開啟。

類型: boolean, 默認: false.

memcached::opt_buffer_writes
開啟或關閉i/o緩存。開啟i/o緩存會導致存儲命令不實際發送而是存儲到緩沖區中。任意的檢索數據操作都會導致 緩存中的數據被發送到遠程服務端。退出連接或關閉連接也會導致緩存數據被發送到遠程服務端。

類型: boolean, 默認: false.

memcached::opt_binary_protocol
開啟使用二進制協議。請注意這個選項不能在一個打開的連接上進行切換。

類型: boolean, 默認: false.

memcached::opt_no_block
開啟或關閉異步i/o。這將使得存儲函數傳輸速度最大化。

類型: boolean, 默認: false.

memcached::opt_tcp_nodelay
開啟或關閉已連接socket的無延遲特性（在某些幻境可能會帶來速度上的提升）。

類型: boolean, 默認: false.

memcached::opt_socket_send_size
socket發送緩沖的最大值。

類型: integer, 默認: 根據不同的平臺/內核配置不同

memcached::opt_socket_recv_size
socket接收緩沖的最大值。

類型: integer, 默認: 根據不同的平臺/內核配置不同

memcached::opt_connect_timeout
在非阻塞模式下這里設置的值就是socket連接的超時時間，單位是毫秒。

類型: integer, 默認: 1000.

memcached::opt_retry_timeout
等待失敗的連接重試的時間，單位秒。

類型: integer, 默認: 0.

memcached::opt_send_timeout
socket發送超時時間，單位毫秒。在這種情況下您不能使用非阻塞i/o，這將使得您仍然有數據會發送超時。

類型: integer, 默認: 0.

memcached::opt_recv_timeout
socket讀取超時時間，單位毫秒。在這種情況下您不能使用非阻塞i/o，這將使得您仍然有數據會讀取超時。

類型: integer, 默認: 0.

memcached::opt_poll_timeout
poll連接超時時間，單位毫秒。

類型: integer, 默認: 1000.

memcached::opt_cache_lookups教程
開啟或禁用dns查找緩存。

類型: boolean, 默認: false.

memcached::opt_server_failure_limit
指定一個服務器連接的失敗重試次數限制。在達到此數量的失敗重連后此服務器將被從服務器池中移除。

類型: integer, 默認: 0.

memcached::have_igbinary
指示是否支持igbinary的序列化。

類型: boolean.

memcached::have_json
指示是否支持json的序列化。

類型: boolean.

memcached::get_preserve_order
一個用于memcached::getmulti()和 memcached::getmultibykey()的標記用以確保返回的key和請求的key順序保持一致。 不存在的key將會得到一個null值。

memcached::res_success
操作成功。

memcached::res_failure
某種方式的操作失敗。

memcached::res_host_lookup_failure
dns查找失敗。

memcached::res_unknown_read_failure
讀取網絡數據失敗。

memcached::res_protocol_error
錯誤的memcached協議命令。

memcached::res_client_error
客戶端錯誤。

memcached::res_server_error
服務端錯誤。

memcached::res_write_failure
向網絡寫數據失敗。

memcached::res_data_exists
比較并交換值操作失敗（cas方法）：嘗試向服務端存儲數據時由于自此連接最后一次取此key對應數據之后被改變導致失敗。

memcached::res_notstored
元素沒有被存儲，但并不是因為一個錯誤。這通常表明add（元素已存在）或replace（元素不存在）方式存儲數據失敗或者元素已經在一個刪除序列中（延時刪除）。

memcached::res_notfound
元素未找到（通過get或cas操作時）。

memcached::res_partial_read
局部網絡數據讀錯誤。

memcached::res_some_errors
在多key獲取的時候發生錯誤。

memcached::res_no_servers
服務器池空。

memcached::res_end
結果集到結尾了。

memcached::res_errno
系統錯誤。

memcached::res_buffered
操作被緩存。

memcached::res_timeout
操作超時。

memcached::res_bad_key_provided
提供了無效的key。

memcached::res_connection_socket_create_failure
創建網絡socket失敗。

memcached::res_payload_failure
不能壓縮/解壓縮或序列化/反序列化值。