Использование HTTP REST обертки xmysql для работы с MySQL на примере OpenCart

05.11.20

Интеграция - WEB-интеграция

В статье опишу вариант работы с MySQL базой используя HTTP.

Вводные

  • CMS, например OpenCart, использующая MySQL
  • Сайт развернут на VDS и есть возможностью использовать node.js
  • Нужно организовать обмен с CMS
  • Web сервер NGINX

 

Варианты решения

  • Использование модулей работающих с форматом CommerceML и настройкой типового функционала в 1С, пример https://github.com/KirilLoveVE/opencart2-exchange1c или платные аналоги
  • Использование модулей которые реализуют обертку SQL запросов и ответных обработок к ним
  • Использование прямого подключения к MySQL
  • Использование REST API, только платный вариант и со своими проблемами
  • Использование HTTP обертки для MySQL

К данному варианту решения подтолкнула статья про PostgREST //infostart.ru/1c/articles/1217831/

 

Реализация

Для решения задачи использую https://github.com/o1lab/xmysql

Устанавливаю пакет 

npm install -g xmysql

Запускаю сервис

xmysql -h localhost -u opencartuser -p yHL0nVwQrQ5k9PSAYAcU -d opencart

Если подключение прошло успешно, то вижу

          Generating REST APIs at the speed of your thought..

 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

          Database              :    opencart
          Number of Tables      :    136

          REST APIs Generated   :    2593

          Xmysql took           :    0.3 seconds
          API's base URL        :    localhost:3000

 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

 

Создаю перенаправление на обертку на уровне nginx

 
 Настройки NGINX

 

Проверяю работоспособность

 
 Скриншот

 

Нужно понимать что доступ через обертку имеет полные права на базу и идет без проверки прав доступа, имеет смысл поставить на уровне конфигурации сайта NGINX ограничения по IP (документация) и использовать аутентификацию, например basic (документация). Так же имеет смысл настроить HTTPS и при возможности организовать VPN канал от сервера 1С до VDS.

Останавливаю xmysql.

 

Для запуска в качестве сервиса использую pm2 https://pm2.keymetrics.io/

Добавляю сервис xmysql в pm2 (ссылка на источник)

sudo pm2 start --name "xmysql-api" xmysql -- -h localhost -u opencartuser -p yHL0nVwQrQ5k9PSAYAcU -d opencart

Настраиваю pm2 для автоматического запуска

sudo pm2 startup

sudo systemctl enable pm2-root

Сохраняю настройки запущенных сервисов.

sudo pm2 save

В моем случае (тестовый сервер) сервис pm2 запускается из под root, что некорректно с точки зрения безопасности, имеет смысл добавить пользователя с ограниченными правами и работать с pm2 из под него.

Перезапускаю сервер, проверяю работоспособность.

 

Захожу на сайт "http://oc.malikov.pro/index.php?route=product/product&product_id=43"

Получаю данные товара "GET http://xmysql.malikov.pro/api/oc_product/43"

 
 результат в формате JSON

 

Обновляю цену "PATCH http://xmysql.malikov.pro/api/oc_product/43"

{
    "price": 600
}

 

Проверяю на сайте

 
 Скриншот

 

Итог

При отсутствии API для CMS с базой на MySQL можно относительно просто и безопасно организовать работу с данными.

Для фиксации внешних идентификаторов в 1С можно использовать наработки из //infostart.ru/1c/articles/1256935/

 

Благодарю за внимание.

Вступайте в нашу телеграмм-группу Инфостарт

См. также

Сайты и интернет-магазины WEB-интеграция Системный администратор Программист Пользователь 1С:Предприятие 8 1C:Бухгалтерия 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Интеграционный модуль обмена между конфигурацией Альфа Авто 5 и Альфа Авто 6 и порталом AUTOCRM / LOGICSTARS. Данный модуль универсален. Позволяет работать с несколькими обменами AUTOCRM / LOGICSTAR разных брендов в одной информационной базе в ручном и автоматическом режиме.

42700 руб.

03.08.2020    23605    35    24    

27

WEB-интеграция Программист 1С:Предприятие 8 1С:Бухгалтерия 3.0 Бытовые услуги, сервис Платные (руб)

Расширение для автоматизации передачи данных между сервисом Vetmanager с 1С: Бухгалтерия 3.0. Решение позволяет загружать документы и справочники из Ветменеджер в 1С:Бухгалтерию, сокращая время на ручной ввод данных и минимизируя ошибки.

24000 руб.

02.02.2021    22306    67    52    

42

WEB-интеграция Загрузка и выгрузка в Excel Программист Пользователь 1С:Предприятие 8 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 Розничная и сетевая торговля (FMCG) Россия Платные (руб)

Расширение освободит вас от необходимости вручную обновлять товары в группах ВКонтакте. Достаточно задать правила один раз, и система автоматически синхронизирует ваш каталог. Вы сможете легко выбирать, какие товары публиковать, создавая гибкие критерии отбора. Например, можно добавить важные для покупателей параметры: цвет, размер или другие характеристики.

12200 руб.

29.08.2025    2034    6    0    

6

WEB-интеграция Программист Бизнес-аналитик 1С:Предприятие 8 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Оптовая торговля, дистрибуция, логистика ИТ-компания Платные (руб)

Модуль "Экспортер" — это расширение для 1С, предназначенное для автоматизации процессов выгрузки данных. Оно позволяет эффективно извлекать, преобразовывать и передавать данные из систем 1С в интеграционную платформу Spot2D. Подсистема упрощает настройку, снижает количество ручных операций и обеспечивает удобный контроль данных.

17568 руб.

20.12.2024    5629    25    4    

27
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. bobeni 28.09.20 14:43 Сейчас в теме
Александр, при работе не через API CMS, остаются все риски/проблемы…
Раз напрямую с MySQL, то почему не через «внешние источники»? И зачем рассматривать прямое подключение?
Спасибо!)
2. malikov_pro 1355 28.09.20 18:12 Сейчас в теме
(1) "при работе не через API CMS, остаются все риски/проблемы" - согласен, но при данном варианте получается более прозрачно по коду (из опыта работы с OC).

"то почему не через «внешние источники»" - с точки зрения организации ограниченного доступа и контроля проще, для mysql нужно ADODB драйвер подходящий и права на его использование, открывать TCP и порт который хуже прослушивается/контролируется. При обертке выдать только право на доступ к URL по HTTP.

С учетом отсутствия API со стороны CMS и при том что реализацию пишу сам, например https://infostart.ru/1c/articles/1185983/, в некоторых случаях проще написать реализацию на стороне 1С.
Для отправки сообщения требуется регистрация/авторизация