Windows下Nginx + PHP5 的安装与配置方法
程序员文章站
2023-11-18 22:57:10
安装 php5 首先，从 http://www.php.net/downloads.php 下载最新的 php 5.3 windows 版本，解压至 c:\php5，把压缩...
安装 php5
首先，从 http://www.php.net/downloads.php 下载最新的 php 5.3 windows 版本，解压至 c:\php5，把压缩包中的 php.ini-recommended，更名为 php.ini，然后打开修改几个选项：
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 管理器：
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：
# 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 配置文件：
# 连接到本机 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 文件。
一些其他的设置，主服务器：
# 默认开启的进程数
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 {… } 中加入如下命令：
autoindex on;
autoindex_exact_size on;
autoindex_localtime on;
ok，整合到一起
创建 start_nginx.bat，用于同时启动 php fastcgi 和 nginx：
@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
runhiddenconsole.exe 是一个用来隐藏 dos 窗口的小程序，可以在这里下载。
start_nginx.bat 开启后，也会有 dos 窗口，但是可以安全的关掉，并不会关闭 nginx 和 php-cgi.exe。
同样 stop_nginx.bat，用来关闭：
@echo off
echo stopping nginx...
taskkill /f /im nginx.exe > nul
echo stopping php fastcgi...
taskkill /f /im php-cgi.exe > nul
exit
到这里基本配置完毕了。
首先，从 http://www.php.net/downloads.php 下载最新的 php 5.3 windows 版本，解压至 c:\php5，把压缩包中的 php.ini-recommended，更名为 php.ini，然后打开修改几个选项：
复制代码 代码如下:
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 管理器：
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：
复制代码 代码如下:
# 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 配置文件：
复制代码 代码如下:
# 连接到本机 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 文件。
一些其他的设置，主服务器：
复制代码 代码如下:
# 默认开启的进程数
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 {… } 中加入如下命令：
复制代码 代码如下:
autoindex on;
autoindex_exact_size on;
autoindex_localtime on;
ok，整合到一起
创建 start_nginx.bat，用于同时启动 php fastcgi 和 nginx：
复制代码 代码如下:
@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
runhiddenconsole.exe 是一个用来隐藏 dos 窗口的小程序，可以在这里下载。
start_nginx.bat 开启后，也会有 dos 窗口，但是可以安全的关掉，并不会关闭 nginx 和 php-cgi.exe。
同样 stop_nginx.bat，用来关闭：
复制代码 代码如下:
@echo off
echo stopping nginx...
taskkill /f /im nginx.exe > nul
echo stopping php fastcgi...
taskkill /f /im php-cgi.exe > nul
exit
到这里基本配置完毕了。