正确配置Nginx+PHP环境方法介绍

假设我们用PHP实现了一个前端控制器,或者直白点说就是统一入口:把PHP请求都发送到同一个文件上,然后在此文件里通过解析「REQUEST_URI」实现路由。

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

 代码如下 复制代码

server {
    listen 80;
    server_name foo.com;

    root /path;

    location / {
        index index.html index.htm index.php;

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

    location ~ .php$ {
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME /path$fastcgi_script_name;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
    }
}

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

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

 

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

 代码如下 复制代码

location / {
    index index.html index.htm index.php;
}

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

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

 代码如下 复制代码

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

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

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

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

 代码如下 复制代码

include fastcgi_params;

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

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

注意:

$document_root 和 $fastcgi_script_name 之间没有 /。

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

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

 

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

 代码如下 复制代码

try_files $uri =404;

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

 代码如下 复制代码

server {
    listen 80;
    server_name foo.com;

    root /path;
    index index.html index.htm index.php;

    location / {
        try_files $uri $uri/ /index.php;
    }

    location ~ .php$ {
        try_files $uri =404;

        include fastcgi.conf;
        fastcgi_pass 127.0.0.1:9000;
    }
}

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

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

时间: 2024-10-25 00:45:43

正确配置Nginx+PHP环境方法介绍的相关文章

windows下配置nginx+php环境

刚看到nginx这个词,我很好奇它的读法(engine x),我的直译是"引擎x",一般引"擎代"表了性能,而"x"大多出现是表示"xtras(额外的效果)",那么整个词的意思就是类似"极致效果","额外性能".当然这里不是要来唠嗑,以上是题外话. nginx相较于我们熟悉的apache,IIS的优势,就我浅入浅出的了解,在于"反向代理"和"负载均衡&quo

windows平台中配置nginx+php环境_php技巧

刚看到nginx这个词,我很好奇它的读法(engine x),我的直译是"引擎x",一般引"擎代"表了性能,而"x"大多出现是表示"xtras(额外的效果)",那么整个词的意思就是类似"极致效果","额外性能".当然这里不是要来唠嗑,以上是题外话. nginx相较于我们熟悉的apache,IIS的优势,就我浅入浅出的了解,在于"反向代理"和"负载均衡&quo

如何正确配置 Nginx+PHP

如何正确配置 Nginx+PHP 对很多人而言,配置Nginx+PHP无外乎就是搜索一篇教程,然后拷贝粘贴.听上去似乎也没什么问题,可惜实际上网络上很多资料本身年久失修,漏洞百出,如果大家不求甚解,一味的拷贝粘贴,早晚有一天会为此付出代价. 假设我们用PHP实现了一个前端控制器,或者直白点说就是统一入口:把PHP请求都发送到同一个文件上,然后在此文件里通过解析「REQUEST_URI」实现路由. 一般这样配置 此时很多教程会教大家这样配置Nginx+PHP: server { listen 80

树莓派里面如何正确配置java的环境变量

问题描述 树莓派里面如何正确配置java的环境变量 最近入树莓派,也初学Linux,想在上面搭建一个轻量级的Web服务器 之前用apt-get install 命令搭建了openJDK+Tomcat7+Mysql成功 后来发现openJDK部分功能受限,想安装Oracle官方的JDK 下载后配置环境变量,发现网上的都是各说各话 而且很多都是错误的 我现在的/ect/profile配置文件如下 # /etc/profile: system-wide .profile file for the Bo

Win8系统进入安全模式没有最后一次正确配置选项的解决方法

Win8旗舰版系统电脑遇到问题的时候,可通过最后一次正确配置,帮助大家解决一些问题.可是有很多用户安装win8系统之后,进入安全模式发现没有最后一次正确配置选项,怎么办呢,该如何开启最后一次正确配置选项呢?下面小编分享开启最后一次正确配置选项的方法. 开启最后一次正确配置选项的解决方法: 1.在"运行"对话框中输入"regedit"打开注册表编辑器: 2.依次展开到"HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\C

Yii2配置Nginx伪静态的方法

本文实例讲述了Yii2配置Nginx伪静态的方法.分享给大家供大家参考,具体如下: 主要检查以下代码: location / { # Redirect everything that isn't a real file to index.php try_files $uri $uri/ /index.php?$args; } 完整代码: server { charset utf-8; client_max_body_size 128M; listen 80; ## listen for ipv4

详解如何正确配置PHP开发环境

PHP语言在进行开发之前,需要将开发环境配置妥当,这样才能实现我们的程序完美运行.那么,如何正确的配置PHP开发环境呢?文章将介绍Apache.MySql.PHP的下载.安装及配置,分别讲述在windows和Linux环境下开发环境的搭建. 一.下载Apache.MySql和PHP 1.Apache的下载 Apache服务器可以通过官方提供的镜像地址来下载windows的Apache安装程序,不过都是英文版的,而且下载速度太慢.我建议大家去华军.天空或者中关村下载最新版的安装程序,速度很快. 2

如何正确配置PHP开发环境

PHP语言在进行开发之前,需要将开发环境配置妥当,这样才能实现我们的程序完美运行.那么,如何正确的配置PHP开发环境呢?文章将介绍Apache.MySql.PHP的下载.安装及配置,分别讲述在windows和Linux环境下开发环境的搭建. 一.下载Apache.MySql和PHP 1.Apache的下载 Apache服务器可以通过官方提供的镜像地址来下载windows的Apache安装程序,不过都是英文版的,而且下载速度太慢.我建议大家去华军.天空或者中关村下载最新版的安装程序,速度很快. 2

在Linux系统上怎么通过uWSGI配置Nginx+Python环境

  1.安装ubuntu有uwsgi的ppa: ? 1 2 3 add-apt-repository ppa:stevecrozz/ppa apt-get update apt-get install uwsgi 2. 用uwsgi代替mod_wsgi Nginx 的整体配置这里不说了,假设已经明白 Nginx的基本配置,那么uwsgi就类似这么配置: ? 1 2 3 4 location / { include uwsgi_params uwsgi_pass 127.0.0.1:9090 }