nginx js、css多个请求合并为一个请求(concat模块)

模块介绍

mod_concat模块由淘宝开发，目前已经包含在tengine中，并且淘宝已经在使用这个nginx模块。不过塔暂时没有包含在nginx中。这个模块类似于apache中的modconcat。如果需要使用它，需要使用两个”?”问号.

来个范例：

http://example.com/??style1.css,style2.css,foo/style3.css

以上将原先3个请求合并为1个请求

如果你担心文件被用户的浏览器缓存而没有及时更新，你依旧可以带上一个版本号的参数，如下：

http://example.com/??style1.css,style2.css,foo/style3.css?v=102234

1. 安装nginx concat

# cd /usr/local/src/

# wget http://nginx.org/download/nginx-1.4.2.tar.gz

# wget https://github.com/alibaba/nginx-http-concat/archive/master.zip -O nginx-http-concat-master.zip

# unzip nginx-http-concat-master.zip

# tar -xzvf nginx-1.4.2.tar.gz

# cd nginx-1.4.2

# ./configure --prefix=/usr/local/nginx-1.4.2 --with-http_stub_status_module　

--add-module=../nginx-http-concat-master

# make

# make install

2. 指令directives

concat on | off
default: concat off
context: http, server, location
开启火关闭concat

concat_types MIME types
default: concat_types: text/css application/x-javascript
context: http, server, location
Defines the MIME types which can be concatenated in a given context.
在给定的配置段中可以被合并的MIME文件类型.

concat_unique on | off
default: concat_unique on
context: http, server, location
是否只允许同类型文件（相同MIME文件）合并。例如，设置为off，那么js和css文件可以合并。默认情况下，这个值是on，意味着只有相同的类型文件才能合并。

如果希望js和css能够合并为一个请求，那么你必须设置concat_unique off，其他类型文件也可以用同样的方式合并.如下为OFF才可以的请求：

http://example.com/static/??foo.css,bar/foobaz.js

concat_max_files numberp
default: concat_max_files 10
context: http, server, location
定义一个给定的配置段里面允许合并文件的数量，默认最多10个.不过一定要注意，uri不要超过系统的规定的page size，在linux里面执行getconf PAGESIZE可以获取系统的限制.通常限制是4096字节。

concat_delimiter: string
default: NONE
context: http, server, locatione
定义文件分隔符

concat_ignore_file_error: on | off
default: off
context: http, server, location
是否忽略文件请求错误，例如404和403等

3. 配置nginx

server {

    listen       80;

    server_name  www.ttlsa.com;

    root /data/site/www.ttlsa.com;

    location /static/ {

        concat on;

        concat_max_files 20;

        concat_unique off;

    }

}

4. 测试nginx concat

我的站点有调用到static/ttlsa_concat.css和static/ttlsa_concat.js两个文件，为了提高站点访问速度，我决定使用nginx的concat模块将两个请求合并为一个。
合并前
www.ttlsa.com/static/css/ttsa_concat.css
www.ttlsa.com/static/js/ttsa_concat.js

合并后

http://www.ttlsa.com/static??js/ttlsa_concat.js,css/ttlsa_concat.css?ver=123

测试之前，准备一下文件.

# cd /data/site/www.ttlsa.com/static

# cat js/ttlsa_concat.js  

// this is js file ttlsa_concat.js

# cat js/a.js             

// this is js file a.js

# cat css/a.css

/** this is css a.css **/

# cat css/ttlsa_concat.css

/** this is css ttlsa_concat.css **/

4.1 两个css合并

# curl http://www.ttlsa.com/static/??css/ttlsa_concat.css,css/a.css

/** this is css ttlsa_concat.css **/

/** this is css a.css *

4.2 两个js合并

# curl http://www.ttlsa.com/static/??js/ttlsa_concat.js,js/a.js  

// this is js file ttlsa_concat.js

// this is js file a.js

4.3 js与css合并

# curl http://www.ttlsa.com/static/??js/ttlsa_concat.js,css/ttlsa_concat.css

// this is js file ttlsa_concat.js

/** this is css ttlsa_concat.css **/

4.4 带版本号参数

# curl http://www.ttlsa.com/static/??css/ttlsa_concat.css,css/a.css?123

/** this is css ttlsa_concat.css **/

/** this is css a.css *

以上仅仅用了两个文件来测试，在具体应用中，大家可以使用多个，具体几个由你的nginx配置来控制. 在具体的环境中，都是以下方式来调用，以下方法摘自官方文档.
js：

<script src="??bar1.js,bar22.css,subdir/bar3.js?v=3245" />

以上意思是将ba1.Js，bar22.css和subdir/bar3.js这三个请求合并为一个，并且版本号为3245.

css:

<link rel="stylesheet" href="??foo1.css,foo2.css,subdir/foo3.css?v=2345" />

这边也是一个道理,只不过只包含css.

5. 结束语

减少web请求在一定程度上能减少web服务器的压力，简单的使用nginx concat模块便可以实现这个功能，不过需要前端设计师来使用。如果想减少web请求，又不想让前端设计师来插手的话，大家可以参考下google出的pagespeed模块

6. 参考文章

官方：http://wiki.nginx.org/HttpConcatModule