languagenormalizer.php

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

<?php
namespace Bitrix\Location\Entity\Address\Normalizer;
 
use Bitrix\Main\IO\File;
use Bitrix\Main\Localization;

class LanguageNormalizer implements INormalizer
{
    protected $letters = [];
    protected $aliases = [];
    protected $titles = [];

    public function __construct($lang = LANGUAGE_ID, array $langData = [])
    {
        if(empty($langData))
        {
            $langData = $this->loadLangData($lang);
        }
 
        $this->setLangData($langData);
    }

    public function normalize(string $string): string
    {
        $result = $string;
 
        if(is_array($this->letters) && !empty($this->letters))
        {
            $result = $this->replaceLetters($result, $this->letters);
        }
 
        if(is_array($this->aliases) && !empty($this->aliases))
        {
            $result = $this->replaceAliases($result, $this->aliases);
        }
 
        if(is_array($this->titles) && !empty($this->titles))
        {
            $result = $this->replaceTitles($result, $this->titles);
        }
 
        return $result;
    }

    protected function replaceLetters(string $string, array $letters): string
    {
        $result = $string;
 
        foreach($letters as $search => $replace)
        {
            $result = str_replace($search, $replace, $result);
        }
 
        return $result;
    }

    protected function replaceTitles(string $string, array $titles): string
    {
        $result = $string;
        $implodedTitles = implode('|', $titles);
        $regexp = '/^('.$implodedTitles.')+\s+(.*?)$/iu';
        $result = preg_replace($regexp, '$2', $result);
 
        if($result !== null)
        {
            $regexp = '/^(.*?)\s+(' . $implodedTitles . ')+$/iu';
            $result = preg_replace($regexp, '$1', $result);
        }
 
        return $result !== null ? $result : '';
    }

    protected function replaceAliases(string $string, array $aliases): string
    {
        return $aliases[$string] ?? $string;
    }

    protected function loadLangData(string $lang): array
    {
        $result = [];
 
        if(empty($result))
        {
            if ($langDataPath = $this->getLangDataFilePath($lang))
            {
                if (File::isFileExists($langDataPath))
                {
                    if (Localization\Translation::allowConvertEncoding())
                    {
                        if (class_exists('\Bitrix\Main\Localization\StreamConverter'))
                        {
                            $result = Localization\StreamConverter::include($langDataPath, $lang);
                        }
                        elseif (class_exists('\Bitrix\Main\Localization\SteamConverter'))
                        {
                            $result = Localization\SteamConverter::include($langDataPath, $lang);
                        }
                    }
                    else
                    {
                        $result = require $langDataPath;
                    }
                }
            }
        }
 
        return $result;
    }

    protected function getLangDataFilePath(string $lang): string
    {
        return $_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/location/lang/'.$lang.'/lib/entity/address/normalizer/langnormdata.php';
    }

    public function setLangData(array $langData): void
    {
        if(isset($langData['LETTERS']) && is_array($langData['LETTERS']))
        {
            $this->letters = $langData['LETTERS'];
        }
 
        if(isset($langData['ALIASES']) && is_array($langData['ALIASES']))
        {
            $this->aliases = $langData['ALIASES'];
        }
 
        if(isset($langData['TITLES']) && is_array($langData['TITLES']))
        {
            $this->titles = $langData['TITLES'];
        }
    }
}