providerbase.php

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

<?php
 
namespace Bitrix\Rest\Configuration\DataProvider;
 
use Bitrix\Main\Web\Json;
use Bitrix\Rest\Configuration\Helper;
use Bitrix\Main\ArgumentException;
use Bitrix\Main\SystemException;

abstract class ProviderBase
{
    public const ERROR_DECODE_DATA = 'ERROR_DECODE_DATA';
    public const ERROR_DATA_NOT_FOUND = 'ERROR_DATA_NOT_FOUND';
    private $errorList = [];
    private $contextUser;
    private $context;

    public function __construct(array $setting)
    {
        if (!empty($setting['CONTEXT']))
        {
            $this->context = $setting['CONTEXT'];
        }
 
        if (!empty($setting['CONTEXT_USER']))
        {
            $this->contextUser = $setting['CONTEXT_USER'];
        }
    }

    protected function getContext()
    {
        return $this->context ?? Helper::getInstance()->getContextAction();
    }

    protected function getUserContext()
    {
        return $this->contextUser ?? Helper::getInstance()->getContextUser('');
    }

    abstract public function addContent(string $code, $content, $type = false): bool;

    abstract public function addFiles(array $files): array;

    abstract public function get(string $path, int $step): ?array;

    public function getContent(string $path, int $step): array
    {
        $result = [
            'DATA' => null,
            '~DATA' => null,
            'FILE_NAME' => null,
            'SANITIZE' => false,
            'COUNT' => 0,
        ];
 
        try
        {
            $content = $this->get($path, $step);
            if (!is_null($content['DATA']))
            {
                $result['~DATA'] = Json::decode($content['DATA']);
                if (!empty($result['~DATA']))
                {
                    $result['DATA'] = Helper::getInstance()->sanitize($result['~DATA'], $result['SANITIZE']);
                }
            }
            else
            {
                $result['ERROR_CODE'] = self::ERROR_DATA_NOT_FOUND;
            }
 
            if ($content['FILE_NAME'])
            {
                $result['FILE_NAME'] = preg_replace(
                    '/(' . Helper::CONFIGURATION_FILE_EXTENSION . ')$/i',
                    '',
                    $content['FILE_NAME']
                );
            }
 
            if (!empty($content['COUNT']) && (int)$content['COUNT'] > 0)
            {
                $result['COUNT'] = (int)$content['COUNT'];
            }
        }
        catch (ArgumentException $exception)
        {
            $result['ERROR_CODE'] = self::ERROR_DECODE_DATA;
        }
        catch (SystemException $exception)
        {
            $result['ERROR_CODE'] = self::ERROR_DATA_NOT_FOUND;
        }
 
        return $result;
    }

    protected function packageContent($content): ?string
    {
        $result = null;
        if (is_array($content))
        {
            try
            {
                $result = Json::encode($content);
            }
            catch (ArgumentException $e)
            {
                $result = null;
                $this->addError('ERROR_JSON_ENCODE', '');
 
            }
        }
        elseif (is_string($content))
        {
            $result = $content;
        }
 
        return $result;
    }

    protected function addError($code, $message): bool
    {
        $this->errorList[$code] = $message;
 
        return true;
    }

    public function listError(): array
    {
        return $this->errorList;
    }

    public function resetErrors(): bool
    {
        $this->errorList = [];
 
        return true;
    }
}