Laravel网站迁移：带.php旧URL永久重定向至干净新URL方案咨询

嘿，这个需求我熟！之前帮公司做Laravel迁移的时候刚好处理过一模一样的场景，给你三个不同层面的实现方案，你根据自己的服务器环境和权限选就行：

方案1：Nginx 服务器层面配置（最推荐） #

如果你的项目部署在Nginx上，直接在站点配置里加这段规则就行——服务器层面处理效率最高，完全不用经过Laravel应用，对性能影响最小：

server {
    # 保留你原有的Nginx配置（比如监听端口、根目录、SSL配置等）

    # 处理带.php后缀的旧URL重定向
    location ~ ^/(.*)\.php$ {
        return 301 /$1;
    }

    # 保留Laravel默认的核心路由规则
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
}

注意：一定要把重定向规则放在Laravel的location /规则之前，不然会被Laravel的规则先拦截，导致重定向不生效。另外用301永久重定向对SEO更友好，搜索引擎会更新索引记录，用户后续搜索会直接指向新URL。

方案2：Apache 服务器层面配置 #

如果用的是Apache，直接在项目根目录的.htaccess文件里（或者虚拟主机配置）添加重定向规则：

RewriteEngine On

# 只重定向不存在的.php文件（避免误重定向真实存在的脚本）
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)\.php$ /$1 [R=301,L]

# 保留Laravel默认的.htaccess规则
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

解释：RewriteCond %{REQUEST_FILENAME} !-f是为了防止服务器上真的存在的.php文件被误重定向；[R=301,L]里的L表示这是最后一条匹配规则，执行后就停止后续规则的处理。

方案3：Laravel 路由层面处理（无服务器权限时用） #

如果没法修改服务器配置，也可以在Laravel应用内部处理，在routes/web.php里添加一个全局路由：

# 捕获所有带.php后缀的GET请求，重定向到无后缀的版本
Route::get('{path}.php', function ($path) {
    return redirect()->to('/' . $path, 301);
})->where('path', '.*');

这个路由会匹配任意以.php结尾的URL，比如/faq.php会重定向到/faq，/about/team.php会重定向到/about/team，而且会自动保留原URL的查询参数（比如/product.php?id=123会跳转到/product?id=123）。唯一的缺点是请求需要先进入Laravel应用，效率比服务器层面稍低，但胜在不用碰服务器配置。

小提醒 #

• 测试阶段可以先用302临时重定向（把代码里的301改成302），确认所有重定向都正常后再换回301，避免错误重定向被搜索引擎缓存。
• 如果有特殊的.php URL需要排除（比如某些遗留的接口），可以在规则里加条件跳过，比如Nginx里加if ($uri !~* "/special.php") { ... }，Apache里加RewriteCond %{REQUEST_URI} !^/special.php。

内容的提问来源于stack exchange，提问作者kangular