ngx_http_fastcgi_module 的那些事

ngx_http_fastcgi_module 的那些事

問題來自於：https://segmentfault.com/q/1010000010786459

解決參考：http://www.javashuo.com/article/p-fbhebahb-cy.html

是什麼？

顧名思義，是Nginx用來處理FastCGI的模塊。FastCGI是什麼？這個之後再講，能夠說的是如今LNMP架構裏面，PHP通常是以PHP-CGI的形式在運行，它就是一種FastCGI，咱們在進程中看到的PHP-FPM是PHP-CGI的管理調度器。

爲何要詳解一下？

由於LNMP不像LAMP，且早期Nginx不支持path_info，致使網上有大量舊版本的Nginx教程干擾視線。

爲了更加清晰準確使用LNMP，估須要深刻了解一下整個ngx_http_fastcgi_module。

四個常見、重要的配置項

fastcgi_pass

做用域：location, if in location

設置FastCGI服務，其值能夠是一個域名、IP地址:端口、或者是一個Unix的Socket文件。

同時，它也只支持一個FastCGI服務集羣。

# TCP形式傳遞
fastcgi_pass localhost:9000;

# Socket形式傳遞
fastcgi_pass unix:/tmp/fastcgi.socket;

# 傳遞給集羣
upstream cloud {
    server cgi_1.cloud.com;
    server cgi_2.cloud.com;
}
fastcgi_pass cloud;

upstream集羣定義不在本次討論範圍，更多玩法請參考官方文檔。

fastcgi_param

做用域：http, server, location

設置一個傳遞給FastCGI服務的參數，能夠是文本或者是變量。

# 例如在接入層Nginx上面傳遞以下5個參數
fastcgi_param  REMOTE_ADDR        $remote_addr;
fastcgi_param  REMOTE_PORT        $remote_port;
fastcgi_param  SERVER_ADDR        $server_addr;
fastcgi_param  SERVER_PORT        $server_port;
fastcgi_param  SERVER_NAME        $server_name;

# 那麼在FastCGI上面，例如PHP-CGI上面就能夠經過$_SERVER這個超全局變量獲取。
$_SERVER['REMOTE_ADDR']
$_SERVER['REMOTE_PORT']
$_SERVER['SERVER_ADDR']
$_SERVER['SERVER_PORT']
$_SERVER['SERVER_NAME']

可傳遞的參數，遵循CGI/1.1規範定義。

能夠從Github上面看到Nginx在3年前實現FastCGI的參數傳遞後，基本就沒變過了。

fastcgi_index

做用域：http, server, location

當請求以/結尾的時候，會將請求傳遞給所設置的index.php文件處理。

fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name;

fastcgi_split_path_info

做用域：location

Nginx默認獲取不到PATH_INFO的值，得經過fastcgi_split_path_info指定定義的正則表達式來給$fastcgi_path_info賦值。

其正則表達式必需要有兩個捕獲。

• 第一個捕獲的值會從新賦值給$fastcgi_script_name變量。
• 第二個捕獲到的值會從新賦值給$fastcgi_path_info變量。

例子：

location ~ ^(.+\.php)(.*)$ {
    fastcgi_split_path_info       ^(.+\.php)(.*)$;
    fastcgi_param SCRIPT_FILENAME /path/to/php$fastcgi_script_name;
    fastcgi_param PATH_INFO       $fastcgi_path_info;
}

原始請求是 /show.php/article/0001。

經過分割，FastCGI獲得的結果是：

• SCRIPT_FILENAME: /path/to/php/show.php
• PATH_INFO: /article/0001

Nginx在0.7.31之前是沒有fastcgi_split_path_info這個指令的，而0.7.x這個版本一直存活了好多年，後面才高歌猛進，致使網上存在大量舊版本經過正則本身設置PATH_INFO的方法。

踩了好屢次依舊不記得怎麼設置的ThinkPHP

爲何老是踩坑？由於咱們都會經過重寫來隱藏index.php文件，而ThinkPHP的教程，默認教的是舊版Nginx寫法，且URL_MODE必須設置爲3也說得很隱晦（URL_MODE默認爲0）。

例如ThinkPHP的說明有一段舊版的Nginx設置指引。

location / { // …..省略部分代碼
   if (!-e $request_filename) {
   rewrite  ^(.*)$  /index.php?s=$1  last;
   break;
    }
 }

該規則是經過將請求rewrite給/index.php?s=來實現的，其ThinkPHP的URL_MODE配置必須爲3，也就是兼容模式。

若是使用本文中的傳遞PATH_INFO方式，且隱藏index.php，則ThinkPHP的URL_MODE須要改成2。

若是使用本文中的傳遞PATH_INFO方式，但不隱藏index.php，則ThinkPHP的URL_MODE改成1。

還有個一個叫 cgi.fix_pathinfo

cgi.fix_pathinfo參數，藏在PHP-FPM的php.ini配置裏面，其默認值爲1。

這裏存在一個安全風險，我也不通，詳情不表，看鳥哥的文章：http://www.laruence.com/2010/05/20/1495.html

習慣性將其設置爲0便可。

參考

• http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html
• http://wiki.nginx.org/PHPFcgiExample
• 同步發表於個人博客