*/ namespace Yasumi; use Yasumi\Exception\UnknownLocaleException; class Translations implements TranslationsInterface { /** * @var array> translations array: ['' => ['' => 'translation', ...], ... ] */ public array $translations = []; /** * Constructor. * * @param array $availableLocales list of all defined locales */ public function __construct(private array $availableLocales) { $this->availableLocales = $availableLocales; } /** * Loads translations from directory. * * @param string $directoryPath directory path for translation files * * @throws UnknownLocaleException * @throws \InvalidArgumentException */ public function loadTranslations(string $directoryPath): void { if (! file_exists($directoryPath)) { throw new \InvalidArgumentException('Directory with translations not found'); } $directoryPath = rtrim($directoryPath, '/\\').\DIRECTORY_SEPARATOR; $extension = 'php'; foreach (new \DirectoryIterator($directoryPath) as $file) { if ($file->isDot()) { continue; } if ($file->isDir()) { continue; } if ($file->getExtension() !== $extension) { continue; } $filename = $file->getFilename(); $key = $file->getBasename('.'.$extension); $translations = require $directoryPath.$filename; if (\is_array($translations)) { foreach (array_keys($translations) as $locale) { $this->checkLocale((string) $locale); } $this->translations[$key] = $translations; } } } /** * Adds translation for holiday in specific locale. * * @param string $key holiday key * @param string $locale locale * @param string $translation translation * * @throws UnknownLocaleException */ public function addTranslation(string $key, string $locale, string $translation): void { $this->checkLocale($locale); $this->translations[$key][$locale] = $translation; } /** * Returns translation for holiday in specific locale. * * @param string $key holiday key * @param string $locale locale * * @return string|null translated holiday name */ public function getTranslation(string $key, string $locale): ?string { return $this->translations[$key][$locale] ?? null; } /** * Returns all available translations for holiday. * * @param string $key holiday key * * @return array holiday name translations ['' => '', ...] */ public function getTranslations(string $key): array { return $this->translations[$key] ?? []; } private function checkLocale(string $locale): void { if (! \in_array($locale, $this->availableLocales, true)) { throw new UnknownLocaleException(sprintf('Locale "%s" is not a valid locale.', $locale)); } } }