helper.php

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

<?php
namespace Bitrix\Iblock\Template;
class Helper
{
    public static function splitTemplate($template)
    {
        if (preg_match("/\\/(l|t.?)+\$/", $template, $match))
        {
            return array(mb_substr($template, 0, -mb_strlen($match[0])), mb_substr($match[0], 1));
        }
        else
        {
            return array($template, "");
        }
    }

    public static function splitModifiers($modifiers)
    {
        if (preg_match_all("/(l|t.?)/", $modifiers, $match))
            return $match[0];
        else
            return array();
    }

    public static function convertArrayToModifiers(array $template)
    {
        $TEMPLATE = $template["TEMPLATE"] ?? '';
        $modifiers = "";
        if (isset($template["LOWER"]) && $template["LOWER"] === "Y")
        {
            $modifiers .= "l";
        }
        if (isset($template["TRANSLIT"]) && $template["TRANSLIT"] === "Y")
        {
            $modifiers .= "t";
            if (isset($template["SPACE"]) && is_string($template["SPACE"]) && $template["SPACE"] !== "")
            {
                $modifiers .= $template["SPACE"];
            }
        }
        if ($modifiers !== "")
        {
            $modifiers = "/" . $modifiers;
        }
 
        return $TEMPLATE.$modifiers;
    }

    public static function convertModifiersToArray(array $template = null)
    {
        if ($template === null)
        {
            $template = array(
                "TEMPLATE" => "",
            );
        }
 
        $TEMPLATE = $template["TEMPLATE"];
        $LOWER = "N";
        $TRANSLIT = "N";
        $SPACE = "";
 
        [$TEMPLATE, $modifiers] = self::splitTemplate($TEMPLATE);
        foreach(self::splitModifiers($modifiers) as $mod)
        {
            if ($mod == "l")
            {
                $LOWER = "Y";
            }
            else
            {
                $TRANSLIT = "Y";
                $SPACE = mb_substr($mod, 1);
            }
        }
 
        $template["TEMPLATE"] = $TEMPLATE;
        $template["LOWER"] = $LOWER;
        $template["TRANSLIT"] = $TRANSLIT;
        $template["SPACE"] = $SPACE;
 
        return $template;
    }

    public static function makeFileName(
        \Bitrix\Iblock\InheritedProperty\BaseTemplate $ipropTemplates,
        string $templateName,
        array $fields,
        array $file
    ): string
    {
        if (!isset($file['name']))
        {
            return '';
        }
 
        if (preg_match("/^(.+)(\\.[a-zA-Z0-9]+)\$/", $file["name"], $fileName))
        {
            if (!isset($fields["IPROPERTY_TEMPLATES"]) || (string)($fields["IPROPERTY_TEMPLATES"][$templateName] ?? '') === '')
            {
                $templates = $ipropTemplates->findTemplates();
                $TEMPLATE = ($templates[$templateName]["TEMPLATE"] ?? '');
            }
            else
            {
                $TEMPLATE = $fields["IPROPERTY_TEMPLATES"][$templateName];
            }
 
            if ($TEMPLATE != "")
            {
                [$template, $modifiers] = Helper::splitTemplate($TEMPLATE);
                if ($template != "")
                {
                    $values = $ipropTemplates->getValuesEntity();
                    $entity = $values->createTemplateEntity();
                    $entity->setFields($fields);
                    return \Bitrix\Iblock\Template\Engine::process($entity, $TEMPLATE).$fileName[2];
                }
                elseif ($modifiers != "")
                {
                    $simpleTemplate = new NodeRoot;
                    $simpleTemplate->addChild(new NodeText($fileName[1]));
                    $simpleTemplate->setModifiers($modifiers);
                    $baseEntity = new Entity\Base(0);
                    return $simpleTemplate->process($baseEntity).$fileName[2];
                }
            }
        }
 
        return $file["name"];
    }
}