配置Nginx+PHP的正确思路与过程


Posted in PHP onMay 10, 2016

对很多人而言,配置Nginx+PHP无外乎就是搜索一篇教程,然后拷贝粘贴。听上去似乎也没什么问题,可惜实际上网络上很多资料本身年久失修,漏洞百出,如果大家不求甚解,一味的拷贝粘贴,早晚有一天会为此付出代价。

如何正确配置 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$is_args$args;
  }

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

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

如何正确配置 Nginx + PHP,相信大家应该有了自己的认识了吧!

PHP 相关文章推荐
BBS(php & mysql)完整版(八)
Oct 09 PHP
PHP4中session登录页面的应用
Jul 25 PHP
深入php数据采集的详解
Jun 02 PHP
php生成html文件方法总结
Dec 01 PHP
PHP中file_get_contents函数抓取https地址出错的解决方法(两种方法)
Sep 22 PHP
Symfony2使用Doctrine进行数据库查询方法实例总结
Mar 18 PHP
一个简单的php MVC留言本实例代码(必看篇)
Sep 22 PHP
php加密之discuz内容经典加密方式实例详解
Feb 04 PHP
phpmyadmin下载、安装、配置教程
May 16 PHP
php 中的closure用法详解
Jun 12 PHP
PHP SESSION机制的理解与实例
Mar 22 PHP
PHP如何将图片文件上传到另外一台服务器上
Aug 26 PHP
WordPress中设置Post Type自定义文章类型的实例教程
May 10 #PHP
php+MySQL实现登录时验证登录名和密码是否正确
May 10 #PHP
PHP7+Nginx的配置与安装教程详解
May 10 #PHP
php+mysql实现的二级联动菜单效果详解
May 10 #PHP
浅析Yii2缓存的使用
May 10 #PHP
php简单统计在线人数的方法
May 10 #PHP
使用php实现从身份证中提取生日
May 09 #PHP
You might like
PHP与SQL注入攻击[二]
2007/04/17 PHP
Zend Framework实现具有基本功能的留言本(附demo源码下载)
2016/03/22 PHP
cakephp常见知识点汇总
2017/02/24 PHP
读jQuery之二(两种扩展)
2011/06/11 Javascript
NodeJS框架Express的模板视图机制分析
2011/07/19 NodeJs
5个最佳的Javascript日期处理类库分享
2012/04/15 Javascript
jquery提取元素里的纯文本不包含span等里的内容
2013/09/30 Javascript
JS滚轮事件onmousewheel使用介绍
2013/11/01 Javascript
jquery、js调用iframe父窗口与子窗口元素的方法整理
2014/07/31 Javascript
Bootstrap3 内联单选和多选框
2016/12/29 Javascript
原生js和css实现图片轮播效果
2017/02/07 Javascript
js仿微信公众平台打标签功能
2017/04/08 Javascript
JS仿QQ好友列表展开、收缩功能(第二篇)
2017/07/07 Javascript
浅谈vue.js中v-for循环渲染
2017/07/26 Javascript
layui树形菜单动态遍历的例子
2019/09/23 Javascript
关于vue路由缓存清除在main.js中的设置
2019/11/06 Javascript
[43:51]2014 DOTA2国际邀请赛中国区预选赛 Dream Times VS TongFu
2014/05/22 DOTA
删除目录下相同文件的python代码(逐级优化)
2012/05/25 Python
python中迭代器(iterator)用法实例分析
2015/04/29 Python
python3 shelve模块的详解
2017/07/08 Python
Python单例模式的两种实现方法
2017/08/14 Python
关于Python 的简单栅格图像边界提取方法
2019/07/05 Python
Python partial函数原理及用法解析
2019/12/11 Python
如何理解python面向对象编程
2020/06/01 Python
深入浅析pycharm中 Make available to all projects的含义
2020/09/15 Python
python递归函数用法详解
2020/10/26 Python
python requests库的使用
2021/01/06 Python
SpringBoot首页设置解析(推荐)
2021/02/11 Python
CSS3区域模块region相关编写示例
2015/08/28 HTML / CSS
监察建议书范文
2014/03/12 职场文书
高三毕业典礼主持词
2014/03/27 职场文书
小学二年级学生评语
2014/04/21 职场文书
小学班主任培训方案
2014/06/04 职场文书
私人房屋买卖协议书
2014/10/04 职场文书
JavaScript 语句之常用 for 循环详解
2021/03/29 Javascript
Go语言基础切片的创建及初始化示例详解
2021/11/17 Golang