nginx隐藏index.php和开启pathinfo模式的配置方法详解

灰太狼 2020-05-19 08:57 789阅读 0赞

**nginx隐藏index.php和开启pathinfo模式的配置方法详解**
nginx 通过 location 的规则匹配将 php 转发给 php-fpm 处理后获取结果然后返回给客户端，转发模式可以通过 unix sock 或 tcp socket 方式。

百度了好多文章我是没遇到一个能完整的而且正确的把 nginx 和 php 结合的配置讲述的较为正确的，这里总结了下最基本的 nginx + php 的模式配置，以及隐藏 index.php 和 开启 pathinfo 模式的方法。

个人觉得是可以复制粘贴配置你的生产环境的，总结了很多好的博文的要点，比如隐藏 index.php 的 location 规则用的是 try_files 而不是烂大街的 if (! -e $uri) {}，http 服务器级配置文件 和 虚拟主机配置文件也很好的分割开了，方便维护。

nginx 配置分两大层，基础的全局 http 配置 和 与主机相对应的 server 配置。

**http 配置**

```ini
nginx.conf
# nginx main configure
user  www www;
worker_processes auto;
error_log  /var/log/error.log  crit;
pid        /var/nginx.pid;
#Specifies the value for maximum file descriptors that can be opened by this process.
worker_rlimit_nofile 2048;
events
{
    use epoll;
    worker_connections 2048;
    multi_accept on;
}
http
{
    include       mime.types;
    default_type  application/octet-stream;
    server_names_hash_bucket_size 128;
    client_header_buffer_size 32k;
    large_client_header_buffers 4 32k;
    client_max_body_size 50m;
    sendfile   on;
    tcp_nopush on;
    keepalive_timeout 60;
    tcp_nodelay on;
    fastcgi_connect_timeout 300;
    fastcgi_send_timeout 300;
    fastcgi_read_timeout 300;
    fastcgi_buffer_size 64k;
    fastcgi_buffers 4 64k;
    fastcgi_busy_buffers_size 128k;
    fastcgi_temp_file_write_size 256k;
    gzip on;
    gzip_min_length  1k;
    gzip_buffers     4 16k;
    gzip_http_version 1.1;
    gzip_comp_level 2;
    gzip_types     text/plain application/javascript application/x-javascript text/javascript text/css application/xml application/xml+rss;
    gzip_vary on;
    gzip_proxied   expired no-cache no-store private auth;
    gzip_disable   "MSIE [1-6]\.";
    #limit_conn_zone $binary_remote_addr zone=perip:10m;
    ##If enable limit_conn_zone,add "limit_conn perip 10;" to server section.
    server_tokens off;
    access_log off;
    # http 配置
    include vhost/*.conf;
}
```

nginx http 的主配置文件，这里面包含了用户组，日志，处理类型，压缩传输，并发数等参数配置。我们并没有在这里配置 server，而是将所有的 server 放置到 vhost 文件中，清晰的管理我们的 server 虚拟主机配置。我们可以将不同 server 服务器单独配置为 conf 文件。

**server 配置**

比如我们配置一虚拟主机 default

```ini
vhost/default.conf
```

这里面参数配置包括：隐藏 index.php，开启php处理或开启php pathinfo模式，单独处理静态资源

**注意：**

如果你想开启 pathinfo 模式只需要将 enable-php.conf 改为 enable-php-pathinfo.conf 即可，二者选其一

```ini
server
{
    listen 80;
    #listen [::]:80;
    server_name www.default.com;
    index index.html index.htm index.php;
    root  /var/www/default;
    #error_page   404   /404.html;
    #hide index.php
    location / {
        # yii2 框架的 /site/index?name=sallency&age=25 模式的 rewrite 方法
        try_files $uri $uri/ /index.php$is_args$args;
        # tp 框架的 /site/index/name/sallency/age/25 模式的 rewrite 方法
        try_files $uri $uri/ /index.php/$uri;
        # 虽然 if 不规范但 rewrite 还是很方便的 可以兼容 yii2 和 tp 的 pathinfo 模式
        if (!-e $request_filename){
           rewrite ^/(.*)$ /index.php/$1 last;
           break;
        }
    }
    #handler php request
    include enable-php.conf;
    #php with pathinfo
    #include enable-php-pathinfo.conf;
    #handler static resource
    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
    {
        expires      30d;
    }
    location ~ .*\.(js|css)?$
    {
        expires      12h;
    }
    #forbidden access . type
    location ~ /\.
    {
        deny all;
    }
    access_log  /var/log/nginx/default_access.log
}
```

**配置 php**

```ini
enable-php.conf
```

开启此配置便可以让 nginx 处理 php 文件，需要注意的是 fastcig_pass 的模式有两种：

`unix socket`：不走网卡 效率高但不稳定

`tcp socket`：127.0.0.1:9000 相比 unix socket 会慢一点点，但稳定性高出很多

此处的模式和配置选择应与 php-fpm.conf 中的 listen 参数保持一致：

```ini
listen = /tmp/php-cgi.sock
listen = 127.0.0.1:9000
        location ~ [^/]\.php(/|$)
        {
            try_files $uri =404;
            #listen unix socket
            #fastcgi_pass  unix:/tmp/php-cgi.sock;
            #listen tcp socket
            fastcgi_pass  127.0.0.1:9000;
            fastcgi_index index.php;
            include fastcgi.conf;
        }
```

**配置 pathinfo 模式**

```properties
enable-php-pathinfo.conf
```

此配置文件为 enable-php.conf 的增强版-- 开启 pathinfo 模式，流行的 php 框架都支持此模式

```verilog
location ~ [^/]\.php(/|$)
{
    #listen unix socket
    #fastcgi_pass  unix:/tmp/php-cgi.sock;
    #listen tcp socket
    fastcgi_pass  127.0.0.1:9000;
    fastcgi_index index.php;
    include fastcgi.conf;
    #pathinfo
    fastcgi_split_path_info ^(.+?\.php)(/.*)$;
    set $path_info $fastcgi_path_info;
    fastcgi_param PATH_INFO $path_info;
    try_files $fastcgi_script_name =404;
}
```

**fastcgi.conf**

这个配置文件其实是 nginx 自带的，我贴一下

```verilog
fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;
fastcgi_param  QUERY_STRING       $query_string;
fastcgi_param  REQUEST_METHOD     $request_method;
fastcgi_param  CONTENT_TYPE       $content_type;
fastcgi_param  CONTENT_LENGTH     $content_length;
fastcgi_param  SCRIPT_NAME        $fastcgi_script_name;
fastcgi_param  REQUEST_URI        $request_uri;
fastcgi_param  DOCUMENT_URI       $document_uri;
fastcgi_param  DOCUMENT_ROOT      $document_root;
fastcgi_param  SERVER_PROTOCOL    $server_protocol;
fastcgi_param  REQUEST_SCHEME     $scheme;
fastcgi_param  HTTPS              $https if_not_empty;
fastcgi_param  GATEWAY_INTERFACE  CGI/1.1;
fastcgi_param  SERVER_SOFTWARE    nginx/$nginx_version;
fastcgi_param  REMOTE_ADDR        $remote_addr;
fastcgi_param  REMOTE_PORT        $remote_port;
fastcgi_param  SERVER_ADDR        $server_addr;
fastcgi_param  SERVER_PORT        $server_port;
fastcgi_param  SERVER_NAME        $server_name;
# PHP only, required if PHP was built with --enable-force-cgi-redirect
fastcgi_param  REDIRECT_STATUS    200;
```

配置完成，注意因为所有的配置文件都是由 nginx.conf 这个主配置文件作为入口进行加载的，所以活动目录始终是在 nginx.conf 所在的目录，所以配置文件中的 include 的当前路径是 nginx.conf 所在的目录，配置完成后重启 nginx service 的同时记得重启 php-fpm 服务