Translator.php

<?php

class Translator
{
    /**
     * @var string[]
     */

    private $config;


    private $translations = null;
    /**
     * @var InvisibleWrapper
     */
    private $encoder;

    /**
     * Constructor
     *
     * @param array $config Configuration array with the following keys:
     *                     - apiUrl: Base URL for the Tolgee API
     *                     - projectId: Tolgee project ID
     *                     - language: Language code to fetch translations for
     *                     - apiKey: Tolgee API key for authentication
     */
    public function __construct($config = [])
    {
        // Set default configuration values
        $this->config = array_merge([
            'apiUrl' => 'https://app.tolgee.io',
            'language' => 'en',
            'apiKey' => '',
            'mode' => 'development'
        ], $config);

        // Initialize the encoder
        $this->encoder = new InvisibleWrapper();
    }

    /**
     * Fetch translations from Tolgee API
     *
     * @return array Translations array or empty array on failure
     */
    private function fetchTranslations()
    {
        // If no project ID or API key is provided, return empty array
        if (empty($this->config['apiKey'])) {
            error_log('Tolgee Translator: Missing projectId or apiKey in configuration');
            return [];
        }

        $url = rtrim($this->config['apiUrl'], '/') .
            '/v2/projects/' .
            'translations/' .
            $this->config['language'];

        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'X-API-Key: ' . $this->config['apiKey'],
            'Accept: application/json'
        ]);

        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        if ($httpCode !== 200) {
            throw new \RuntimeException('Tolgee Translator: API request failed with status code '
                . $httpCode .
                '. Response: '
                . $response
            );
        }

        $data = json_decode($response, true);
        if (!$data) {
            error_log('Tolgee Translator: Invalid API response format');
            return [];
        }

        // The response format is expected to be:
        // {"en":{"what a key":"Translated value","another key":"Another key translated"}}
        if (isset($data[$this->config['language']])) {
            return $data[$this->config['language']];
        }

        error_log('Tolgee Translator: Language not found in response');
        return [];
    }

    /**
     * Translate a key with optional parameters
     *
     * @param string $keyName The key to translate
     * @param array $params Optional parameters to replace placeholders in the translation
     * @return string The translated string or the key if not found
     */
    public function translate($keyName, $params = [])
    {
        // Lazy load translations on first use
        if ($this->translations === null) {
            $this->translations = $this->fetchTranslations();
        }

        // Check if the key exists in the translations
        if (!isset($this->translations[$keyName])) {
            return $keyName; // Return the key itself if not found
        }

        $translation = $this->translations[$keyName];

        // Replace parameters in the translation
        foreach ($params as $param => $value) {
            $translation = str_replace('{' . $param . '}', $value, $translation);
        }

        if ($this->config['mode'] == 'development') {
            $translation = $this->encoder->wrapWithFullKeyEncode($keyName, null, $translation);
        }

        return $translation;
    }
}