Verschiedene Domains innerhalb der gleichen Site in TYPO3 nutzen

Auf verschiedenen Quellen habe ich bereits desöfteren die Antwort gelesen, dass man nicht mehrere Domains für einen Bereich in TYPO3 benötigt. Über eine Environment-Variable könne man schließlich verschiedene Domains vergeben, wenn man beispielsweise lokal entwickeln möchte oder eine Testumgebung hat.

Umgebungsvariablen

Dies geht relativ einfach, in dem man diese Variable in der SiteConfiguration wieder aufgreifen kann:

base: 'https://%env(HOST_MAIN)%/'
rootPageId: 1
websiteTitle: 'My website'
imports:
  - resource: 'EXT:sitepackage/Configuration/Routes/DefaultSiteConfiguration.yaml'

In der Apache Konfiguration kann diese Variable dann ganz einfach gesetzt werden mit:

SetEnv HOST_MAIN development.domain.org

Alternativ lässt sich dies aber auch in einer .env Datei leicht definieren (hier empfiehlt sich dann der Einsatz von helhum/dotenv-connector):

HOST_MAIN=development.domain.org

BaseVariants mit eigener Condition

Nun kann es aber auch Fälle geben, bei denen man innerhalb der gleichen TYPO3-Instanz (z.B. Production) mehrere Domains für den gleichen Seitenbaum-Abschnitt zulassen muss. Dies trifft beispielsweise auf Bereiche im Intranet zu. In einem anderen Fall möchte ein Versicherungskunde von uns jedoch, dass man über zwei verschiedene Domains in einen Bereich kommt. Je nach Domain ist der Inhalt dann leicht unterschiedlich (Die Umsetzung dazu zeigen wir hier jedoch nicht, um das Beispiel nicht zu verkomplizieren).

Mit Hilfe von BaseVariants in der SiteConfiguration kann man dies ermöglichen. Einzige Herausforderung: Eine Condition, die an Hand der aktuellen Domain umschaltet, gibt es noch nicht in TYPO3. Hier müssen wir etwas nachhelfen.

Nehmen wir an, wir haben nun zwei verschiedene Domains in der .env-Datei defniert:

HOST_MAIN=domain1.org
HOST_ALTERNATIVE=domain2.org

Dann könnte die SiteConfiguration eventuell so aussehen:

base: 'https://%env(HOST_MAIN)%/'
baseVariants:
  - base: 'https://%env(HOST_ALTERNATIVE)%/'
    condition: 'isAlternativeDomain("%env(HOST_ALTERNATIVE)%")'
rootPageId: 1
websiteTitle: 'My website'
imports:
  - resource: 'EXT:sitepackage/Configuration/Routes/DefaultSiteConfiguration.yaml'

Problem ist jedoch, dass es die Condition isAlternativeDomain() noch nicht gibt, und das müssen wir beispielsweise in unserem sitepackage nachholen. EXT:sitepackage/Configuration/ExpressionLanguage.php:

<?php
return [
    'site' => [
        \Vendor\Sitepackage\Condition\SiteConditionProvider::class
    ]
];

Der Provider hierzu in EXT:sitepackage/Classes/Condition/SiteConditionProvider.php:

<?php

declare(strict_types = 1);

namespace Vendor\Sitepackage\Condition;

use Vendor\Sitepackage\Condition\FunctionsProvider\SiteConditionFunctionsProvider;
use TYPO3\CMS\Core\ExpressionLanguage\AbstractProvider;

/**
 * SiteConditionProvider
 */
class SiteConditionProvider extends AbstractProvider
{
    /**
     * Constructor
     */
    public function __construct()
    {
        $this->expressionLanguageProviders = [
            SiteConditionFunctionsProvider::class,
        ];
    }
}

Und als letztes noch der FunctionsProvider in EXT:sitepackage/Classes/Condition/FunctionsProvider/SiteConditionFunctionsProvider.php:

<?php
declare(strict_types=1);
namespace Vendor\Sitepackage\Condition\FunctionsProvider;

use Symfony\Component\ExpressionLanguage\ExpressionFunction;
use Symfony\Component\ExpressionLanguage\ExpressionFunctionProviderInterface;
use TYPO3\CMS\Core\Utility\GeneralUtility;

/**
 * SiteConditionFunctionsProvider
 */
class SiteConditionFunctionsProvider implements ExpressionFunctionProviderInterface
{
    /**
     * @return array|ExpressionFunction[]
     */
    public function getFunctions()
    {
        return [
            $this->isAlternativeDomain(),
        ];
    }

    /**
     * Site configuration: Can be used to decide if a baseVariant should be loaded
     *
     * Example:
     *  baseVariants:
     *    - base: 'https://%env(HOST_MAKLERNETZ)%/'
     *      condition: 'isAlternativeDomain("%env(HOST_MAKLERNETZ)%")'
     *
     * @return ExpressionFunction
     */
    protected function isAlternativeDomain(): ExpressionFunction
    {
        return new ExpressionFunction('isAlternativeDomain', function () {
            // Not implemented, we only use the evaluator
        }, function (array $existingVariables, string $alternativeDomain) {
            return GeneralUtility::getIndpEnv('HTTP_HOST') == $alternativeDomain;
        });
    }
}

Das ist dann im Prinzip schon alles. Der gleiche Bereich im Seitenbaum lässt sich nun über die Domains domain1.org und domain2.org aufrufen.