ngx_http_fastcgi_module 的那些事
問題來自於:https://segmentfault.com/q/1010000010786459
解決參考: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即可。