Nginx和Apache实现隐藏去除index.php的功能

---

一、前言

为什么要去除index.php呢，因为去除index.php可以使得url看上去优雅不少，同时对seo静态化有一定的好处。本文就主要针对于nginx和apache两种常见的web服务进行配置讲解。

---

二、 Nginx配置隐藏index.php

2.1 综合配置

本文以一个·后端ThinkPHP的项目，前端是Vue打包项目为例，演示一下配置，重写主要使用到rewrite模块。核心语句是rewrite ^/index.php(.*)$ /index.php?s=$1 last; ewrite ^(.*)$ /index.php?s=$1 last;，综合配置如下。

server {
    listen 80;
    server_name www.xxxxxx.com;
    root /usr/share/nginx/html/demo;
    
    index index.html index.htm index.php;
    
    location ^~ /Public {
        root /var/www/app;
        break;
    }
    
    location / {
        if (!-e $request_filename) {
            rewrite ^/index.php(.*)$ /index.php?s=$1 last;
            rewrite ^(.*)$ /index.php?s=$1 last;
            break;
        }
    }
 
    location ~ \.php$ {
        root /var/www/app;
        fastcgi_pass 127.0.0.1:9000;#php-fpm的默认端口是9000
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

}

2.2 配置解释

对上面代码的解释如下：

1. listen 80 表示用80端口启动服务
2. server_name www.xxxxxx.com 配置虚拟域名，当用这个域名访问时。会生效这一段配置。
3. root /usr/share/nginx/html/demo 是前端项目打包后的目录，里面含有这些内容。这是默认的项目根目录。
   
4. location ^~ /Public 中Public是PHP代码里面的公共目录，里面含有一些静态资源和上传文件，这里的意思是说当访问路径中带有Public关键字的时候，表示是访问后端资源，项目根目录要切换到/var/www/app。
5. 接下来location / 表示匹配其他所有的路由，if (!-e $request_filename) 表示没有找到对应的文件的时候的捕获方案。使用rewrite来加上index.php来处理这个请求。实际上是为了走到项目index.php里面。
   
6. 最后location ~ \.php$ 表示当路径匹配到.php的请求时候的处理方案，使用/var/www/app作为项目根目录，fastcgi_pass 127.0.0.1:9000 表示与fpm进程进行通信交互。
7. 另外如果前后端项目遇到跨域问题，可以调整为如下配置。

location ~ \.php$ {
    root /var/www/app;
    # 加上下面三行
    add_header Access-Control-Allow-Origin *;
    add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS';
    add_header Access-Control-Allow-Headers 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization';
    fastcgi_pass 127.0.0.1:9000;#php-fpm的默认端口是9000
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

最后别忘了nginx -s reload。

三、Apache配置隐藏index.php

3.1 配置apache2.conf

本部分内容以Ubuntu上面Apache2为例进行演示，配置方式有很多中，这里展示一种常见的，经过我测试完全通过的方式。
首先编辑apache2.conf，vim /etc/apache2/apache2.conf。在根节点的配置下加入如下内容。假如项目根目录是/var/www/app。

<Directory /var/www/app>
    AllowOverride all
</Directory>

3.2 配置项目.htaccess文件

切换到项目目录/var/www/app中，创建一个名为.htaccess的文件。放入如下内容。如果apache没有开起rewrite模块，可以尝试通过命令a2enmod rewrite开启。

<IfModule mod_rewrite.c>
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]

3.3 配置解释

AllowOverride all表示允许项目通过.htaccess来自由控制重写，这样项目里面放置一个这个文件，会被apache进行自动解析。配置完成后别忘了service apache2 restart 重启服务。

---

四、总结

以上就是今天要讲的内容，Nginx和Apache实现隐藏去除index.php的功能，后续将分享更多相关知识，喜欢点赞关注吧。