nginx File not found 錯誤

使用php-fpm解析PHP，"No input file specified"，"File not found"是令nginx新手頭疼的常見錯誤，原因是php-fpm進程找不到SCRIPT_FILENAME配置的要執行的.php文件，php-fpm返回給nginx的默認404錯誤提示。

比如我的網站doucument_root下沒有test.php，訪問這個文件時通過抓包可以看到返回的內容。

HTTP/1.1 404 Not Found
Date: Fri, 21 Dec 2012 08:15:28 GMT
Content-Type: text/html
Proxy-Connection: close
Server: nginx/1.2.5
X-Powered-By: PHP/5.4.7
Via: 1.1 c3300 (NetCache NetApp/6.0.7)
Content-Length: 16

File not found.

 

很多人不想用戶直接看到這個默認的404錯誤信息，想自定義404錯誤.

給出解決辦法前我們來先分析下如何避免出現這類404錯誤，然後再說真的遇到這種情況(比如用戶輸入一個錯誤不存在的路徑)時該怎麼辦，才能顯示自定義的404錯誤頁。

一、錯誤的路徑被髮送到php-fpm進程

出現這類錯誤，十個有九個是後端fastcgi進程收到錯誤路徑(SCRIPT_FILENAME)，而後端fastcgi收到錯誤路徑的原因大都是配置錯誤。

常見的nginx.conf的配置如下：

 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

server {     listen   [::]:80;     server_name  example.com www.example.com;     access_log  /var/www/logs/example.com.access.log;         location / {         root   /var/www/example.com;         index  index.html index.htm index.pl;     }       location /images {         autoindex on;     }       location ~ .php$ {         fastcgi_pass   127.0.0.1:9000;         fastcgi_index  index.php;         fastcgi_param  SCRIPT_FILENAME  /var/www/example.com$fastcgi_script_name;         include fastcgi_params;     } }

這個配置中有很多不合理的地方，其中一個明顯的問題就是root指令被放到了location / 塊。如果root指令被定義在location塊中那麼該root指令只能對其所在的location生效。其它locaiont中沒有root指令，像location /images塊不會匹配任何請求，需要在每個請求中重複配置root指令來解決這個問題。因此我們需要把root指令放在server塊，這樣各個location就會繼承父server塊定義的$document_root，如果某個location需要定義一個不同的$document_root，則可以在location單獨定義一個root指令。

另一個問題就是fastCGI參數SCRIPT_FILENAME 是寫死的。如果修改了root指令的值或者移動文件到別的目錄，php-fpm會返回“No input file specified”錯誤，因爲SCRIPT_FILENAME在配置中是寫死的並沒有隨着$doucument_root變化而變化，我們可以修改SCRIPT_FILENAME配置如下：

fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;

 

所以我們不能忘記在server塊中配置root指令，不然$document_root的值爲空，只會傳$fastcgi_script_name到php-fpm，這樣就會導致“No input file specified”錯誤。

 

二、請求的文件真的不存在

當nginx收到一個不在的.php文件的請求時,因爲nginx只會檢查$uri是否是.php結尾，不會對文件是否存在進行判斷，.php結尾的請求nginx會直接發給php-fpm處理。php-fpm處理時找不到文件就會返回“No input file specified”帶着“404 Not Found”頭。

解決辦法

我們在nginx攔截不存在的文件，請求並返回自定義404錯誤

使用 try_files 捕捉不存在的urls並返回錯誤。

1 2 3 4 5 6 7 8

location ~ .php$ { try_files $uri =404; fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME .... ................................... ................................... }

上面的配置會檢查.php文件是否存在，如果不存在，會返回404頁面。