标签：
The following set of modules provides functionalities having an effect on the contents served to the client, either by modifying the way the response is encoded, by affecting the headers, or by generating a response from scratch.
The purpose of this module is to provide a directive that serves a 1 x 1 transparent GIF image from the memory. Such files are sometimes used by web designers to tweak the appearance of their website. With this directive, you get an empty GIF straight from the memory instead of reading and processing an actual GIF file from the storage space.
To utilize this feature, simply insert the empty_gif directive in the location of your choice:
location = /empty.gif {
empty_gif;
}
FLV and MP4 are separate modules enabling a simple functionality that becomes useful when serving Flash (FLV) or MP4 video files. It parses a special argument of the request, start, which indicates the offset of the section the client wishes to download or pseudo-stream. The video file must thus be accessed with the following URI: video.flv?start=XXX. This parameter is prepared automatically by mainstream video players such as JWPlayer.
This module is not included in the default Nginx build.
To utilize this feature, simply insert the flv or mp4 directive in the location of your choice:
location ~* \.flv {
flv;
}
location ~* \.mp4 {
mp4;
}
Be aware that in case Nginx fails to seek to the requested position within the video file, the request will result in a 500 Internal Server Error HTTP response. JWPlayer sometimes misinterprets this error and simply displays a "Video not found" error message.
Two directives are introduced by this module that will affect the header of the response sent to the client.
First, add_header Name value lets you add a new line in the response headers, respecting the following syntax: Name: value. The line is added only for responses of the following code: 200, 201, 204, 301, 302, and 304. You may insert variables in the value argument.
Additionally, the expires directive allows you to control the value of the Expires and Cache-Control HTTP header sent to the client, affecting requests of the same code, as listed above. It accepts a single value among the following:
The Addition module allows you (through simple directives) to add content before or after the body of the HTTP response.
The two main directives are:
add_before_body file_uri;
add_after_body file_uri;
As stated previously, Nginx triggers a sub-request for fetching the specified URI. Additionally, you can define the type of files to which the content is appended in case your location block pattern is not specific enough (default: text/html):
addition_types mime_type1 [mime_type2…];
addition_types *;
Along the lines of the previous module, the Substitution module allows you to search and replace text directly from the response body:
sub_filter searched_text replacement_text;
This module is not included in the default Nginx build.
Two additional directives provide more flexibility:
This module allows you to compress the response body with the Gzip algorithm before sending it to the client. To enable Gzip compression, use the gzip directive (on or off) at the http, server, location, and even the if level (though that is not recommended). The following directives will help you further configure the filter options:
Context: http, server, location
Defines the amount and size of buffers to be used for storing the compressed response.
Syntax: gzip_buffers amount size;
Default: gzip_buffers 4 4k (or 8 k depending on the OS).
Context: http, server, location
Defines the compression level of the algorithm. The specified value ranges from 1 (low compression, faster for the CPU) to 9 (high compression, slower).
Syntax: Numeric value.
Default: 1
Context: http, server, location
Disables Gzip compression for requests where the User-Agent HTTP header matches the specified regular expression.
Syntax: Regular expression
Default: None
Context: http, server, location
Enables Gzip compression for the specified protocol version.
Syntax: 1.0 or 1.1
Default: 1.1
Context: http, server, location
If the response body length is inferior to the specified value, it is not compressed.
Syntax: Numeric value (size)
Default: 0
Context: http, server, location
Enables or disables Gzip compression for the body of responses received from a proxy.
The directive accepts the following parameters; some can be combined:
Context: http, server, location
Enables compression for types other than the default text/html MIME type.
Syntax:
gzip_types mime_type1 [mime_type2…];
gzip_types *;
Default: text/html (cannot be disabled)
Context: http, server, location
Adds the Vary: Accept-Encoding HTTP header to the response.
Syntax: on or off
Default: off
Context: http, server, location
Sets the size of the window buffer (windowBits argument) for Gzipping operations. This directive value is used for calls to
functions from the Zlib library.
Syntax: Numeric value (size)
Default: MAX_WBITS constant from the Zlib library
Context: http, server, location
Sets the amount of memory that should be allocated for the internal compression state (memLevel argument). This directive
value is used for calls to functions from the Zlib library.
Syntax: Numeric value (size)
Default: MAX_MEM_LEVEL constant from the Zlib prerequisite library
Context: http, server, location
Defines a minimum data threshold to be reached before starting the Gzip compression.
Syntax: Size (numeric value)
Default: 0
Context: http, server, location
By default, Nginx waits until at least one buffer (defined by gzip_buffers) is filled with data before sending the response to the client. Enabling this directive disables buffering.
Syntax: on or off
Default: off
This module adds a simple functionality to the Gzip filter mechanism — when its gzip_static directive (on or off) is enabled, Nginx will automatically look for a .gz file corresponding to the requested document before serving it. This allows Nginx to send pre-compressed documents instead of compressing documents on-the-fly at each request.
This module is not included in the default Nginx build.
If a client requests /documents/page.html, Nginx checks for the existence of a /documents/page.html.gz file. If the .gz file is found, it is served to the client. Note that Nginx does not generate .gz files itself, even after serving the requested files.
With the Charset Filter module, you can control the character set of the response body more accurately. Not only are you able to specify the value of the charset argument of the Content-Type HTTP header (such as Content-Type: text/html; charset=utf-8), but Nginx can also re-encode data to a specified encoding method automatically.
Context: http, server, location, if
This directive adds the specified encoding to the Content-Type header of the response. If the specified encoding differs from the source_charset one, Nginx re-encodes the document.
Syntax: charset encoding | off;
Default: off
Example: charset utf-8;
Context: http, server, location, if
Defines the initial encoding of the response; if the value specified in the charset directive differs, Nginx re-encodes the document.
Syntax: source_charset encoding;
Context: http, server, location, if
When Nginx receives a response from the proxy or FastCGI gateway, this directive defines whether or not the character encoding should be checked and potentially overridden.
Syntax: on or off
Default: off
Context: http, server, location
Defines the MIME types that are eligible for re-encoding.
Syntax:
charset_types mime_type1 [mime_type2…];
charset_types * ;
Default: text/html, text/xml, text/plain, text/vnd.wap.wml, application/x-javascript, application/rss+xml
Context: http
Lets you define character re-encoding tables. Each line of the table contains two hexadecimal codes to be exchanged. You will find reencoding tables for the koi8-r character set in the default Nginx configuration folder (koi-win and koi-utf).
Syntax: charset_map src_encoding dest_encoding { … }
Memcached is a daemon application that can be connected to via sockets. Its main purpose, as the name suggests, is to provide an efficient distributed key/value memory caching system. The Nginx Memcached module provides directives allowing you to configure access to the Memcached daemon.
Context: location, if
Defines the hostname and port of the Memcached daemon.
Syntax: memcached_pass hostname:port;
Example: memcached_pass localhost:11211;
Context: http, server, location
Forces Nginx to use the specified local IP address for connecting to the Memcached server. This can come in handy if your server has multiple network cards connected to different networks.
Syntax: memcached_bind IP_address;
Example: memcached_bind 192.168.1.2;
Context: http, server, location
Defines the connection timeout in milliseconds (default: 60,000).
Example: memcached_connect_timeout 5000;
Context: http, server, location
Defines the data writing operations timeout in milliseconds (default: 60,000).
Example: memcached_send_timeout 5,000;
Context: http, server, location
Defines the data reading operations timeout in milliseconds (default: 60,000).
Example: memcached_read_timeout 5,000;
Context: http, server, location
Defines the size of the read and write buffer, in bytes (default: page size).
Example: memcached_buffer_size 8k;
Context: http, server, location
When the memcached_pass directive is connected to an upstream block, this directive defines the conditions that should be matched in order to skip to the next upstream server.
Syntax: Values selected among error timeout, invalid_response, not_found, or off
Default: error timeout
Example: memcached_next_upstream off;
Additionally, you will need to define the $memcached_key variable that defines the key of the element that you are placing or fetching from the cache. You may, for instance, use set $memcached_key $uri or set $memcached_key $uri?$args.
Note that the Nginx Memcached module is only able to retrieve data from the cache; it does not store the result of requests. Storing data in the cache should be done by a server-side script. You just need to make sure to employ the same key naming scheme in both your server-side scripts and the Nginx configuration. As an example, we could decide to use memcached to retrieve data from the cache before passing the request to a proxy, if the requested URI is not found:
server {
server_name example.com;
[…]
location / {
set $memcached_key $uri;
memcached_pass 127.0.0.1:11211;
error_page 404 @notcached;
}
location @notcached {
internal;
# if the file is not found, forward request to proxy
proxy_pass 127.0.0.1:8080;
}
}
This module provides image processing functionalities through the GD Graphics Library (also known as gdlib).
This module is not included in the default Nginx build.
Make sure to employ the following directives on a location block that filters image files only, such as location ~* \.(png|jpg|gif)$ { … }.
Context: location
Lets you apply a transformation on the image before sending it to the client. There are five options available:
Example: image_filter resize 200 100;
Context: http, server, location
Defines the maximum file size for images to be processed.
Default: image_filter_buffer 1m;
Context: http, server, location
Defines the quality of output JPEG images.
Default: image_filter_jpeg_quality 75;
Context: http, server, location
By default, PNG and GIF images keep their existing transparency during operations you perform using the Image Filter module. If you set this directive to off, all existing transparency will be lost but the image quality will be improved.
Syntax: on or off
Default: on
Context: http, server, location
Sharpens the image by specified percentage (value may exceed 100).
Syntax: Numeric value
Default: 0
Please note that when it comes to JPG images, Nginx automatically strips off metadata (such as EXIF) if it occupies more than 5 percent of the total space of the file.
The Nginx XSLT module allows you to apply an XSLT transform on an XML file or response received from a backend server (proxy, FastCGI, and so on) before serving the client.
This module is not included in the default Nginx build.
Context: http, server, location
Specifies the DTD file containing symbolic element definitions.
Syntax: File path
Example: xml_entities xml/entities.dtd;
Context: location
Specifies the XSLT template file path with its parameters. Variables may be inserted in the parameters.
Syntax: xslt_stylesheet template [param1] [param2…];
Example: xslt_stylesheet xml/sch.xslt param=value;
Context: http, server, location
Defines additional MIME types to which the transforms may apply, other than text/xml.
Syntax: MIME type
Example:
xslt_types text/xml text/plain;
xslt_types *;
Context: http, server, location
Both directives allow defining parameters for XSLT stylesheets. The difference lies in the way the specified value is interpreted: using xslt_param, XPath expressions in the value are processed; while xslt_string_param should be used for plain character strings.
Syntax: xslt_param key value;
Nginx - Additional Modules, Content and Encoding
标签：
原文地址：http://www.cnblogs.com/huey/p/5770405.html
