locale = $locale; if (class_exists('\MessageFormatter')) { $this->intlSupport = true; }; } //-------------------------------------------------------------------- /** * Parses the language string for a file, loads the file, if necessary, * getting * * @param string $line * @param array $args * * @return string */ public function getLine(string $line, array $args = []): string { // Parse out the file name and the actual alias. // Will load the language file and strings. list($file, $line) = $this->parseLine($line); $output = isset($this->language[$file][$line]) ? $this->language[$file][$line] : $line; // Do advanced message formatting here // if the 'intl' extension is available. if ($this->intlSupport && count($args)) { $output = \MessageFormatter::formatMessage($this->locale, $output, $args); } return $output; } //-------------------------------------------------------------------- /** * Parses the language string which should include the * filename as the first segment (separated by period). * * @param string $line * * @return string */ protected function parseLine(string $line): array { if (strpos($line, '.') === false) { throw new \InvalidArgumentException('No language file specified in line: '.$line); } $file = substr($line, 0, strpos($line, '.')); $line = substr($line, strlen($file)+1); if (! array_key_exists($line, $this->language)) { $this->load($file, $this->locale); } return [ $file, $this->language[$line] ?? $line ]; } //-------------------------------------------------------------------- /** * Loads a language file in the current locale. If $return is true, * will return the file's contents, otherwise will merge with * the existing language lines. * * @param string $file * @param string $locale * @param bool $return * * @return array|null */ protected function load(string $file, string $locale, bool $return = false) { if (in_array($file, $this->loadedFiles)) { return []; } if (! array_key_exists($file, $this->language)) { $this->language[$file] = []; } $path = "Language/{$locale}/{$file}.php"; $lang = $this->requireFile($path); // Don't load it more than once. $this->loadedFiles[] = $file; if ($return) { return $lang; } // Merge our string $this->language[$file] = $lang; } //-------------------------------------------------------------------- /** * A simple method for including files that can be * overridden during testing. * * @todo - should look into loading from other locations, also probably... * * @param string $path * * @return array */ protected function requireFile(string $path): array { $files = service('locator')->search($path); foreach ($files as $file) { if (! is_file($file)) { continue; } return require_once $file; } return []; } //-------------------------------------------------------------------- }