Windows 下 Nginx + PHP5 的安裝與配置
本文轉自:http://www.phpvim.net/web/php/installing-nginx-with-php5-on-windows.html
Nginx 是一個輕量級的高效能 Http WebServer,以事件驅動方式編寫,因此相比 Apache 而言,Nginx 更加穩定、效能更好,而且配置簡單,資源佔用較低。以下是我在 Windows 7 安裝中 Nginx 和 PHP5.3 的步驟。
安裝 PHP5
首先,從 http://windows.php.net/download/ 下載最新的 PHP 5.3 Windows 版本,這裡 PHP 以 FastCGI 模式執行,所以請下載 None Thead Safe 版本。
解壓至 C:\php5,把壓縮包中的 php.ini-recommended,更名為 php.ini,然後開啟修改幾個選項:
1 2 3 4 5 6 7 8 9 10 11 |
error_reporting = E_ALL display_errors = On extension_dir = "C:\php5\ext" ; 動態擴充套件,可以根據需要去掉 extension 前面的註釋 ; ; 如載入 PDO, MySQL extension=php_pdo.dll extension=php_pdo_mysql.dll ; CGI 設定 cgi.fix_pathinfo = |
PHP 載入擴充套件需要注意依賴性,比如 php_exif.dll 需要 php_mbstring.dll,你必須要把 php_mbstring.dll 放在 php_exif.dll 前面才能載入成功。有些擴充套件依賴額外的 dll 檔案,如 PHP 5.0+ ,php_mysqli.dll 依賴 libmysql.dll,而 php_oci8.dll,你則需要安裝 Oracle 8 的客戶端。如果你對這些依賴性不是太瞭解,可以參考一下安裝包中的 install.txt 檔案。
依賴檔案的搜尋順序:首先是 php.exe 所在的目錄,如果是 ISAPI 模式,那麼會搜尋 Web Server 的啟動位置,比如 Apache 的 bin 目錄;其次是 Windows PATH 環境變數中的目錄。這裡不要
安裝 Nginx
從 v0.7.52 開始,Nginx 開始釋出 Windows 版本的 Nginx,你可以在其官方網站上面下載:
http://nginx.net
如果需要老版本的 Nginx for Windows,可以在 Kevin Worthington 的網站上面找找。
我使用的是 0.8.29,下載好以後,解壓釋放檔案到 C:\nginx。
那麼如何配置 Nginx,使其可以和 PHP 協同工作?
配置 PHP FastCGI
Nginx 需要和 FastCGI Server 配合才能處理請求,有兩種方式執行 PHP FastCGI Server,一種就是使用 PHP 內建的 FastCGI 管理器:
1 |
C:/php5/php-cgi.exe -b 127.0.0.1:9000 -c C:/php5/php.ini |
另外一種方式是使用第三方工具,比如 PHP-FPM 、cgi-fcgi 等。顯然!要在 Windows 中使用這些工具是件極其痛苦的事情,你可能需要 Cygwin 之類的東西才行,的確有人這麼做了,雖然我覺得那是自尋煩惱。
下一步,修改 Nginx ,將 php 請求轉發至 PHP FastCGI Server:
1 2 3 4 5 6 |
# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000 location ~ ^(.+\.php)(.*)$ { root D:/public_html; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include php.conf; } |
root 也就是 $document_root 指的是你的 php scripts 根目錄,設定為你的網站根目錄。在 Windows 下,需要注意的是 root 的路徑,最好使用 "/" 作為路徑分隔符,而不是 Windows 預設的 "\",否則容易出問題,比如,這個路徑:D:\public_html\test,就不會起作用,Nginx 會丟擲 500 錯誤,原因是 \test 中 \t 被解析為製表符。當然再加上一個反斜槓轉義也是可以的,如:D:\\public_html\\test。
php.conf 配置檔案:
1 2 3 4 5 6 7 8 9 10 11 12 |
# 連線到本機 9000 埠,這裡的埠是指 PHP FastCGI Server 開啟的埠, # 請與 php-cgi.exe 開啟的埠保持一致 # 當 Nginx 收到 php 檔案的請求時,會自動轉發到 PHP FastCGI Server fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; # Nginx 預設是不支援 CGI PATH_INFO,SCRIPT_NAME 的值也不標準(糅合了 PATH_INFO) # 下面的兩行指令,可以從 SCRIPT_NAME 中剝離出 PATH_INFO fastcgi_split_path_info ^(.+\.php)(.*)$; fastcgi_param PATH_INFO $fastcgi_path_info; include fastcgi_params; |
建立一個獨立的 php.conf 儲存配置,純粹是為了精簡 nginx.conf,個人習慣而已,也可以全部寫在主配置檔案中。
修改 php.ini,設定 cgi.fix_pathinfo = 1,這非常重要,PHP 會修正 SCRIPT_FILENAME 為真實的檔案地址,否則 PHP 將無法找到需要處理的 php 檔案。
一些其他的設定,主伺服器:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
# 預設開啟的程序數 worker_processes 1; error_log logs/error.log; #error_log logs/error.log notice; #error_log logs/error.log info; #pid logs/nginx.pid; events { # 一個程序所處理的最大連線數上限, # 本地開發,不需要預設的 1024,這裡改為 64 worker_connections 64; } |
當某個目錄下面不存在預設 index.php index.html 等首頁檔案時,Nginx 會丟擲 403 ERROR,如果你需要羅列此目錄,則可以在 http {… } 中加入如下命令:
1 2 3 |
autoindex on; autoindex_exact_size on; autoindex_localtime on; |
OK,整合到一起
建立 start_nginx.bat,用於同時啟動 PHP FastCGI 和 Nginx:
1 2 3 4 5 6 7 8 9 10 11 12 |
@echo off REM Windows 下無效 REM set PHP_FCGI_CHILDREN=5 REM 每個程序處理的最大請求數,或設定為 Windows 環境變數 set PHP_FCGI_MAX_REQUESTS=1000 echo Starting PHP FastCGI... RunHiddenConsole C:/php5/php-cgi.exe -b 127.0.0.1:9000 -c C:/php5/php.ini echo Starting nginx... C:/nginx/nginx.exe -p C:/nginx |
RunHiddenConsole.exe 是一個用來隱藏 DOS 視窗的小程式,可以在這裡下載。
start_nginx.bat 開啟後,也會有 DOS 視窗,但是可以安全的關掉,並不會關閉 Nginx 和 php-cgi.exe。
同樣 stop_nginx.bat,用來關閉:
1 2 3 4 5 6 |
@echo off echo Stopping nginx... taskkill /F /IM nginx.exe > nul echo Stopping PHP FastCGI... taskkill /F /IM php-cgi.exe > nul exit |
到這裡基本配置完畢了。