何正确配置Nginx+PHP

2024-04-11

何正确配置Nginx+PHP（精选3篇）

篇1：何正确配置Nginx+PHP

此时很多教程会教大家这样配置Nginx+PHP：

server{listen80;server_namefoo.com;root/path;location/{indexindex.htmlindex.htmindex.php;if(!-e$request_filename){rewrite./index.phplast;}}location~.php${includefastcgi_params;fastcgi_paramSCRIPT_FILENAME/path$fastcgi_script_name;fastcgi_pass127.0.0.1:9000;fastcgi_indexindex.php;}}

这里面有很多错误，或者说至少是坏味道的地方，大家看看能发现几个。

…

我们有必要先了解一下Nginx配置文件里指令的继承关系：Nginx配置文件分为好多块，常见的从外到内依次是「http」、「server」、「location」等等，缺省的继承关系是从外到内，也就是说内层块会自动获取外层块的值作为缺省值(有例外，详见参考)。

参考：UNDERSTANDING THE NGINX CONFIGURATION INHERITANCE MODEL

…

让我们先从「index」指令入手吧，在问题配置中它是在「location」中定义的：

location/{indexindex.htmlindex.htmindex.php;}

一旦未来需要加入新的「location」，必然会出现重复定义的「index」指令，这是因为多个「location」是平级的关系，不存在继承，此时应该在「server」里定义「index」，借助继承关系，「index」指令在所有的「location」中都能生效。

参考：Nginx Pitfalls

…

接下来看看「if」指令，说它是大家误解最深的Nginx指令毫不为过：

if(!-e$request_filename){rewrite./index.phplast;}

很多人喜欢用「if」指令做一系列的检查，不过这实际上是「try_files」指令的职责：

try_files$uri$uri//index.php;

除此以外，初学者往往会认为「if」指令是内核级的指令，但是实际上它是rewrite模块的一部分，加上Nginx配置实际上是声明式的，而非过程式的，所以当其和非rewrite模块的指令混用时，结果可能会非你所愿，

参考：IfIsEvilandHow nginx “location if” works

…

下面看看「fastcgi_params」配置文件：

includefastcgi_params;

Nginx有两份fastcgi配置文件，分别是「fastcgi_params」和「fastcgi.conf」，它们没有太大的差异，唯一的区别是后者比前者多了一行「SCRIPT_FILENAME」的定义：

fastcgi_paramSCRIPT_FILENAME$document_root$fastcgi_script_name;

注意：$document_root 和 $fastcgi_script_name 之间没有 /。

原本Nginx只有「fastcgi_params」，后来发现很多人在定义「SCRIPT_FILENAME」时使用了硬编码的方式，于是为了规范用法便引入了「fastcgi.conf」。

不过这样的话就产生一个疑问：为什么一定要引入一个新的配置文件，而不是修改旧的配置文件?这是因为「fastcgi_param」指令是数组型的，和普通指令相同的是：内层替换外层;和普通指令不同的是：当在同级多次使用的时候，是新增而不是替换。换句话说，如果在同级定义两次「SCRIPT_FILENAME」，那么它们都会被发送到后端，这可能会导致一些潜在的问题，为了避免此类情况，便引入了一个新的配置文件。

参考：FASTCGI_PARAMS VERSUS FASTCGI.CONF C NGINX CONFIG HISTORY

…

此外，我们还需要考虑一个安全问题：在PHP开启「cgi.fix_pathinfo」的情况下，PHP可能会把错误的文件类型当作PHP文件来解析。如果Nginx和PHP安装在同一台服务器上的话，那么最简单的解决方法是用「try_files」指令做一次过滤：

try_files$uri=404;

参考：Nginx文件类型错误解析漏洞

…

依照前面的分析，给出一份改良后的版本，是不是比开始的版本清爽了很多：

server{listen80;server_namefoo.com;root/path;indexindex.htmlindex.htmindex.php;location/{try_files$uri$uri//index.php$is_args$args;}location~.php${try_files$uri=404;includefastcgi.conf;fastcgi_pass127.0.0.1:9000;}}

实际上还有一些瑕疵，主要是「try_files」和「fastcgi_split_path_info」不够兼容，虽然能够解决，但方案比较丑陋，具体就不多说了，有兴趣的可以参考问题描述。

补充：因为「location」已经做了限定，所以「fastcgi_index」其实也没有必要。

…

希望大家以后不要再拷贝粘贴了，如果实在改不了，那么就请拷贝粘贴本文。

原文地址：huoding.com//10/23/290

篇2：何正确配置Nginx+PHP

linux下编译:

nginx我还是习惯选择8.54的版本,它的编译依赖以下几个软件包，解压这些源码包，在configure中设置好这些源码的路径，nginx在编译的时候会自己将他们编译进去的：

pcre: 主要用于rewrite等模块

zlib: 这个不用说了

openssl: 如果你还知道https教程这个东西，那么你懂的~~~（当然你可以不需要这个功能）

md5 /sha1: 这两者都是用于生成信息摘要的希哈算法，这俩个东西不是必须的，但是我发现如果不选择其中一个那么openssl是不会成功地编译进nginx的

下面是我自己写的一个安装脚本,有temp-path字样的编译选项所设置都是nginx在运行时产生的临时文件的路径,pid-path,lock-path也是临时文件路径,log-path是日志文件路径,我因为自己机子上一些权限的问题所以要设置一下.一般情况下其实这些是不必要的,nginx默认会统统把生成的这些文件放在自己的安装目录下.

tmp=/tmp/nginx

log=/home/jsckdao/log

pcre=~/downloads/pcre-8.02

zlib=~/downloads/zlib-1.2.5-src

penssl=~/downloads/openssl-0.9.8q

md5=~/downloads/md5-1.3.0

./configure --prefix=/usr/local/nginx

--http-proxy-temp-path=${tmp}/nginx-proxy.tmp

--http-fastcgi-temp-path=${tmp}/nginx-fcgi.tmp

--http-uwsgi-temp-path=${tmp}/nginx-uwsgi.tmp

--http-scgi-temp-path=${tmp}/nginx-scgi.tmp

--http-client-body-temp-path=${tmp}/nginx-client.tmp

--pid-path=${tmp}/nginx.pid

--lock-path=${tmp}/nginx.lock

--http-log-path=${log}/http.log

--error-log-path=${log}/http-error.log

--with-pcre=$pcre #pcre 源码包的路径

--with-zlib=$zlib #zlib 源码包的路径

--with-http_ssl_module #起用ssl支持

--with-openssl=$openssl #openssl 源码包路径

make

make install

php(5.2)的编译可以复杂点，也可以简单点，因为我们编译php时主要目的是编译它的脚本引擎和一些核心库，很多外围的东西不一定非要在编译php的时候加进去，可以在需要的时候将它们编译成扩展库再修改配置文件来加载它们。

我的编译代码如下：

./configure --prefix=/usr/local/php

--with-mysql教程=/usr/local/mysql #设置mysql的安装路径

--enable-fastcgi #开启fastcgi支持

--enable-debug #支持调试

make

make install

其实关于mysql的那一句都是可以不要的，只是我懒得再编译一次mysql扩展，所以就这样把它直接编译进php了,这样做的前提是你必须先安装mysql，

电脑资料

令外还有一些注意事项：编译php时必须确保系统中拥有libxml2与libxml-dev这俩个软件包，因为php默认会将xml的功能编译进去，所以xml的支持是必不可少的。还有一个就是autoconf这条命令了，在编译扩展的时候，phpize会调用系统中的这个命令来生成扩展包的configure文件，没有它你就不能作扩展了，这一点也是要记住的，毕竟linux下的php不像windows版那样事先把所有的扩展都编译好了。

至于window下nginx,php的安装就没有什么难度了,下个zip包,解压就能用,只要稍微配置就可以了.

配置:

如果只是想让php能运行的话那么直接输入命令:

./php-cgi -b 3344

这样就开启了php的fastcgi进程了,-b参数是绑定该进程的侦听端口,随便找个没用的端口填就可以了,这里绑定的是3344.

然后在nginx的配置文件中加上这么几行:

location ~ .php$ {

root /home/jsckdao/www; #这是你网站的根目录

fastcgi_pass 127.0.0.1:3344; #这里指定了fastcgi进程侦听的端口,nginx就是通过这里与php交互的

fastcgi_index index.php;

fastcgi_param script_filename $document_root/$fastcgi_script_name;

include fastcgi_params;

}

如果要改nginx的侦听端口的话找到“listen”这么一项,改就是了.运行nginx,在/home/jsckdao/www目录中写一个测试文件test.php:

phpinfo;

访问localhost:8080/test.php,如果显示了php所以的配置信息,那么就基本没什么问题,已经可以用这个环境写些php代码了.

至于php的调试器我选择xdebug，不为什么，习惯所致。加载xdebug时，在配置文件中的写法根据系统的不同好像也有点不同。linux下是：zend_extension_debug=

,window中加载的dll有两种，一种文件名会带有ts的后缀，这种要这要样写：zend_extension_ts=

另外一种就这样:zend_extension=

,path一定要写绝对路径。虽然ts为何意我也不是很清楚，但是这些设置是一定不可以搞错的。

设置好后重新运行php-cgi,然后重新访问test.php,如果有xdebug的那一块出现了,那么就成功了.

当然这是一个很简单的配置,只能让你运行php,要想真正做成你需要的开发环境,还需要你根据自己的需要修改php和nginx的配置文件,这些配置内容很多,我自己也在学习中,就不好多讲了.

另外有一点需要注意,php的配置文件在它的源码包中有两个:php.ini-dist和php.ini-recommended,分别是针对生成环境和开发环境的配置.你需要把其中一个改名为php.ini.重启后查看phpinfo()的页面,靠上的地方有一项“ loaded configuration file”,它的值如果就是你的php.ini的路径,那么就没问题了,如果不是话,就看看上面一项“ configuration file (php.ini) path”,你把你的php.ini文件移到这个目录下在重启就可以了.因为php默认会在这个路径下寻找php.ini的.当然你也可以在运行php-cgi的时候设置你的php.ini路径,比如这样:

php-cgi -b 3344 -c /home/jsckdao/php.ini