如何正確配置 Nginx + PHP

導語:對很多人而言,配置Nginx+PHP無外乎就是搜索一篇教程,然後拷貝粘貼。聽上去似乎也沒什麼問題,可惜實際上網絡上很多資料本身年久失修,漏洞百出,如果大家不求甚解,一味的拷貝粘貼,早晚有一天會爲此付出代價。那麼如何正確配置 Nginx + PHP呢?一起來學習下吧:

如何正確配置 Nginx + PHP

假設我們用PHP實現了一個前端控制器,或者直白點說就是統一入口:把PHP請求都發送到同一個文件上,然後在此文件裏通過解析「REQUEST_URI」實現路由。

  一般這樣配置

此時很多教程會教大家這樣配置Nginx+PHP:

server {

listen 80;

server_name ;

root /path;

location / {

index ;

if (!-e $request_filename) {

rewrite . / last;

}

}

location ~ /$ {

include fastcgi_params;

fastcgi_param SCRIPT_FILENAME /path$fastcgi_script_name;

fastcgi_pass ;

fastcgi_index ;

}

}

這裏面有很多錯誤,或者說至少是壞味道的地方,大家看看能發現幾個。

我們有必要先了解一下Nginx配置文件裏指令的繼承關係:

Nginx配置文件分爲好多塊,常見的從外到內依次是「http」、「server」、「location」等等,缺省的繼承關係是從外到內,也就是說內層塊會自動獲取外層塊的值作爲缺省值。

 讓我們先從「index」指令入手吧

在問題配置中它是在「location」中定義的:

location / {

index ;

}

一旦未來需要加入新的「location」,必然會出現重複定義的「index」指令,這是因爲多個「location」是平級的關係,不存在繼承,此時應該在「server」裏定義「index」,藉助繼承關係,「index」指令在所有的「location」中都能生效。

接下來看看「if」指令

說它是大家誤解最深的Nginx指令毫不爲過:

if (!-e $request_filename) {

rewrite . / last;

}

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

try_files $uri $uri/ /;

除此以外,初學者往往會認爲「if」指令是內核級的指令,但是實際上它是rewrite模塊的一部分,加上Nginx配置實際上是聲明式的,而非過程式的,所以當其和非rewrite模塊的指令混用時,結果可能會非你所願。

  下面看看「fastcgi_params」配置文件

include fastcgi_params;

Nginx有兩份fastcgi配置文件,分別是「fastcgi_params」和「」,它們沒有太大的差異,唯一的區別是後者比前者多了一行「SCRIPT_FILENAME」的定義:

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

注意:$document_root 和 $fastcgi_script_name 之間沒有 /。

原本Nginx只有「fastcgi_params」,後來發現很多人在定義「SCRIPT_FILENAME」時使用了硬編碼的方式,於是爲了規範用法便引入了「」。

不過這樣的話就產生一個疑問:爲什麼一定要引入一個新的配置文件,而不是修改舊的配置文件?這是因爲「fastcgi_param」指令是數組型的,和普通指令相同的是:內層替換外層;和普通指令不同的是:當在同級多次使用的時候,是新增而不是替換。換句話說,如果在同級定義兩次「SCRIPT_FILENAME」,那麼它們都會被髮送到後端,這可能會導致一些潛在的問題,爲了避免此類情況,便引入了一個新的配置文件。

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

try_files $uri =404;

改良後的版本

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

server {

listen 80;

server_name ;

root /path;

index ;

location / {

try_files $uri $uri/ /$is_args$args;

}

location ~ /$ {

try_files $uri =404;

include ;

fastcgi_pass ;

}

}