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

在给定的配置段中可以被合并的MIME文件类型

concat concat_types MIME types
default: concat_types: text/css application/x-javascript
context: http, server, location

是否只允许同类型文件（相同MIME文件）合并

concat_unique on | off
default: concat_unique on
context: http, server, location

例如，设置为off，那么js和css文件可以合并。默认情况下，这个值是on，意味着只有相同的类型文件才能合并。 如果希望js和css能够合并为一个请求，那么你必须设置 concat_unique off，其他类型文件也可以用同样的方式合并. 如下为OFF才可以的请求： http://example.com/static/??foo.css,bar/foobaz.js

定义一个给定的配置段里面允许合并文件的数量，默认最多10个

concat_max_files numberp
default: concat_max_files 10
context: http, server, location 

不过一定要注意，uri不要超过系统的规定的page size，在linux里面执行getconf PAGESIZE可以获取系统的限制.通常限制是4096字节。

定义文件分隔符

concat_delimiter: string
default: NONE
context: http, server, location

是否忽略文件请求错误，例如404和403等

concat_ignore_file_error: on | off
default: off
context: http, server, location 

3. 配置 nginx

server {
    listen       80;
    server_name  www.fbzl.org;

    root /data/site/www.fbzl.org;
    location /static/ {
        concat on;
        concat_max_files 20;
        concat_unique off;
    }
}

4. 测试 nginx concat

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

合并前

www.fbzl.org/static/css/concat.css www.fbzl.org/static/js/concat.js

合并后

http://www.fbzl.org/js/concat.js,css/concat.css?ver=123

测试之前，准备一下文件

cd /data/site/www.fbzl.org/static
cat js/concat.js
cat js/a.js
cat css/a.css
cat css/concat.css

4.1 两个css合并

curl http://www.fbzl.org/static/??css/concat.css,css/a.css

4.2 两个js合并

curl http://www.fbzl.org/static/??js/concat.js,js/a.js

4.3 js与css合并

curl http://www.fbzl.org/static/??js/concat.js,css/concat.css

4.4 带版本号参数

curl http://www.fbzl.org/static/??css/concat.css,css/a.css?v=123

以上仅仅用了两个文件来测试，在具体应用中，大家可以使用多个，具体几个由你的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