1. 程式人生 > >Windows 下 Nginx + PHP5 的安裝與配置

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 =
1

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 環境變數中的目錄。這裡不要

複製任何檔案到 Windows 目錄中,有必要的話,可以把 C:\php5 加到 PATH 中,便於以後 PHP 的升級。

安裝 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

到這裡基本配置完畢了。