nginx 隐藏 index.php 和开启 pathinfo 模式的配置

2021-10-22 09:18:21

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 配置

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

vhost/default.conf

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

注意：

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

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

enable-php.conf

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

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

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

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

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 模式

enable-php-pathinfo.conf

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

  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 自带的，我贴一下

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 服务

码农公寓

http 配置

server 配置

配置 php

配置 pathinfo 模式

相关文章