gilour

Back Back Up Advanced Editor

<?php

declare(strict_types=1);

namespace Jfcherng\Diff\Utility;

final class Language
{
    /**
     * @var string[] the translation dict
     */
    private array $translations = [];

/**
     * @var string the language name
     */
    private string $language = '_custom_';

/**
     * The constructor.
     *
     * @param string|string[] $target the language string or translations dict
     */
    public function __construct($target = 'eng')
    {
        $this->setLanguageOrTranslations($target);
    }

/**
     * Set up this class.
     *
     * @param string|string[] $target the language string or translations array
     *
     * @throws \InvalidArgumentException
     */
    public function setLanguageOrTranslations($target): self
    {
        if (\is_string($target)) {
            $this->setUpWithLanguage($target);

return $this;
        }

if (\is_array($target)) {
            $this->setUpWithTranslations($target);

return $this;
        }

throw new \InvalidArgumentException('$target must be the type of string|string[]');
    }

/**
     * Get the language.
     *
     * @return string the language
     */
    public function getLanguage(): string
    {
        return $this->language;
    }

/**
     * Get the translations.
     *
     * @return array the translations
     */
    public function getTranslations(): array
    {
        return $this->translations;
    }

/**
     * Get the translations from the language file.
     *
     * @param string $language the language
     *
     * @throws \Exception        fail to decode the JSON file
     * @throws \LogicException   path is a directory
     * @throws \RuntimeException path cannot be opened
     *
     * @return string[]
     */
    public static function getTranslationsByLanguage(string $language): array
    {
        $filePath = __DIR__ . "/../languages/{$language}.json";
        $file = new \SplFileObject($filePath, 'r');
        $fileContent = $file->fread($file->getSize());

try {
            $decoded = json_decode($fileContent, true, 512, \JSON_THROW_ON_ERROR);
        } catch (\JsonException $e) {
            throw new \Exception(sprintf('Fail to decode JSON file (%s): %s', realpath($filePath), (string) $e));
        }

return (array) $decoded;
    }

/**
     * Translation the text.
     *
     * @param string $text the text
     */
    public function translate(string $text): string
    {
        return $this->translations[$text] ?? "![{$text}]";
    }

/**
     * Set up this class by language name.
     *
     * @param string $language the language name
     */
    private function setUpWithLanguage(string $language): self
    {
        return $this->setUpWithTranslations(
            self::getTranslationsByLanguage($language),
            $language,
        );
    }

/**
     * Set up this class by translations.
     *
     * @param string[] $translations the translations dict
     * @param string   $language     the language name
     */
    private function setUpWithTranslations(array $translations, string $language = '_custom_'): self
    {
        $this->language = $language;
        $this->translations = array_map('strval', $translations);

return $this;
    }
}