Thinktomorrow\Locale\Detect

Complexity

Total Complexity

10

Size/Duplication

Total Lines	97
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Test Coverage

Coverage

100%

Importance

Changes

0

6 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	5	1
A	detectLocale()	0	22	2
A	getLocale()	0	6	2
A	getScope()	0	6	2
A	setScope()	0	6	2
A	detectScope()	0	4	1

<?php

namespace Thinktomorrow\Locale;

use Illuminate\Http\Request;
use Thinktomorrow\Locale\Detectors\FallbackDetector;
use Thinktomorrow\Locale\Detectors\HiddenSegmentDetector;
use Thinktomorrow\Locale\Detectors\QueryDetector;
use Thinktomorrow\Locale\Detectors\SegmentDetector;
use Thinktomorrow\Locale\Values\Config;
use Thinktomorrow\Locale\Values\Locale;

final class Detect
{

    /**
     * @var Request
     */
    private $request;

    /**
     * @var Config
     */
    private $config;

    /**
     * @var Locale
     */
    private $locale;

    /**
     * Current scope of locales
     * @var Scope
     */
    private $scope;

    public function __construct(Request $request, Config $config)

You have injected the Request via parameter $request. This is generally not recommended as there might be multiple instances during a request cycle (f.e. when using sub-requests). Instead, it is recommended to inject the RequestStack and retrieve the current request each time you need it via getCurrentRequest().

    {
        $this->request = $request;
        $this->config = $config;
    }

    /**
     * Detect the locale from current request url.
     * Once the locale has been determined, it will be set as the application locale.
     * A locale is only validated if it is present within the current locale scope.
     *
     * Detection honours following priority:
     * 1) If locale is found in request as query parameter e.g. ?locale=fr,
     * 2) If locale is found in request url, either from host or segment eg. nl.example.com, example.nl or example.com/nl
     * 3) Otherwise set locale to our fallback language (app.locale)
     */
    public function detectLocale(): self
    {
        $locale = null;

        $detectors = [
            FallbackDetector::class,
            HiddenSegmentDetector::class,
            SegmentDetector::class,
            QueryDetector::class,
        ];

        foreach($detectors as $detector)
        {
            $locale = app($detector)->get($this->getScope(), $this->config) ?? $locale;
        }

        $this->locale = $locale;

        app()->setLocale($locale->get());

        return $this;
    }

    public function getLocale(): Locale
    {
        if( ! $this->locale ) $this->detectLocale();

        return $this->locale;
    }

    public function getScope(): Scope
    {
        if( ! $this->scope ) $this->detectScope();

        return $this->scope;
    }

    /**
     * This is handy for setting allowed scope via other source than config file.
     * TODO: we should allow to set config from other source such as db as well so
     * this can be configurable from a cms.
     *
     * @param Scope|null $scope
     * @return $this
     */
    public function setScope(Scope $scope = null)
    {
        if($scope) $this->scope = $scope;

        return $this;
    }

    private function detectScope()
    {
        $this->scope = ScopeCollection::fromConfig($this->config)->findByRoot($this->request->root());
    }
}