translation.php

См. документацию.

<?php
namespace Bitrix\Main\Localization;
 
use Bitrix\Main;
use Bitrix\Main\IO\Path;
use Bitrix\Main\Config\Configuration;
 
class Translation
{
    private static $allowConvertEncoding = null;
    private static $useTranslationRepository = null;
    private static $translationRepositoryPath = null;
    private static $currentEncoding = null;
    private static $needConvertEncoding = array();
    private static $map = array();
 
    const CACHE_ID = 'TranslationLoadMapCache';
    const CACHE_TTL = 3600;

    public static function isDefaultTranslationLang($lang)
    {
        return
            ($lang === 'ru') ||
            ($lang === 'en') ||
            ($lang === 'de') ||
            ($lang === 'kz');
    }

    public static function getDefaultTranslationEncoding($lang)
    {
        return 'utf-8';
    }
 

    public static function getSourceEncoding($lang)
    {
        $encoding = 'utf-8';
        if (self::useTranslationRepository() || self::allowConvertEncoding())
        {
            if (self::isDefaultTranslationLang($lang))
            {
                $encoding = self::getDefaultTranslationEncoding($lang);
            }
        }
 
        if (empty($encoding))
        {
            $culture = Main\Localization\CultureTable::getRow(array('filter' => array('=CODE' => $lang)));
            if ($culture)
            {
                $encoding = $culture['CHARSET'];
            }
        }
 
        if (empty($encoding))
        {
            $encoding = self::getCurrentEncoding();
        }
 
        return $encoding;
    }
 

    public static function setCurrentEncoding($encoding)
    {
        self::$currentEncoding = $encoding;
    }

    public static function getCurrentEncoding()
    {
        if (self::$currentEncoding === null)
        {
            self::$currentEncoding = 'utf-8';
        }
 
        return self::$currentEncoding;
    }

    public static function needConvertEncoding($language, $targetEncoding = null)
    {
        if (!isset(self::$needConvertEncoding[$language]) || self::$needConvertEncoding[$language] === null)
        {
            self::$needConvertEncoding[$language] = false;
 
            if (self::allowConvertEncoding())
            {
                if ($targetEncoding === null)
                {
                    $targetEncoding = self::getCurrentEncoding();
                }
                $sourceEncoding = self::getSourceEncoding($language);
                self::$needConvertEncoding[$language] = ($targetEncoding != $sourceEncoding);
            }
        }
 
        return self::$needConvertEncoding[$language];
    }
 

    public static function checkPathRestrictionConvertEncoding($langFile)
    {
        $needConvert = false;
        if (self::allowConvertEncoding())
        {
            if (self::getDeveloperRepositoryPath() !== null)
            {
                $needConvert = (stripos($langFile, self::getDeveloperRepositoryPath()) === 0);
            }
            if (!$needConvert && self::useTranslationRepository())
            {
                $needConvert = (stripos($langFile, self::getTranslationRepositoryPath()) === 0);
            }
        }
 
        return $needConvert;
    }

    public static function useTranslationRepository()
    {
        if (self::$useTranslationRepository === null)
        {
            self::$useTranslationRepository = false;
 
            if(self::getTranslationRepositoryPath() !== null)
            {
                self::$useTranslationRepository = true;
            }
        }
 
        return self::$useTranslationRepository;
    }

    public static function getTranslationRepositoryPath()
    {
        if(self::$translationRepositoryPath === null)
        {
            $config = Configuration::getValue('translation');
 
            if ($config !== null && !empty($config['translation_repository']))
            {
                $translationRepositoryPath = realpath($config['translation_repository']);
                if (file_exists($translationRepositoryPath))
                {
                    self::$translationRepositoryPath = Path::normalize($translationRepositoryPath);
                }
            }
        }
 
        return self::$translationRepositoryPath;
    }

    public static function allowConvertEncoding()
    {
        if(self::$allowConvertEncoding === null)
        {
            self::$allowConvertEncoding = false;
 
            $config = Configuration::getValue('translation');
 
            if ($config !== null && !empty($config['convert_encoding']))
            {
                self::$allowConvertEncoding = ($config['convert_encoding'] === true);
            }
        }
 
        return self::$allowConvertEncoding;
    }

    public static function getDeveloperRepositoryPath()
    {
        static $developerRepositoryPath, $wasChecked;
        if($wasChecked === null)
        {
            $wasChecked = true;
            $config = Configuration::getValue('translation');
 
            if ($config !== null && !empty($config['developer_repository']))
            {
                $developerRepositoryPath = realpath($config['developer_repository']);
                if (file_exists($developerRepositoryPath))
                {
                    $developerRepositoryPath = Path::normalize($developerRepositoryPath);
                }
            }
        }
 
        return $developerRepositoryPath;
    }

    public static function convertLangPath($langFile, $language)
    {
        if (empty($language) || !(self::useTranslationRepository() || self::getDeveloperRepositoryPath() !== null))
        {
            return $langFile;
        }
 
        static $documentRoot;
        if ($documentRoot === null)
        {
            $documentRoot = Path::normalize(Main\Application::getDocumentRoot());
        }
 
        if (self::useTranslationRepository() && !self::isDefaultTranslationLang($language))
        {
            $modulePath = self::getTranslationRepositoryPath().'/'.$language.'/';
        }
        elseif (self::getDeveloperRepositoryPath() !== null)
        {
            $modulePath = self::getDeveloperRepositoryPath(). '/';
        }
        elseif (self::isDefaultTranslationLang($language))
        {
            $modulePath = $documentRoot. '/bitrix/modules/';
        }
        else
        {
            return $langFile;
        }
 
        if (str_contains($langFile, '\\'))
        {
            $langFile = str_replace('\\', '/', $langFile);
        }
        if (str_contains($langFile, '//'))
        {
            $langFile = str_replace('//', '/', $langFile);
        }
 
        // linked
        if (self::getDeveloperRepositoryPath() !== null)
        {
            if (mb_strpos($langFile, self::getDeveloperRepositoryPath()) === 0)
            {
                $langFile = str_replace(
                    self::getDeveloperRepositoryPath(). '/',
                    $modulePath,
                    $langFile
                );
 
                return $langFile;
            }
        }
 
        // module lang
        if (str_starts_with($langFile, $documentRoot . '/bitrix/modules/'))
        {
            $langFile = str_replace(
                $documentRoot.'/bitrix/modules/',
                $modulePath,
                $langFile
            );
 
            return $langFile;
        }
 
        self::loadMap();
 
        $langPathParts = preg_split('#[/]+#', trim(str_replace($documentRoot, '', $langFile), '/'), 6);
        if (
            empty($langPathParts)
            || $langPathParts[0] !== 'bitrix'
            || empty($langPathParts[1])
            || empty($langPathParts[2])
            || empty($langPathParts[3])
        )
        {
            return $langFile;
        }
 
        $testEntry = $langPathParts[1];
        switch ($testEntry)
        {
            // bitrix/mobileapp/[moduleName] -> [moduleName]/install/mobileapp/[moduleName]
            case 'mobileapp':
                $moduleName = $langPathParts[2];
                if (isset(self::$map[$moduleName][$testEntry], self::$map[$moduleName][$testEntry][$moduleName]))
                {
                    $testEntry = 'mobileapp/'. $moduleName;
                    $langFile = str_replace(
                        $documentRoot.'/bitrix/mobileapp/'. $moduleName. '/',
                        $modulePath.''.$moduleName.'/install/mobileapp/'. $moduleName. '/',
                        $langFile
                    );
                }
                break;
 
            // bitrix/templates/[templateName] -> [moduleName]/install/templates/[templateName]
            case 'templates':
                $templateName = $langPathParts[2];
                foreach (self::$map as $moduleName => $moduleEntries)
                {
                    if (isset(self::$map[$moduleName][$testEntry], self::$map[$moduleName][$testEntry][$templateName]))
                    {
                        $langFile = str_replace(
                            $documentRoot.'/bitrix/templates/'.$templateName.'/',
                            $modulePath.''.$moduleName.'/install/templates/'. $templateName .'/',
                            $langFile
                        );
                        break;
                    }
                }
                break;
 
            // bitrix/components/bitrix/[componentName] -> [moduleName]/install/components/bitrix/[componentName]
            // bitrix/activities/bitrix/[activityName] -> [moduleName]/install/activities/bitrix/[activityName]
            // bitrix/wizards/bitrix/[wizardsName] -> [moduleName]/install/wizards/bitrix/[wizardsName]
            // bitrix/gadgets/bitrix/[gadgetName] -> [moduleName]/install/gadgets/bitrix/[gadgetName]
            case 'components':
            case 'activities':
            case 'wizards':
            case 'gadgets':
            case 'blocks':
                if ($langPathParts[2] !== 'bitrix')
                {
                    break;
                }
                $searchEntryName = $langPathParts[3];
                foreach (self::$map as $moduleName => $moduleEntries)
                {
                    if (isset(self::$map[$moduleName][$testEntry], self::$map[$moduleName][$testEntry][$searchEntryName]))
                    {
                        $langFile = str_replace(
                            $documentRoot.'/bitrix/'.$testEntry.'/bitrix/'.$searchEntryName.'/',
                            $modulePath.''.$moduleName.'/install/'.$testEntry.'/bitrix/'. $searchEntryName. '/',
                            $langFile
                        );
                        break;
                    }
                }
                break;
 
            // bitrix/js/[moduleName]/[smth] -> [moduleName]/install/js/[moduleName]/[smth]
            // bitrix/js/[moduleName]/[smth] -> [moduleName]/install/public/js/[moduleName]/[smth]
            case 'js':
                $libraryNamespace = $langPathParts[2]. '/'. $langPathParts[3];
 
                foreach (self::$map as $moduleName => $moduleEntries)
                {
                    if (isset(self::$map[$moduleName][$testEntry], self::$map[$moduleName][$testEntry][$libraryNamespace]))
                    {
                        $langFile = str_replace(
                            $documentRoot.'/bitrix/'.$testEntry.'/'.$libraryNamespace.'/',
                            $modulePath.''.$moduleName.'/install/'.$testEntry.'/'.$libraryNamespace.'/',
                            $langFile
                        );
                        break;
                    }
                    if (isset(self::$map[$moduleName]["public/{$testEntry}"], self::$map[$moduleName]["public/{$testEntry}"][$libraryNamespace]))
                    {
                        $langFile = str_replace(
                            $documentRoot.'/bitrix/'.$testEntry.'/'.$libraryNamespace.'/',
                            $modulePath.''.$moduleName.'/install/public/'.$testEntry.'/'.$libraryNamespace.'/',
                            $langFile
                        );
                        break;
                    }
                }
                break;
 
            // bitrix/[moduleName]/payment/[paymentHandler] -> [moduleName]/payment/[paymentHandler]
            case 'payment':
                $searchEntryName = $langPathParts[3];
                foreach (self::$map as $moduleName => $moduleEntries)
                {
                    if (isset(self::$map[$moduleName][$testEntry], self::$map[$moduleName][$testEntry][$searchEntryName]))
                    {
                        $langFile = str_replace(
                            $documentRoot.'/bitrix/modules/'.$moduleName.'/'.$testEntry.'/',
                            $modulePath.''.$moduleName.'/'.$testEntry.'/',
                            $langFile
                        );
                        break;
                    }
                }
                break;
        }
 
        return $langFile;
    }
 

    public static function loadMap()
    {
        if (empty(self::$map))
        {
            $cacheManager = Main\Application::getInstance()->getManagedCache();
            if ($cacheManager->read(static::CACHE_TTL, static::CACHE_ID))
            {
                self::$map = $cacheManager->get(static::CACHE_ID);
            }
        }
 
        if (empty(self::$map))
        {
            $testForExistence = array(
                'templates',
                'components',
                'activities',
                'wizards',
                'gadgets',
                'js',
                'public/js',
                'blocks',
                'payment',
                'mobileapp',
            );
            $bxRoot = Main\Application::getDocumentRoot(). '/bitrix/modules/';
            $modulesList = new Main\IO\Directory($bxRoot);
            foreach ($modulesList->getChildren() as $moduleDirectory)
            {
                if ($moduleDirectory->isDirectory())
                {
                    $moduleName = $moduleDirectory->getName();
                    if (!str_contains($moduleName, '.') || str_starts_with($moduleName, 'bitrix.'))
                    {
                        self::$map[$moduleName] = array();
                        foreach ($testForExistence as $testEntry)
                        {
                            $testPath = $bxRoot. '/'. $moduleName. '/install/'. $testEntry;
                            if ($testEntry === 'templates' || $testEntry === 'mobileapp')
                            {
                                $testPath .= '/';
                            }
                            elseif ($testEntry === 'js' || $testEntry === 'public/js')
                            {
                                $testPath .= '/'. $moduleName. '/';
                            }
                            elseif ($testEntry === 'payment')
                            {
                                $testPath = $bxRoot. '/'. $moduleName. '/'. $testEntry;
                            }
                            else
                            {
                                $testPath .= '/bitrix/';
                            }
 
                            $testDirectory = new Main\IO\Directory($testPath);
                            if ($testDirectory->isExists())
                            {
                                self::$map[$moduleName][$testEntry] = array();
                                foreach ($testDirectory->getChildren() as $testDirectoryEntry)
                                {
                                    if ($testDirectoryEntry->isDirectory())
                                    {
                                        if ($testEntry === 'js' || $testEntry === 'public/js')
                                        {
                                            self::$map[$moduleName][$testEntry][$moduleName.'/'.$testDirectoryEntry->getName()] = 1;
                                        }
                                        else
                                        {
                                            self::$map[$moduleName][$testEntry][$testDirectoryEntry->getName()] = 1;
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
 
            $cacheManager->set(static::CACHE_ID, static::$map);
        }
 
        return self::$map;
    }

    public static function getEncodings($language, $langFile)
    {
        static $encodingCache = array();
 
        if(isset($encodingCache[$language]))
        {
            list($convertEncoding, $targetEncoding, $sourceEncoding) = $encodingCache[$language];
        }
        else
        {
            $convertEncoding = self::needConvertEncoding($language);
            $targetEncoding = $sourceEncoding = '';
            if($convertEncoding)
            {
                $targetEncoding = self::getCurrentEncoding();
                $sourceEncoding = self::getSourceEncoding($language);
            }
 
            $encodingCache[$language] = array($convertEncoding, $targetEncoding, $sourceEncoding);
        }
 
        if($convertEncoding)
        {
            $convertEncoding = self::checkPathRestrictionConvertEncoding($langFile);
        }
 
        return array($convertEncoding, $targetEncoding, $sourceEncoding);
    }
}