ngx_http_fastcgi_module 的那些事

ngx_http_fastcgi_module 的那些事

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

ngx_http_fastcgi_module 的那些事

解決參考:https://segmentfault.com/a/1190000002667095

是什麼?

顧名思義,是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即可。

參考

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章