SiteHashService::__construct() - Code Metrics - Inspection of "[BUGFIX:BP:11.5] Fix frontend Solr connection init..." - TYPO3-Solr/ext-solr - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Pull Request — release-11.5.x (#3425)

by Markus
created 2022-12-16 15:03 UTC
SiteHashService::__construct() A

↳ Parent: SiteHashService
Complexity

Conditions	1
Paths	1
Size

Total Lines	3
Code Lines	1
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	0
CRAP Score	2
Importance

Changes
Metric	Value
eloc	1
dl	0
loc	3
ccs	0
cts	0
cp	0
rs	10
c	0
b	0
f	0
cc	1
nc	1
nop	1
crap	2
<?php

declare(strict_types=1);

/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */

namespace ApacheSolrForTypo3\Solr\Domain\Site;

use ApacheSolrForTypo3\Solr\System\Util\SiteUtility;
use Doctrine\DBAL\Driver\Exception as DBALDriverException;
use Throwable;
use TYPO3\CMS\Core\Exception\SiteNotFoundException;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Core\Site\SiteFinder;

/**
 * SiteHashService
 *
 * Responsible to provide sitehash related service methods.
 *
 * @author Timo Hund <[email protected]>
 */
class SiteHashService
{
    /**
     * SiteFinder
     */
    protected SiteFinder $siteFinder;

    public function __construct(SiteFinder $siteFinder)
    {
        $this->siteFinder = $siteFinder;
    }

    /**
     * Resolves magic keywords in allowed sites configuration.
     * Supported keywords:
     *   __solr_current_site - The domain of the site the query has been started from
     *   __current_site - Same as __solr_current_site
     *   __all - Adds all domains as allowed sites
     *   * - Means all sites are allowed, same as no siteHash
     *
     * @param int $pageId A page ID that is then resolved to the site it belongs to
     * @param string|null $allowedSitesConfiguration TypoScript setting for allowed sites
     * @return string List of allowed sites/domains, magic keywords resolved
     * @throws DBALDriverException
     * @throws Throwable
     */
    public function getAllowedSitesForPageIdAndAllowedSitesConfiguration(
        int $pageId,
        ?string $allowedSitesConfiguration = ''
    ): string {
        if ($allowedSitesConfiguration === '__all') {
            return $this->getDomainListOfAllSites();
        }
        if ($allowedSitesConfiguration === '*') {
            return '*';
        }
        // we thread empty allowed site configurations as __solr_current_site since this is the default behaviour
        $allowedSitesConfiguration = empty($allowedSitesConfiguration) ? '__solr_current_site' : $allowedSitesConfiguration;
        return $this->getDomainByPageIdAndReplaceMarkers($pageId, $allowedSitesConfiguration);
    }

    /**
     * Gets the site hash for a domain
     *
     * @param string $domain Domain to calculate the site hash for.
     * @return string site hash for $domain
     */
    public function getSiteHashForDomain(string $domain): string
    {
        static $siteHashes = [];
        if (isset($siteHashes[$domain])) {
            return $siteHashes[$domain];
        }

        $siteHashes[$domain] = sha1($domain . $GLOBALS['TYPO3_CONF_VARS']['SYS']['encryptionKey'] . 'tx_solr');
        return $siteHashes[$domain];
    }

    /**
     * Returns a comma separated list of all domains from all sites.
     *
     * @return string
     * @throws DBALDriverException
     * @throws Throwable
     */
    protected function getDomainListOfAllSites(): string
    {
        $sites = $this->siteFinder->getAllSites();
        $domains = [];
        foreach ($sites as $typo3Site) {
            $connections = SiteUtility::getAllSolrConnectionConfigurations($typo3Site);
            if (!empty($connections)) {
                $domains[] = $typo3Site->getBase()->getHost();
            }
        }

        return implode(',', $domains);
    }

    /**
     * Retrieves the domain of the site that belongs to the passed pageId and replaces their markers __solr_current_site
     * and __current_site.
     *
     * @param int $pageId
     * @param string $allowedSitesConfiguration
     * @return string
     */
    protected function getDomainByPageIdAndReplaceMarkers(int $pageId, string $allowedSitesConfiguration): string
    {
        try {
            $typo3Site = $this->siteFinder->getSiteByPageId($pageId);
            $domainOfPage = $typo3Site->getBase()->getHost();
        } catch (SiteNotFoundException $e) {
            return '';
        }

        $allowedSites = str_replace(['__solr_current_site', '__current_site'], $domainOfPage, $allowedSitesConfiguration);
        return (string)$allowedSites;
    }

    /**
     * @return Site[]
     * @throws DBALDriverException
     * @throws Throwable
     * @deprecated since v11.5 and will be removed in v11.6, SiteHashService no longer requires/uses Solr sites
     */
    protected function getAvailableSites(): array
    {
        trigger_error(
            'SiteHashService no longer requires/uses Solr sites ' . __METHOD__ . ' of class ' . __CLASS__ . ' is deprecated since v11.5 and will be removed in v11.6. Use SiteFinder instead or initizalize own objects',
            E_USER_DEPRECATED
        );

        return $this->getSiteRepository()->getAvailableSites();
        return /** @scrutinizer ignore-deprecated */ $this->getSiteRepository()->getAvailableSites();
    }

    /**
     * @param int $pageId
     * @return SiteInterface
     * @deprecated since v11.5 and will be removed in v11.6, SiteHashService no longer requires/uses Solr sites
     */
    protected function getSiteByPageId(int $pageId): SiteInterface
    {
        trigger_error(
            'SiteHashService no longer requires/uses Solr sites ' . __METHOD__ . ' of class ' . __CLASS__ . ' is deprecated since v11.5 and will be removed in v11.6. Use SiteFinder instead or initizalize own objects',
            E_USER_DEPRECATED
        );

        return $this->getSiteRepository()->getSiteByPageId($pageId);
        return /** @scrutinizer ignore-deprecated */ $this->getSiteRepository()->getSiteByPageId($pageId);
    }

    /**
     * Get a reference to SiteRepository
     *
     * @return SiteRepository
     * @deprecated since v11.5 and will be removed in v11.6, SiteHashService no longer requires/uses Solr sites
     */
    protected function getSiteRepository(): SiteRepository
    {
        trigger_error(
            'SiteHashService no longer requires/uses Solr sites ' . __METHOD__ . ' of class ' . __CLASS__ . ' is deprecated since v11.5 and will be removed in v11.6. Use SiteFinder instead or initizalize own objects',
            E_USER_DEPRECATED
        );

        return GeneralUtility::makeInstance(SiteRepository::class);
    }
}

TYPO3-Solr / ext-solr

Pull Request — release-11.5.x (#3425)

SiteHashService::__construct() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
