Windows 下 Nginx + PHP5 的安装与配置

May 10th, 2009 | Filed under PHP

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

到这里基本配置完毕了。

😛

Tags: , ,
  1. Rainux
    May 12th, 2009 at 00:59
    Reply | Quote | #1

    Nginx 的 Windows 版稳定性如何?我曾经在朋友的 Windows Server 2003 上跑 WLMP 项目提供的 Lighttpd 1.4.20 + PHP FastCGI,Lighty 总会在一段时间不对 Web 访问做任何响应,重启 Lighty 才能恢复。

  2. Verdana Mu
    May 12th, 2009 at 10:42
    Reply | Quote | #2

    Nginx 非常稳定,但我不知道在 Windows 下表现怎么样,我也是刚刚接触 Ng; 而 Lighttpd 有内存泄漏问题,不推荐。

    问题在于 PHP 自启动的 FastCGI Server 处理能力如何,可否理解为一个 FPM?这里我还有点模糊,你可以试一下,如果不行的话,可以考虑这样,用 Nginx 作为前端处理静态资源、负载平衡,动态内容通过反向代理发送到后台,至于处理 PHP 的是什么?可能是 IIS / apache / lighttpd + php 都可以。Windows 你可以试试 IIS7 的 FastCGI,CGI 不行,太慢,ISAPI 要求 thead-safe,很不稳定。

  3. onesec
    Jun 6th, 2009 at 11:10
    Reply | Quote | #3

    谢谢,通过你的方法,我成功的设置了.现在windows下跑着apache和nginx,呵呵

  4. tomosak
    Sep 15th, 2009 at 21:20
    Reply | Quote | #4

    刚刚学习Nginx,web和php都搞定了,就是php的扩展启动不了,mysql数据库连接不到,请问如何解决?还有,PHP.INI文件,好像放到Nginx就可以了是不是?

  5. tomosak
    Sep 15th, 2009 at 22:56
    Reply | Quote | #5

    问题解决了,自己继续学习——

  6. dp
    Sep 18th, 2009 at 16:03
    Reply | Quote | #6

    你这方法只启动了一个php-cgi进程,当你在一个脚本中要调用一个本机服务器进程的时候咋办,比如你运行
    http://localhost/test.php
    而test.php 的脚本是

    当test2.php存在的时候,这就卡壳里,咋办?有解决办法希望能往我邮箱来个回复。

  7. wlong
    Sep 22nd, 2009 at 13:27
    Reply | Quote | #7

    我发现用这种方式运行php-cgi.exe 很不稳定, 稍微有几个访问php-cgi进程就会崩溃,后来我一下开启50个php-cgi进程,但是也会陆续崩溃。请问有什么办法解决?

  8. 我买糕的。
    Nov 12th, 2009 at 16:49
    Reply | Quote | #8

    先标记一个。。慢慢看呵呵。

  9. LV
    Dec 9th, 2009 at 18:44
    Reply | Quote | #9

    因为脑袋不灵光,我就先用手机保存吧!

  10. CARSON
    Dec 10th, 2009 at 09:48

    wlong :
    我发现用这种方式运行php-cgi.exe 很不稳定, 稍微有几个访问php-cgi进程就会崩溃,后来我一下开启50个php-cgi进程,但是也会陆续崩溃。请问有什么办法解决?

    对.我也是碰到这样的问题..没办法…我就开启了10个php-cgi来监听不同的( 9000-9009)端口,然后用定时十分钟重启 nginx php-cgi, 因为是直接杀进程,然后启动,所以这样的重启用户根本就感觉不出来, 貌似这两天web好些了..

    但我看到别人的教程说是监听 127.0.0.1:9000 就一个进程..windows 下我不知道如何多个进程来监听一个9000端口..恳请高手指教!

  11. Verdana Mu
    Dec 10th, 2009 at 18:47

    CARSON :

    wlong :
    我发现用这种方式运行php-cgi.exe 很不稳定, 稍微有几个访问php-cgi进程就会崩溃,后来我一下开启50个php-cgi进程,但是也会陆续崩溃。请问有什么办法解决?

    对.我也是碰到这样的问题..没办法…我就开启了10个php-cgi来监听不同的( 9000-9009)端口,然后用定时十分钟重启 nginx php-cgi, 因为是直接杀进程,然后启动,所以这样的重启用户根本就感觉不出来, 貌似这两天web好些了..

    但我看到别人的教程说是监听 127.0.0.1:9000 就一个进程..windows 下我不知道如何多个进程来监听一个9000端口..恳请高手指教!

    FastCGI PHP 有两个关键环境变量参数用来调节性能。

    PHP_FCGI_CHILDREN,默认值是 0
    第一个参数控制了 php-cgi 主进程所能 spawn 的子进程数目。 0 的情况下,php-cgi 不会产生子进程,由主进程负责处理请求。当 > 0 时,php-cgi 生成了对应的数目的子进程处理请求,而主进程则只负责管理子进程(*nix 系统中你会看到这个进程占用的内存很小)。当然这是在 *nix 系统的情况下,Windows 中,这个参数无效,看一下 PHP 源码 sapi/cgi/cgi_main.c 可以确认这一点。

    PHP_FCGI_MAX_REQUESTS,默认值 500
    php-cgi 进程处理的最大请求数,当处理的请求 >= 这个数字时,php-cgi 便会自我销毁,*nix 系统中 PHP_FCGI_CHILDREN > 0 的情况下便会重生一个新的 php-cgi 进程。Windows 中第一个参数无效,所以只有一个主进程,因此自毁以后 PHP 也就挂了,而这个参数又是必须的,设置过大的话,没什么意义,PHP 中有不少函数都存在内存泄露的问题,如果无限制处理请求,php-cgi 的性能只会越来越弱直至崩溃。

    Windows 系统实在没什么好的方法,可以在 Cygwin 下面自己编译一个带 php-fpm 的 PHP,以前只能用 patch 的方式给 PHP 打 fpm 的补丁,5.3.2+ 已经内置了…
    或者用 Lighttpd 的 spawn-cgi,似乎有 Win32 版本。

    生产环境下,如果必须是 Win32 系统,建议还是转到 IIS7 + PHP FASTCGI,Nginx 只能拿到玩玩而已。

  12. carson
    Dec 12th, 2009 at 00:35

    @Verdana Mu
    Verdana Mu, 感谢你的耐心回复和热情介绍,让我着实学到了不少东西,谢谢!
    我非常想用 iis7+php fastcgi 但貌似目前iis7只能装在win2k8 上,而win2k8目前破解的没有吧(可能是我没找到,买的话公司不肯掏钱),而公司服务器是win2k3,所以只能将就啦。
    从前几天我装了nginx+php5.2.11的情况来看,网站非常的稳定。中间没有挂过,比之前用apache好多了(之前老是挂掉,我估计是系统的问题,准备明天下午去机房重装,顺便加多台win2k3的服务器)。
    我看过我设置的定时重启nginx php-cgi的情况,用bat直接kill, 如下:

    echo “stop nginx”
    taskkill /F /IM nginx.exe > nul
    echo “stop php-cgi”
    taskkill /F /IM php-cgi.exe > nul

    @echo off

    echo “Starting PHP FastCGI…”
    RunHiddenConsole d:/web/php/php-cgi.exe -b 127.0.0.1:9000 -c d:/web/php/php.ini
    RunHiddenConsole d:/web/php/php-cgi.exe -b 127.0.0.1:9001 -c d:/web/php/php.ini
    RunHiddenConsole d:/web/php/php-cgi.exe -b 127.0.0.1:9002 -c d:/web/php/php.ini
    RunHiddenConsole d:/web/php/php-cgi.exe -b 127.0.0.1:9003 -c d:/web/php/php.ini
    RunHiddenConsole d:/web/php/php-cgi.exe -b 127.0.0.1:9004 -c d:/web/php/php.ini
    RunHiddenConsole d:/web/php/php-cgi.exe -b 127.0.0.1:9005 -c d:/web/php/php.ini
    RunHiddenConsole d:/web/php/php-cgi.exe -b 127.0.0.1:9006 -c d:/web/php/php.ini
    RunHiddenConsole d:/web/php/php-cgi.exe -b 127.0.0.1:9007 -c d:/web/php/php.ini
    RunHiddenConsole d:/web/php/php-cgi.exe -b 127.0.0.1:9008 -c d:/web/php/php.ini
    RunHiddenConsole d:/web/php/php-cgi.exe -b 127.0.0.1:9009 -c d:/web/php/php.ini

    echo “Starting nginx…”
    start “nginx” “d:/web/nginx/nginx.exe”
    exit

    😛 貌似这样的方法在windows下还可以,kill 到 start几乎是在瞬间完成的,用户感觉不到变化,其他朋友可以参考。

    。。我非常的想用linux做服务器,因为那样的话可以最大程度上发挥nginx php-cgi的性能,要是有朋友有在windows下更好的方案还恳请指教,多谢。QQ:227501 (欢迎交流)

    “Nginx 只能拿到玩玩而已” 我不是很赞同。在处理静态文件方面,它的性能不管是在linux还是windows下那是相当的牛B, 而且内存占用不过几M而已。。。速度超快。。但处理动态语言例如php方面在windows下我还没有比较好的方案。还有个就是同服务器上不同站点间目录权限问题,这点apache iis比nginx好。

  13. 影の域
    Jan 28th, 2010 at 23:27
    #13
  14. carson
    Mar 22nd, 2010 at 10:15

    最近换到rhle5 下去了,用 nginx php-fpm 来跑,情况很稳定,3个月了,没出现故障(没看日志,只根据使用情况来看的)。

Comments are closed.