bitrix-module/intaro.retailcrm/RetailcrmClasspathBuilder.php

<?php

/**
 * Class RetailcrmClasspathBuilder.
 * Builds classpath for Bitrix autoloader. Contains some hardcoded things, which will go away when everything refactored.
 */
class RetailcrmClasspathBuilder
{
    /**
     * File extension as a string. Defaults to ".php".
     * @var string
     */
    protected $fileExt = 'php';

    /**
     * @var string $moduleId
     */
    protected $moduleId = 'intaro.retailcrm';

    /**
     * The topmost directory where recursion should begin. Default: `classes/general`. Relative to the __DIR__.
     * @var string
     */
    protected $path = 'classes/general';

    /**
     * Do not include directory paths as namespaces.
     * @var bool
     */
    protected $disableNamespaces;

    /**
     * Bitrix document root
     * @var string
     */
    protected $documentRoot;

    /**
     * @var string
     */
    protected $version;

    /**
     * @var array $result
     */
    protected $result = [];

    /**
     * @var array $notIncluded
     */
    protected $notIncluded = [];

    /**
     * These classes can be customized, in which case they would be replaced with files from
     * directory <root>/bitrix/php_interface/retailcrm
     *
     * Array format:
     * [
     *      'class path with namespace' => 'file name'
     * ]
     */
    protected static $customizableClasses = [
        'RestNormalizer' => 'RestNormalizer.php',
        'Logger' => 'Logger.php',
        'RetailCrm\ApiClient' => 'ApiClient_v5.php',
        'RetailCrm\Http\Client' => 'Client.php',
        'RCrmActions' => 'RCrmActions.php',
        'RetailCrmUser' => 'RetailCrmUser.php',
        'RetailCrmICML' => 'RetailCrmICML.php',
        'RetailCrmInventories' => 'RetailCrmInventories.php',
        'RetailCrmPrices' => 'RetailCrmPrices.php',
        'RetailCrmCollector' => 'RetailCrmCollector.php',
        'RetailCrmUa' => 'RetailCrmUa.php',
        'RetailCrmEvent' => 'RetailCrmEvent.php',
        'RetailCrmCorporateClient' => 'RetailCrmCorporateClient.php'
    ];

    /**
     * These classes can be customized, in which case they would be replaced with files from
     * directory <root>/bitrix/php_interface/retailcrm
     * Customized versions have fixed name, and original versions name depends on API version
     *
     * Array format:
     * [
     *      'class path with namespace' => ['customized file name', 'original file name with %s for API version']
     * ]
     */
    protected static $versionedClasses = [
        'RetailCrm\ApiClient' => ['ApiClient.php', 'ApiClient_%s.php'],
        'RetailCrmOrder' => ['RetailCrmOrder.php', 'RetailCrmOrder_%s.php'],
        'RetailCrmHistory' => ['RetailCrmHistory.php', 'RetailCrmHistory_%s.php']
    ];

    /**
     * These classes will be ignored while loading from original files
     */
    protected static $ignoredClasses = [
        'ApiClient_v4.php',
        'ApiClient_v5.php',
        'RetailCrmOrder_v4.php',
        'RetailCrmOrder_v5.php',
        'RetailCrmHistory_v4.php',
        'RetailCrmHistory_v5.php',
    ];

    /**
     * These namespaces are hardcoded.
     */
    protected static $hardcodedNamespaces = [
        'RetailCrm\Response\ApiResponse' => 'ApiResponse.php',
        'RetailCrm\Exception\InvalidJsonException' => 'InvalidJsonException.php',
        'RetailCrm\Exception\CurlException' => 'CurlException.php'
    ];

    protected function buildCustomizableClasspath()
    {
        foreach (static::$customizableClasses as $className => $fileName) {
            $customizedFile = $this->documentRoot . '/bitrix/php_interface/retailcrm/' . $fileName;

            if (file_exists($customizedFile)) {
                $this->result[$className] = $customizedFile;
            } else {
                $this->notIncluded[$className] = $fileName;
            }
        }
    }

    protected function buildVersionedClasspath()
    {
        foreach (static::$versionedClasses as $className => $fileNames) {
            $customizedFile = $this->documentRoot . '/bitrix/php_interface/retailcrm/' . $fileNames[0];

            if (file_exists($customizedFile)) {
                $this->result[$className] = $customizedFile;
            } else {
                $this->notIncluded[$className] = sprintf($fileNames[1], $this->version);
            }
        }
    }

    /**
     * Traverse through directories, build include paths
     * @return $this
     */
    public function build(): self
    {
        $directory = new RecursiveDirectoryIterator(
            $this->getSearchPath(),
            RecursiveDirectoryIterator::SKIP_DOTS
        );
        $fileIterator = new RecursiveIteratorIterator($directory, RecursiveIteratorIterator::LEAVES_ONLY);

        $this->buildCustomizableClasspath();
        $this->buildVersionedClasspath();
        $notIncludedClasses = array_flip($this->notIncluded);
        $hardcodedNamespaces = array_flip(static::$hardcodedNamespaces);

        /** @var \SplFileObject $file */
        foreach ($fileIterator as $file) {
            $fileNameWithoutExt = str_ireplace('.' . $this->fileExt, '', $file->getFilename());

            if ($file->getExtension() !== $this->fileExt) {
                continue;
            }

            if (in_array($file->getFilename(), static::$customizableClasses)
                || in_array($file->getFilename(), static::$ignoredClasses)
            ) {
                if (in_array($file->getFilename(), $this->notIncluded)) {
                    $this->result[$notIncludedClasses[$file->getFilename()]] = $this->getImportPath($file->getPathname());
                }

                continue;
            }

            if (in_array($file->getFilename(), static::$hardcodedNamespaces)) {
                $this->result[$hardcodedNamespaces[$file->getFilename()]] = $this->getImportPath($file->getPathname());
            } else {
                $this->result[$this->getImportClass($fileNameWithoutExt, $file->getPath())] = $this->getImportPath($file->getPathname());
            }
        }

        return $this;
    }

    /**
     * Sets the $fileExt property
     *
     * @param string $fileExt The file extension used for class files.  Default is "php".
     *
     * @return \RetailcrmClasspathBuilder
     */
    public function setFileExt($fileExt)
    {
        $this->fileExt = $fileExt;
        return $this;
    }

    /**
     * @param string $documentRoot
     *
     * @return RetailcrmClasspathBuilder
     */
    public function setDocumentRoot(string $documentRoot): RetailcrmClasspathBuilder
    {
        $this->documentRoot = $documentRoot;
        return $this;
    }

    /**
     * Sets the $path property
     *
     * @param string $path Top path to load files
     *
     * @return \RetailcrmClasspathBuilder
     */
    public function setPath(string $path)
    {
        $this->path = $path;
        return $this;
    }

    /**
     * @param mixed $disableNamespaces
     *
     * @return RetailcrmClasspathBuilder
     */
    public function setDisableNamespaces($disableNamespaces)
    {
        $this->disableNamespaces = $disableNamespaces;
        return $this;
    }

    /**
     * @param string $moduleId
     *
     * @return RetailcrmClasspathBuilder
     */
    public function setModuleId(string $moduleId): RetailcrmClasspathBuilder
    {
        $this->moduleId = $moduleId;
        return $this;
    }

    /**
     * @param string $version
     *
     * @return RetailcrmClasspathBuilder
     */
    public function setVersion(string $version): RetailcrmClasspathBuilder
    {
        $this->version = $version;
        return $this;
    }

    /**
     * @return array
     */
    public function getResult(): array
    {
        return $this->result;
    }

    /**
     * @return string
     */
    protected function getSearchPath(): string
    {
        return __DIR__ . DIRECTORY_SEPARATOR . $this->path;
    }

    /**
     * @param string $filePath
     *
     * @return string
     */
    protected function getImportPath(string $filePath): string
    {
        return (string) str_ireplace(implode(DIRECTORY_SEPARATOR, [
            $this->documentRoot,
            'bitrix',
            'modules',
            $this->moduleId
        ]) . DIRECTORY_SEPARATOR, '', $filePath);
    }

    /**
     * @param string $fileNameWithoutExt
     * @param string $filePath
     *
     * @return string
     */
    protected function getImportClass(string $fileNameWithoutExt, string $filePath): string
    {
        if ($this->disableNamespaces) {
            return $fileNameWithoutExt;
        }

        $importClass = str_ireplace($this->getSearchPath(),  '', $filePath). '\\' . $fileNameWithoutExt;

        if (strlen($importClass) > 0 && $importClass[0] === '/') {
            $importClass = '\\' . substr($importClass, 1);
        }

        return (string) str_replace(DIRECTORY_SEPARATOR, '\\', $importClass);
    }
}