README

安装

安装此扩展的首选方法是使用 composer。

运行以下命令之一：

php composer.phar require mrssoft/yii2-sitemap "^2.0"

或者将以下内容添加到你的 composer.json 文件的 require 部分：

"mrssoft/yii2-sitemap": "^2.0"

用法

创建控制器 SitemapController.php

<?php

namespace app\controllers;

use \mrssoft\sitemap\Sitemap;

class SitemapController extends \mrssoft\sitemap\SitemapController
{
    /**
     * @var int Cache duration, set null to disabled
     */
    protected $cacheDuration = 43200; // default 12 hour

    /**
     * @var string Cache filename
     */
    protected $cacheFilename = 'sitemap.xml';
    
    protected $enablePriority = false;

    protected $enableChangeFreq = false;    

    public function models(): array
    {
        return [
            [
                'class' => \app\models\Page::class,
                'change' => Sitemap::MONTHLY,
                'priority' => 0.8,
                'lastmod' => 'updated_at',
            ]
        ];
    }

    public function urls(): array
    {
        return [
            [
                'url' => ['about/index'],
                'priority' => 0.8
            ]
        ];
    }
}

将接口 \mrssoft\sitemap\SitemapInterface 添加到你的模型接口中

<?php
namespace app\models;

class Page extends \yii\db\ActiveRecord implements \mrssoft\sitemap\SitemapInterface
{
    ...
    
    /**
     * @return \yii\db\ActiveQuery
     */        
    public static function sitemap(): \yii\db\ActiveQuery
    {
        return self::find()->where(['public' => 1]);
    }

    /**
     * @return string
     */
    public function getSitemapUrl(): string
    {
        return \yii\helpers\Url::toRoute(['page/view', 'url' => $this->url], true);
    }    
}

添加到配置的 URL 规则中。

'components' => [
    'urlManager' => [
        'rules' => [
            ...
            [
                'pattern' => 'sitemap', 
                'route' => 'sitemap/index', 
                'suffix' => '.xml'
            ],
            ...
        ]
    ],