extension.php

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

<?php
 
namespace Bitrix\Main\UI;
 
use Bitrix\Main\Application;
use Bitrix\Main\IO\File;
use Bitrix\Main\IO\Directory;
use Bitrix\Main\IO\Path;
 
class Extension
{
    public static function load($extNames)
    {
        if (!is_array($extNames))
        {
            $extNames = [$extNames];
        }
 
        foreach ($extNames as $extName)
        {
            if (static::register($extName))
            {
                \CJSCore::init($extName);
            }
        }
    }

    public static function register($extName)
    {
        if (!is_string($extName))
        {
            return false;
        }
 
        if (\CJSCore::isExtRegistered($extName))
        {
            return true;
        }
 
        if (preg_match('/[^a-z0-9_.-]/i', $extName))
        {
            return false;
        }
 
        $extension = static::getConfig($extName);
        if ($extension !== null)
        {
            static::registerAssets($extName, $extension);
 
            return true;
        }
 
        return false;
    }

    public static function registerAssets($id, array $options)
    {
        \CJSCore::registerExt($id, $options);
    }
 
    protected static function normalizeAssetPath($path, $extensionPath)
    {
        if (is_array($path))
        {
            $result = [];
            foreach ($path as $item)
            {
                $result[] = static::normalizeAssetPath($item, $extensionPath);
            }
 
            return $result;
        }
 
        if (is_string($path) && $path !== '')
        {
            if (Path::isAbsolute($path))
            {
                return $path;
            }
 
            return Path::combine($extensionPath, $path);
        }
 
        return $path;
    }

    public static function getConfig($extName)
    {
        static $cache = [];
 
        if (!is_string($extName))
        {
            return null;
        }
 
        if (isset($cache[$extName]) || array_key_exists($extName, $cache))
        {
            return $cache[$extName];
        }
 
        $extensionPath = static::getPath($extName);
        if ($extensionPath === null)
        {
            $cache[$extName] = null;
            return null;
        }
 
        $configFile = Application::getDocumentRoot() . $extensionPath . "/config.php";
        if (!File::isFileExists($configFile))
        {
            $cache[$extName] = null;
            return null;
        }
 
        $config = include($configFile);
 
        if (is_array($config))
        {
            if (isset($config['js']))
            {
                $config['js'] = static::normalizeAssetPath($config['js'], $extensionPath);
            }
 
            if (isset($config['css']))
            {
                $config['css'] = static::normalizeAssetPath($config['css'], $extensionPath);
            }
 
            $langDirectory = Application::getDocumentRoot() . $extensionPath . '/lang/';
 
            if (Directory::isDirectoryExists($langDirectory))
            {
                if (isset($config["lang"]))
                {
                    $config["lang"] = static::normalizeAssetPath($config["lang"], $extensionPath);
 
                    if (is_array($config["lang"]))
                    {
                        $config["lang"][] = $extensionPath . "/config.php";
                    }
                    else
                    {
                        $config["lang"] = [$config["lang"], $extensionPath . "/config.php"];
                    }
                }
                else
                {
                    $config["lang"] = $extensionPath . "/config.php";
                }
            }
 
            if (!isset($config['settings']) || !is_array($config['settings']))
            {
                $config['settings'] = [];
            }
        }
 
        $cache[$extName] = is_array($config) ? $config : null;
 
        return $cache[$extName];
    }

    public static function getBundleConfig($extName)
    {
        $extensionPath = static::getPath($extName);
 
        if ($extensionPath === null)
        {
            return null;
        }
 
        $configFilePath = Application::getDocumentRoot() . $extensionPath . "/bundle.config.js";
        $configFile = new File($configFilePath);
 
        if (!$configFile->isExists())
        {
            return null;
        }
 
        $namespace = '';
        $configContent = $configFile->getContents();
        if (is_string($configContent) && !empty($configContent))
        {
            preg_match('/namespace:(?:\s+)?[\'"](.*)[\'"]/', $configContent, $matches);
            if (!empty($matches) && !empty($matches[1]))
            {
                $namespace = $matches[1];
            }
        }
 
        return [
            'namespace' => $namespace,
        ];
    }
 
    private static function getPath($extName)
    {
        static $cache = [];
 
        if (!is_string($extName))
        {
            return null;
        }
 
        if (isset($cache[$extName]) || array_key_exists($extName, $cache))
        {
            return $cache[$extName];
        }
 
        $namespaces = explode(".", $extName);
        if (count($namespaces) < 2)
        {
            $cache[$extName] = null;
            return null;
        }
 
        $path = "js";
        foreach ($namespaces as $namespace)
        {
            if (!preg_match("/^[a-z0-9_.\-]+$/i", $namespace))
            {
                $cache[$extName] = null;
                return null;
            }
 
            $path .= "/" . $namespace;
        }
 
        $localPath = \getLocalPath($path);
 
        $cache[$extName] = is_string($localPath) && !empty($localPath) ? $localPath : null;
 
        return $cache[$extName];
    }

    public static function getHtml($extName)
    {
        $isRegistered = static::register($extName);
 
        if ($isRegistered)
        {
            return \CJSCore::getHTML($extName);
        }
 
        return null;
    }

    public static function getAssets($extName)
    {
        $assets = ['js' => [], 'css' => []];
 
        if (is_array($extName))
        {
            foreach ($extName as $name)
            {
                $currentAssets = static::getAssets($name);
                $assets['js'] = array_merge($assets['js'], $currentAssets['js']);
                $assets['css'] = array_merge($assets['css'], $currentAssets['css']);
            }
 
            return $assets;
        }
 
        if (is_string($extName))
        {
            $config = static::getConfig($extName);
 
            if (empty($config))
            {
                $config = \CJSCore::getExtInfo($extName);
            }
 
            if (isset($config['rel']))
            {
                $relAssets = static::getAssets($config['rel']);
                $assets['js'] = array_merge($assets['js'], $relAssets['js']);
                $assets['css'] = array_merge($assets['css'], $relAssets['css']);
            }
 
            if (isset($config['js']))
            {
                if (is_array($config['js']))
                {
                    $assets['js'] = array_merge($assets['js'], $config['js']);
                }
 
                if (is_string($config['js']) && $config['js'] !== '')
                {
                    $assets['js'][] = $config['js'];
                }
            }
 
            if (isset($config['css']))
            {
                if (is_array($config['css']))
                {
                    $assets['css'] = array_merge($assets['css'], $config['css']);
                }
 
                if (is_string($config['css']) && $config['css'] !== '')
                {
                    $assets['css'][] = $config['css'];
                }
            }
 
            if (isset($config['post_rel']))
            {
                $relAssets = static::getAssets($config['post_rel']);
                $assets['js'] = array_merge($assets['js'], $relAssets['js']);
                $assets['css'] = array_merge($assets['css'], $relAssets['css']);
            }
        }
 
        $assets['js'] = array_unique($assets['js']);
        $assets['css'] = array_unique($assets['css']);
 
        return $assets;
    }

    public static function getDependencyList($extName)
    {
        return self::getDependencyListRecursive($extName);
    }

    public static function getResourceList($extName, $option = [])
    {
        $skipCoreJS = isset($option['skip_core_js']) && $option['skip_core_js'] === true;
        $withDependency = !(isset($option['with_dependency']) && $option['with_dependency'] === false);
        $skipExtensions = $option['skip_extensions'] ?? [];
        $getResolvedExtensionList = isset($option['get_resolved_extension_list']) && $option['get_resolved_extension_list'] === true;
 
        \CJSCore::init();
 
        $alreadyResolved = $skipExtensions;
        if ($skipCoreJS)
        {
            $alreadyResolved[] = 'core';
        }
 
        $extensions = [];
        $extNameList = is_array($extName) ? $extName : [$extName];
        if ($withDependency)
        {
            foreach ($extNameList as $extName)
            {
                if (in_array($extName, $alreadyResolved))
                {
                    continue;
                }
 
                self::getDependencyListRecursive($extName, true, true, $extensions, $alreadyResolved);
            }
        }
        else
        {
            foreach ($extNameList as $extName)
            {
                if (in_array($extName, $alreadyResolved))
                {
                    continue;
                }
                else
                {
                    $alreadyResolved[] = $extName;
                }
 
                $extensions[] = [$extName, self::getConfig($extName)];
            }
        }
 
        foreach ($extensions as $index => $extension)
        {
            if (isset($extension[1]['oninit']) && is_callable($extension[1]['oninit']))
            {
                $callbackResult = call_user_func_array(
                    $extension[1]['oninit'],
                    [$extension[1]]
                );
 
                if (is_array($callbackResult))
                {
                    foreach ($callbackResult as $option => $value)
                    {
                        if (!is_array($value))
                        {
                            $value = [$value];
                        }
 
                        if (!isset($extension[1][$option]))
                        {
                            $extension[1][$option] = [];
                        }
                        elseif (!is_array($extension[1][$option]))
                        {
                            $extension[1][$option] = [$extension[1][$option]];
                        }
 
                        $extensions[$index][1][$option] = array_merge($extension[1][$option], $value);
                    }
                }
 
                unset($extensions[$index][1]['oninit']);
            }
        }
 
        $result = [
            'js' => [],
            'css' => [],
            'lang' => [],
            'lang_additional' => [],
            'layout' => [],
            'options' => [],
            'settings' => [],
        ];
 
        if ($getResolvedExtensionList)
        {
            $result['resolved_extension'] = array_diff($alreadyResolved, $skipExtensions);
        }
 
        $options = array_keys($result);
        foreach ($extensions as $extension)
        {
            $extensionName = $extension[0];
            $config = $extension[1];
 
            foreach ($options as $option)
            {
                if (is_array($config) && array_key_exists($option, $config))
                {
                    if ($option === 'settings' && is_array($config[$option]) && !empty($config[$option]))
                    {
                        $result[$option][$extensionName] = $config[$option];
                    }
                    else
                    {
                        if (is_array($config[$option]))
                        {
                            $result[$option] = array_merge($result[$option], $config[$option]);
                        }
                        else
                        {
                            $result[$option][] = $config[$option];
                        }
                    }
                }
            }
        }
 
        return $result;
    }

    private static function getDependencyListRecursive($name, $storeConfig = false, $storeSelf = false, &$resultList = [], &$alreadyResolved = [])
    {
        $config = self::getConfig($name);
        if ($config === null)
        {
            $namespaces = explode(".", $name);
            if (count($namespaces) == 1)
            {
                $config = self::getCoreConfigForDependencyList($name, $storeConfig, $resultList, $alreadyResolved);
            }
            else
            {
                $alreadyResolved[] = $name;
            }
        }
        else
        {
            $alreadyResolved[] = $name;
        }
 
        if ($config && !empty($config['rel']))
        {
            foreach ($config['rel'] as $dependencyName)
            {
                if (!in_array($dependencyName, $alreadyResolved))
                {
                    self::getDependencyListRecursive($dependencyName, $storeConfig, true, $resultList, $alreadyResolved);
                }
            }
        }
 
        if ($storeSelf)
        {
            if ($storeConfig)
            {
                $resultList[] = [$name, $config];
            }
            else
            {
                $resultList[] = $name;
            }
        }
 
        if ($config && !empty($config['post_rel']))
        {
            foreach ($config['post_rel'] as $dependencyName)
            {
                if (!in_array($dependencyName, $alreadyResolved))
                {
                    self::getDependencyListRecursive($dependencyName, $storeConfig, true, $resultList, $alreadyResolved);
                }
            }
        }
 
        if (
            $storeConfig
            && ($config && !empty($config['rel']) || $storeSelf)
        )
        {
            $uniqueArray = [];
            foreach ($resultList as $element)
            {
                $uniqueArray[$element[0]] = $element;
            }
            $resultList = array_values($uniqueArray);
        }
        else
        {
            $resultList = array_unique($resultList);
        }
 
        return $resultList;
    }
 
    private static function getCoreConfigForDependencyList($name, $storeConfig = false, &$resultList = [], &$alreadyResolved = [])
    {
        $alreadyResolved[] = $name;
 
        $config = \CJSCore::getExtInfo($name);
        if ($config)
        {
            if (!$config['skip_core'] && !in_array('core', $alreadyResolved))
            {
                $coreConfig = \CJSCore::GetCoreConfig();
                if ($storeConfig)
                {
                    array_unshift($resultList, ['core', $coreConfig]);
                }
                else
                {
                    array_unshift($resultList, 'core');
                }
 
                $alreadyResolved[] = 'core';
            }
        }
        else
        {
            $config = null;
        }
 
        return $config;
    }
}