[news] Debug extension 2.1.17 released


Протокол обмена 1С с сайтом Bitrix для Yii2

  1. Серверная часть
  2. Клиентская часть

В библиотеке реализована серверная часть протокола для обработки запросов от 1С, а также клиентская часть, которая
эмулирует запросы 1С к серверу сайта.
Серверная часть Состоит из:

  • настраиваемого модуля dicr\exchange1c\Module
  • web-контроллера dicr\exchane1c\DefaultController для обработки запросов от 1С
  • абстрактного обработчика протокола dicr\exchange1c\BaseHandler который реализует базовые функции.

Настройка серверной части $config = [
'modules' => [
'exchange1c' => dicr\exchange1c\Module::class,
'handler' => 'ВашОбработчикИмпорта::class',

// опционально можно добавить авторизацию
'as basicAuth' => [
'class' => yii\filters\auth\HttpBasicAuth::class,
'auth' => static function($username, $password) {
// проверка логина и пароля
}
]
]
];

Обработчик обмена с 1С, вызываемый модулем должен реализовывать интерфейс dicr\exchange1c\Handler. Для удобства вы
можете наследовать абстрактны базовый класс dicr\exchange1c\BaseHandler в котором реализованы функции обмена и
утилиты. Вам необходимо только переопределить методы импорта данных (importProp, importGroup, importProd)
из документа SimpleXmlElement в базу своего сайта.
Клиентская часть Состоит из:

  • настраиваемого компонента dicr\exchange1c\Client
  • консольного приложения и контроллера dicr\exchange1c\ClientController

Настройка клиентской части $config = [
'components' => [
'client' => [
'class' => dicr\exchange1c\Client::class,
'url' => 'https://адрес_обмена/сайта',

// опционально авторизация на сайте
'login' => 'логин',
'password' => 'пароль'
]
]
];

Использование /** @var dicr\exchange1c\Client $client */
$client = Yii::$app->get('client');

// авторизация (получает куку авторизации)
$client->requestCatalogCheckAuth();

// инициализация параметров обмена (получает zip, file_limit)
$client->requestCatalogInit();

// загрузка файла на сайт
$data = $client->requestCatalogFile('/home/files/import.xml');

// импорт данных
$client->requestCatalogImport('import.xml');

Консольное приложение Использовать клиентскую часть можно также в консоли.
Для настроек создать файл configs/local.php с данными:
/** @var ?string адрес обмена на сайте */
const EXCHANGE_URL = 'https://мой-сайт.рф/exchange1c';

/** @var ?string логин */
const EXCHANGE_LOGIN = 'мой-логин';

/** @var ?string пароль */
const EXCHANGE_PASSWORD = 'мой пароль';

Аргументы командной строки:
# отправка каталога на сайт
./yii client/catalog-file /home/files/import.xml

# отправка заказов на сайт
./yii client/sale-file /home/files/orders.xml

# запрос заказов с сайта
./yii client/sale-query