快捷導(dǎo)航

常見的Nginx配置誤區(qū)

更新時間：2014年03月05日 17:35:32 作者：

對很多人而言，配置Nginx+PHP無外乎就是搜索一篇教程，然后拷貝粘貼。聽上去似乎也沒什么問題，可惜實際上網(wǎng)絡(luò)上很多資料本身年久失修，漏洞百出，如果大家不求甚解，一味的拷貝粘貼，早晚有一天會為此付出代價

假設(shè)我們用PHP實現(xiàn)了一個前端控制器，或者直白點說就是統(tǒng)一入口：把PHP請求都發(fā)送到同一個文件上，然后在此文件里通過解析「REQUEST_URI」實現(xiàn)路由。
此時很多教程會教大家這樣配置Nginx+PHP：

復(fù)制代碼代碼如下:

server {
    listen 80;
    server_name foo.com;

    root /path;

    location / {
        index index.html index.htm index.php;

        if (!-e $request_filename) {
            rewrite . /index.php last;
        }
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME /path$fastcgi_script_name;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
    }
}

這里面有很多錯誤，或者說至少是壞味道的地方，大家看看能發(fā)現(xiàn)幾個。

我們有必要先了解一下Nginx配置文件里指令的繼承關(guān)系：Nginx配置文件分為好多塊，常見的從外到內(nèi)依次是「http」、「server」、「location」等等，缺省的繼承關(guān)系是從外到內(nèi)，也就是說內(nèi)層塊會自動獲取外層塊的值作為缺省值（有例外，詳見參考）。

參考：UNDERSTANDING THE NGINX CONFIGURATION INHERITANCE MODEL

讓我們先從「index」指令入手吧，在問題配置中它是在「location」中定義的：

復(fù)制代碼代碼如下:

location / {
    index index.html index.htm index.php;
}

一旦未來需要加入新的「location」，必然會出現(xiàn)重復(fù)定義的「index」指令，這是因為多個「location」是平級的關(guān)系，不存在繼承，此時應(yīng)該在「server」里定義「index」，借助繼承關(guān)系，「index」指令在所有的「location」中都能生效。

參考：Nginx Pitfalls

接下來看看「if」指令，說它是大家誤解最深的Nginx指令毫不為過：

復(fù)制代碼代碼如下:

if (!-e $request_filename) {
    rewrite . /index.php last;
}

很多人喜歡用「if」指令做一系列的檢查，不過這實際上是「try_files」指令的職責：

復(fù)制代碼代碼如下:

try_files $uri $uri/ /index.php;

除此以外，初學者往往會認為「if」指令是內(nèi)核級的指令，但是實際上它是rewrite模塊的一部分，加上Nginx配置實際上是聲明式的，而非過程式的，所以當其和非rewrite模塊的指令混用時，結(jié)果可能會非你所愿。
參考：IfIsEvil and How nginx “l(fā)ocation if” works

下面看看「fastcgi_params」配置文件：

復(fù)制代碼代碼如下:

include fastcgi_params;

Nginx有兩份fastcgi配置文件，分別是「fastcgi_params」和「fastcgi.conf」，它們沒有太大的差異，唯一的區(qū)別是后者比前者多了一行「SCRIPT_FILENAME」的定義：

復(fù)制代碼代碼如下:

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

注意：$document_root 和 $fastcgi_script_name 之間沒有 /。
原本Nginx只有「fastcgi_params」，后來發(fā)現(xiàn)很多人在定義「SCRIPT_FILENAME」時使用了硬編碼的方式，于是為了規(guī)范用法便引入了「fastcgi.conf」。
不過這樣的話就產(chǎn)生一個疑問：為什么一定要引入一個新的配置文件，而不是修改舊的配置文件？這是因為「fastcgi_param」指令是數(shù)組型的，和普通指令相同的是：內(nèi)層替換外層；和普通指令不同的是：當在同級多次使用的時候，是新增而不是替換。換句話說，如果在同級定義兩次「SCRIPT_FILENAME」，那么它們都會被發(fā)送到后端，這可能會導(dǎo)致一些潛在的問題，為了避免此類情況，便引入了一個新的配置文件。
參考：FASTCGI_PARAMS VERSUS FASTCGI.CONF – NGINX CONFIG HISTORY

此外，我們還需要考慮一個安全問題：在PHP開啟「cgi.fix_pathinfo」的情況下，PHP可能會把錯誤的文件類型當作PHP文件來解析。如果Nginx和PHP安裝在同一臺服務(wù)器上的話，那么最簡單的解決方法是用「try_files」指令做一次過濾：

復(fù)制代碼代碼如下:

try_files $uri =404;

參考：Nginx文件類型錯誤解析漏洞

依照前面的分析，給出一份改良后的版本，是不是比開始的版本清爽了很多：

復(fù)制代碼代碼如下:

server {
    listen 80;
    server_name foo.com;

    root /path;
    index index.html index.htm index.php;

    location / {
        try_files $uri $uri/ /index.php;
    }

    location ~ \.php$ {
        try_files $uri =404;

        include fastcgi.conf;
        fastcgi_pass 127.0.0.1:9000;
    }
}