转:Windows 下 Nginx + PHP5 的安装与配置
Nginx?是一个轻量级的高性能 Http WebServer,以事件驱动方式编写,因此相比 Apache 而言,Nginx 更加稳定、性能更好,而且配置简单,资源占用较低。以下是我在 Windows 7 安装中 Nginx 和 PHP5.2 的步骤。
首先,从?http://www.php.net/downloads.php?下载最新的 PHP5.2.9-2 Windows 版本,解压至 C:\php5,把压缩包中的 php.ini-recommended,更名为 php.ini,然后打开修改几个选项:
1 2 3 4 5 6 7 8 9 10 11 12 13 |
<span style="margin: 0px; color: #000099; padding: 0px;">error_reporting</span> <span style="margin: 0px; color: #000066; font-weight: bold; padding: 0px;">=</span><span style="margin: 0px; color: #660066; padding: 0px;"> E_ALL</span> <span style="margin: 0px; color: #000099; padding: 0px;">display_errors</span> <span style="margin: 0px; color: #000066; font-weight: bold; padding: 0px;">=</span><span style="margin: 0px; color: #660066; padding: 0px;"> On</span> <span style="margin: 0px; color: #000099; padding: 0px;">extension_dir</span> <span style="margin: 0px; color: #000066; font-weight: bold; padding: 0px;">=</span> <span style="margin: 0px; color: #993333; padding: 0px;">"C:\php5\ext"</span> ? <span style="font-style: italic; margin: 0px; color: #666666; padding: 0px;">; 动态扩展,可以根据需要去掉 extension 前面的注释 ; </span> <span style="font-style: italic; margin: 0px; color: #666666; padding: 0px;">; 如加载 PDO, MySQL</span> <span style="margin: 0px; color: #000099; padding: 0px;">extension</span><span style="margin: 0px; color: #000066; font-weight: bold; padding: 0px;">=</span><span style="margin: 0px; color: #660066; padding: 0px;">php_pdo.dll</span> <span style="margin: 0px; color: #000099; padding: 0px;">extension</span><span style="margin: 0px; color: #000066; font-weight: bold; padding: 0px;">=</span><span style="margin: 0px; color: #660066; padding: 0px;">php_pdo_mysql.dll</span> ? <span style="font-style: italic; margin: 0px; color: #666666; padding: 0px;">; CGI 设置</span> cgi.force_redirect <span style="margin: 0px; color: #000066; font-weight: bold; padding: 0px;">=</span><span style="margin: 0px; color: #660066; padding: 0px;"> 1</span> cgi.fix_pathinfo <span style="margin: 0px; color: #000066; font-weight: bold; padding: 0px;">=</span><span style="margin: 0px; color: #660066; padding: 0px;"> 1</span> cgi.rfc2616_headers <span style="margin: 0px; color: #000066; font-weight: bold; padding: 0px;">=</span><span style="margin: 0px; color: #660066; padding: 0px;"> 1</span> |
?
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 的升级。
从 v0.7.52 开始,Nginx 开始发布 Windows 版本的 Nginx,你可以在其官方网站上面下载:
http://nginx.net
如果需要老版本的 Nginx for Windows,可以在?Kevin Worthington?的网站上面找找。
我使用的是 0.7.55,下载好以后,解压释放文件到 C:\nginx。
那么如何配置 Nginx,使其可以和 PHP 协同工作?
Nginx 需要和 FastCGI Server 配合才能处理请求,有两种方式运行 PHP FastCGI Server,一种就是使用 PHP 内置的 FastCGI 管理器:
1 |
c:<span style="margin: 0px; color: #000000; font-weight: bold; padding: 0px;">/</span>php5<span style="margin: 0px; color: #000000; font-weight: bold; padding: 0px;">/</span>php-cgi.exe <span style="margin: 0px; color: #660033; padding: 0px;">-b</span> 127.0.0.1:<span style="margin: 0px; color: #000000; padding: 0px;">9000</span> <span style="margin: 0px; color: #660033; padding: 0px;">-c</span> c:<span style="margin: 0px; color: #000000; font-weight: bold; padding: 0px;">/</span>php5<span style="margin: 0px; color: #000000; font-weight: bold; padding: 0px;">/</span>php.ini |
另外一种方式是使用第三方工具,比如 PHP-FPM 、cgi-fcgi 等。显然!要在 Windows 中使用这些工具是件极其痛苦的事情,你可能需要 Cygwin 之类的东西才行,的确有人这么做了,虽然我觉得那是自寻烦恼。
下一步,开始修改 Nginx 的配置文件 C:\nginx\conf\nginx.conf,找到 php 相关的部分,修改如下:
1 2 3 4 5 |
<span style="font-style: italic; margin: 0px; color: #adadad; padding: 0px;"># pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000</span> <span style="margin: 0px; color: #00007f; padding: 0px;">location</span> ~ \.php$ { root d:/public_html; <span style="margin: 0px; color: #00007f; padding: 0px;">include</span> php.conf; } |
root 也就是 $document_root 指的是你的 php scripts 根目录,设置为你的网站根目录。在 Windows 下,需要注意的是 root 的路径,最好使用 "/" 作为路径分隔符,而不是 Windows 默认的 "\",否则容易出问题,比如,这个路径:d:\public_html\test,就不会起作用,Nginx 会抛出 500 错误,原因是 \test 中 \t 被解析为制表符。当然再加上一个反斜杠转义也是可以的,如:d:\\public_html\\test。
php.conf 是我自己创建的用来保存 php 配置的文件,其实里面只有 3 行命令:
1 2 3 4 5 6 |
<span style="font-style: italic; margin: 0px; color: #adadad; padding: 0px;"># 连接到本机 9000 端口,这里的端口是指 PHP FastCGI Server 开启的端口,</span> <span style="font-style: italic; margin: 0px; color: #adadad; padding: 0px;"># 请与 php-cgi.exe 开启的端口保持一致</span> <span style="font-style: italic; margin: 0px; color: #adadad; padding: 0px;"># 当 Nginx 收到 php 文件的请求时,会自动转发到 PHP FastCGI Server</span> fastcgi_pass 127.0.0.1:<span style="margin: 0px; color: #ff0000; padding: 0px;">9000</span>; fastcgi_index index.php; <span style="margin: 0px; color: #00007f; padding: 0px;">include</span> fastcgi_params; |
之所以要创建一个独立的 php.conf 保存配置为了精简 nginx.conf,当在 nginx 中配置多个虚拟主机时,每个虚拟主机都需要配置 php,那么主配置文件就会变得重复、臃肿。
除此以外,还需要修改一下 c:\nginx\conf\fastcgi_params 文件,加入一行:
1 |
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; |
并且修改 php.ini,设置 cgi.fix_pathinfo = 1,这非常重要,否则 PHP 将无法找到需要处理的 php 脚本。
一些其他的设置,主服务器:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
<span style="font-style: italic; margin: 0px; color: #adadad; padding: 0px;"># 默认开启的进程数</span> worker_processes <span style="margin: 0px; color: #ff0000; padding: 0px;">1</span>; ? error_log logs/error.log; <span style="font-style: italic; margin: 0px; color: #adadad; padding: 0px;">#error_log logs/error.log notice;</span> <span style="font-style: italic; margin: 0px; color: #adadad; padding: 0px;">#error_log logs/error.log info;</span> ? <span style="font-style: italic; margin: 0px; color: #adadad; padding: 0px;">#pid logs/nginx.pid;</span> ? events { <span style="font-style: italic; margin: 0px; color: #adadad; padding: 0px;"># 一个进程所处理的最大连接数上限,</span> <span style="font-style: italic; margin: 0px; color: #adadad; padding: 0px;"># 本地开发,不需要默认的 1024,这里改为 64</span> worker_connections <span style="margin: 0px; color: #ff0000; padding: 0px;">64</span>; } |
当某个目录下面不存在默认 index.php index.html 等首页文件时,Nginx 会抛出 403 ERROR,如果你需要罗列此目录,则可以在 http {… } 中加入如下命令:
1 2 3 |
autoindex <span style="margin: 0px; color: #0000ff; padding: 0px;">on</span>; autoindex_exact_size <span style="margin: 0px; color: #0000ff; padding: 0px;">on</span>; autoindex_localtime <span style="margin: 0px; color: #0000ff; padding: 0px;">on</span>; |
创建 start_nginx.bat,用于同时启动 PHP FastCGI 和 Nginx:
1 2 3 4 5 6 |
<span style="margin: 0px; color: #33cc33; padding: 0px;">@</span><span style="margin: 0px; color: #b1b100; font-weight: bold; padding: 0px;">echo</span> off <span style="margin: 0px; color: #b1b100; font-weight: bold; padding: 0px;">echo</span> Starting PHP FastCGI... RunHiddenConsole c:/php5/php-cgi.exe -b 127.0.0.1:<span style="margin: 0px; color: #cc66cc; padding: 0px;">9000</span> -c c:/php5/php.ini ? <span style="margin: 0px; color: #b1b100; font-weight: bold; padding: 0px;">echo</span> Starting nginx... c:/nginx/nginx.exe |
RunHiddenConsole.exe 是一个用来隐藏 DOS 窗口的小程序,可以在这里下载。
start_nginx.bat 开启后,也会有 DOS 窗口,但是可以安全的关掉,并不会关闭 Nginx 和 php-cgi.exe。
同样 stop_nginx.bat,用来关闭:
1 2 3 4 5 6 |
<span style="margin: 0px; color: #33cc33; padding: 0px;">@</span><span style="margin: 0px; color: #b1b100; font-weight: bold; padding: 0px;">echo</span> off <span style="margin: 0px; color: #b1b100; font-weight: bold; padding: 0px;">echo</span> Stopping nginx... taskkill /F /IM nginx.exe > <span style="margin: 0px; color: #0000ff; font-weight: bold; padding: 0px;">nul</span> <span style="margin: 0px; color: #b1b100; font-weight: bold; padding: 0px;">echo</span> Stopping PHP FastCGI... taskkill /F /IM php-cgi.exe > <span style="margin: 0px; color: #0000ff; font-weight: bold; padding: 0px;">nul</span> <span style="margin: 0px; color: #00b100; font-weight: bold; padding: 0px;">exit</span> |
到这里基本配置完毕了。