ngx_http_memcached_module

• 示例配置

• 指令

• memcached_bind

• memcached_buffer_size

• memcached_connect_timeout

• memcached_force_ranges

• memcached_gzip_flag

• memcached_next_upstream

• memcached_next_upstream_timeout

• memcached_next_upstream_tries

• memcached_pass

• memcached_read_timeout

• memcached_send_timeout

• 嵌入式变量

该ngx_http_memcached_module模块用于从memcached服务器获取响应。密钥在$memcached_key变量中设置。应通过nginx之外的方式提前将响应放入memcached。

示例配置

server {
    location / {
        set            $memcached_key "$uri?$args";
        memcached_pass host:11211;
        error_page     404 502 504 = @fallback;
    }

    location @fallback {
        proxy_pass     http://backend;
    }
}

指令

句法：	memcached_bind address transparent | off;
默认：	—
语境：	http，服务器，位置

通过可选端口（1.11.2）从指定的本地IP地址发出到memcached服务器的传出连接。参数值可以包含变量（1.3.12）。特殊值off（1.3.12）取消了memcached_bind从前一个配置级别继承的指令的效果，这允许系统自动分配本地IP地址和端口。

transparent参数（1.11.0）允许分布式缓存服务器传出连接从一个非本地的IP地址发起，例如，来自客户端的实际IP地址：

memcached_bind $remote_addr transparent;

为了使此参数起作用，需要以超级用户权限运行nginx工作进程，并配置内核路由表以拦截来自memcached服务器的网络流量。

句法：	memcached_buffer_size size;
默认：	memcached_buffer_size 4k | 8k;
语境：	http，服务器，位置

设置用于读取从memcached服务器接收到的响应的缓冲区的大小。 一旦收到响应，响应便会同步传递给客户端。

句法：	memcached_connect_timeout时间;
默认：	memcached_connect_timeout 60s;
语境：	http，服务器，位置

定义与memcached服务器建立连接的超时时间。应该指出的是，这个超时通常不能超过75秒。

句法：	memcached_force_ranges开启| 关闭;
默认：	memcached_force_ranges off;
语境：	http，服务器，位置

无论这些响应中的“接受范围”字段如何，都可以对来自memcached服务器的缓存和未缓存的响应启用字节范围支持。

句法：	memcached_gzip_flag标志;
默认：	—
语境：	http，服务器，位置

启用对flagmemcached服务器响应中状态的测试，并在标志设置时将“ Content-Encoding”响应标题字段设置为“ gzip”。

句法：	memcached_next_upstream错误| 超时| invalid_response | not_found | 关闭...;
默认：	memcached_next_upstream错误超时;
语境：	http，服务器，位置

指定在哪些情况下请求应传递给下一台服务器：

error在与服务器建立连接，传递请求或读取响应头时发生错误; timeout在与服务器建立连接，传递请求或读取响应头时发生超时; invalid_response服务器返回了空的或无效的响应; not_found在服务器上未找到响应; off禁用将请求传递给下一个服务器。

人们应该记住，只有在没有任何内容发送给客户端的情况下，才能将请求传递到下一个服务器。也就是说，如果在响应传输过程中发生错误或超时，修复这是不可能的。

该指令还定义了与服务器进行通信的不成功尝试。 即使未在指令中指定错误，超时和invalid_response的情况，也总是被视为不成功尝试。 not_found的情况永远不会被视为不成功的尝试。

将请求传递给下一台服务器可能受到尝试次数和时间的限制。

句法：	memcached_next_upstream_timeout时间;
默认：	memcached_next_upstream_timeout 0;
语境：	http，服务器，位置

限制请求可以传递到下一个服务器的时间。该0值将关闭此限制。

句法：	memcached_next_upstream_tries数字;
默认：	memcached_next_upstream_tries 0;
语境：	http，服务器，位置

限制将请求传递到下一个服务器的可能尝试次数。该0值将关闭此限制。

句法：	memcached_pa​​ss地址;
默认：	—
语境：	位置，如果在位置

设置memcached服务器地址。该地址可以指定为域名或IP地址，以及端口：

memcached_pass localhost:11211;

或者作为UNIX域套接字路径：

memcached_pass unix:/tmp/memcached.socket;

如果域名解析为多个地址，则所有这些地址都将以循环方式使用。另外，地址可以被指定为服务器组。

句法：	memcached_read_timeout时间;
默认：	memcached_read_timeout 60s;
语境：	http，服务器，位置

定义从memcached服务器读取响应的超时。超时只在两次连续的读操作之间设置，而不是用于传输整个响应。如果memcached服务器在此时间内没有传输任何内容，则连接将被关闭。

句法：	memcached_send_timeout时间;
默认：	memcached_send_timeout 60s;
语境：	http，服务器，位置

设置将请求传输到memcached服务器的超时时间。超时只在两次连续写入操作之间设置，而不是用于传输整个请求。如果memcached服务器在此时间内没有收到任何内容，则连接关闭。

嵌入式变量

$memcached_key 定义从memcached服务器获取响应的键值。

	ngx_http_memcached_module