Laravel中创建类似RankMath的站点地图 路由失效求解决方案

先明确 RankMath 典型站点地图结构 #

RankMath 的站点地图分为两类核心结构：

• 主索引地图：sitemap_index.xml（汇总所有子站点地图的入口）
• 分类子地图：比如 post-sitemap.xml（文章地图）、page-sitemap.xml（页面地图），当内容过多时会生成分页版本，如 post-sitemap1.xml、post-sitemap2.xml

之前路由尝试的问题 #

• Try1 的 /(*).xml 不符合 Laravel 路由语法，框架不识别这种通配符写法
• Try2 的 {slug}.xml 会无差别匹配所有 .xml 结尾的请求，容易和静态资源、其他路由冲突，也无法区分主索引和子地图的结构

正确路由配置方案 #

按优先级从高到低配置路由，确保主索引先被匹配，再处理子地图：

// 主索引站点地图路由
Route::get('sitemap_index.xml', 'SitemapController@index');

// 匹配带分页的子站点地图（如 post-sitemap1.xml）
Route::get('{type}-sitemap{page}.xml', 'SitemapController@show')
    ->where('page', '[0-9]+');

// 匹配不带分页的子站点地图（如 post-sitemap.xml）
Route::get('{type}-sitemap.xml', 'SitemapController@show');

或者合并成一个带可选参数的路由，简化配置：

Route::get('sitemap_index.xml', 'SitemapController@index');

Route::get('{type}-sitemap{page?}.xml', 'SitemapController@show')
    ->where([
        'page' => '[0-9]*' // 允许页码为空或数字
    ]);

控制器处理逻辑示例 #

在 SitemapController 中生成对应 XML 并设置正确响应头：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Response;

class SitemapController extends Controller
{
    // 主索引站点地图
    public function index()
    {
        // 动态生成主索引XML，示例仅为基础结构
        $xml = '<?xml version="1.0" encoding="UTF-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
    <sitemap>
        <loc>'.url('post-sitemap.xml').'</loc>
    </sitemap>
    <sitemap>
        <loc>'.url('page-sitemap.xml').'</loc>
    </sitemap>
</sitemapindex>';

        return response($xml)->header('Content-Type', 'application/xml');
    }

    // 子站点地图（支持分页）
    public function show($type, $page = 1)
    {
        // 根据$type（如post、page）和$page动态生成对应内容
        // 示例仅为基础结构，实际需从数据库获取数据
        $xml = '<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
    <url>
        <loc>'.url('/post/1').'</loc>
        <lastmod>2024-05-20T12:00:00+00:00</lastmod>
        <changefreq>daily</changefreq>
        <priority>0.8</priority>
    </url>
</urlset>';

        return response($xml)->header('Content-Type', 'application/xml');
    }
}

注意事项 #

1. 路由顺序很重要：主索引路由必须放在最前面，避免被子地图路由错误匹配
2. 必须设置响应头为 application/xml，否则浏览器无法正确识别站点地图格式
3. 实际开发中，XML内容需根据数据库数据动态生成，不要硬编码示例内容

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