TYPO3 v9及以上版本如何实现Canonical标签沿根线继承？

针对核心SEO扩展缺失全站继承canonical标签的问题，可通过自定义扩展实现类似旧版EXT:yoast的全站继承逻辑，同时添加布尔开关按需启用，具体方案如下：

方案一：利用事件监听（推荐TYPO3 v10+） #

通过监听TYPO3核心SEO的ModifyUrlForCanonicalTagEvent事件，在生成canonical标签时注入继承逻辑：

1. 注册事件监听器 #

在自定义扩展的ext_localconf.php中添加：

$GLOBALS['TYPO3_CONF_VARS']['SYS']['Objects']['TYPO3\\CMS\\Seo\\Event\\ModifyUrlForCanonicalTagEvent'] = [
    'className' => 'Vendor\\YourExtension\\EventListener\\CanonicalInheritListener',
];

2. 编写监听器类 #

创建Classes/EventListener/CanonicalInheritListener.php：

<?php
namespace Vendor\YourExtension\EventListener;

use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController;
use TYPO3\CMS\Seo\Event\ModifyUrlForCanonicalTagEvent;

class CanonicalInheritListener
{
    public function __invoke(ModifyUrlForCanonicalTagEvent $event): void
    {
        $tsfe = GeneralUtility::makeInstance(TypoScriptFrontendController::class);
        $pageTsConfig = $tsfe->getPageTSconfig();
        
        // 读取TSconfig中的开关和目标URL
        $inheritEnabled = (bool)($pageTsConfig['tx_seo.']['custom_canonical_inherit'] ?? false);
        $targetCanonicalUrl = $pageTsConfig['tx_seo.']['custom_canonical_url'] ?? '';

        // 仅当启用继承、有目标URL且当前页面无单独设置canonical时生效
        if ($inheritEnabled && !empty($targetCanonicalUrl) && empty($event->getUrl())) {
            $currentUri = $event->getRequest()->getUri();
            $siteBase = $event->getSiteLanguage()->getBase()->__toString();
            // 替换当前站点base为目标URL，生成对应页面的canonical
            $newCanonical = str_replace($siteBase, rtrim($targetCanonicalUrl, '/') . '/', $currentUri->__toString());
            $event->setUrl($newCanonical);
        }
    }
}

方案二：Xclass覆盖核心类（适配TYPO3 v9） #

对于TYPO3 v9，由于核心尚未引入事件机制，可通过Xclass覆盖CanonicalGenerator类实现逻辑：

1. 注册Xclass #

在自定义扩展的ext_localconf.php中添加：

$GLOBALS['TYPO3_CONF_VARS']['SYS']['Objects']['TYPO3\\CMS\\Seo\\Canonicalization\\CanonicalGenerator'] = [
    'className' => 'Vendor\\YourExtension\\Xclass\\CustomCanonicalGenerator',
];

2. 编写自定义CanonicalGenerator类 #

创建Classes/Xclass/CustomCanonicalGenerator.php：

<?php
namespace Vendor\YourExtension\Xclass;

use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController;
use TYPO3\CMS\Seo\Canonicalization\CanonicalGenerator as OriginalGenerator;

class CustomCanonicalGenerator extends OriginalGenerator
{
    public function generate(\TYPO3\CMS\Core\Site\Entity\SiteLanguage $siteLanguage): ?string
    {
        $tsfe = GeneralUtility::makeInstance(TypoScriptFrontendController::class);
        $pageTsConfig = $tsfe->getPageTSconfig();
        
        $inheritEnabled = (bool)($pageTsConfig['tx_seo.']['custom_canonical_inherit'] ?? false);
        $targetCanonicalUrl = $pageTsConfig['tx_seo.']['custom_canonical_url'] ?? '';

        // 检查当前页面是否有单独设置canonical
        $currentPageCanonical = $tsfe->page['canonical_link'] ?? null;
        if ($inheritEnabled && !empty($targetCanonicalUrl) && empty($currentPageCanonical)) {
            $currentUri = $this->request->getUri();
            $siteBase = $siteLanguage->getBase()->__toString();
            $newCanonical = str_replace($siteBase, rtrim($targetCanonicalUrl, '/') . '/', $currentUri->__toString());
            return $newCanonical;
        }

        // 无继承需求时调用原逻辑
        return parent::generate($siteLanguage);
    }
}

使用方法 #

1. 安装并激活自定义扩展后，在根页面的TSconfig中添加配置：

   tx_seo.custom_canonical_inherit = 1
   tx_seo.custom_canonical_url = https://your-original-domain.com/
   

2. 若某页面需单独设置canonical，直接在页面的SEO选项中填写即可，会自动覆盖继承的URL。
3. 如需临时关闭全站继承，将tx_seo.custom_canonical_inherit设为0即可。

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