Использование 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/

 

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

См. также

Интеграция Альфа Авто 5 / Альфа Авто 6 и AUTOCRM / Инфотек

Сайты и интернет-магазины WEB-интеграция Платформа 1С v8.3 Конфигурации 1cv8 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

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

36000 руб.

03.08.2020    15748    10    17    

11

Интеграция 1С — Битрикс24. Обмен задачами

Сайты и интернет-магазины Интеграция WEB-интеграция Платформа 1С v8.3 Конфигурации 1cv8 Управленческий учет Платные (руб)

Интеграция 1С и Битрикс24. Разработка имеет двухстороннюю синхронизацию 1С и Битрикс24 задачами. Решение позволяет создавать пользователя в 1С из Битрикс24 и наоборот. Данная разработка технически подходит под все основные конфигурации линейки продуктов 1С:Предприятие 8.3 (8.3.18.1289). При приобретении предоставляется 1 месяц бесплатных обновлений разработки. Доступна демо-версия продукта с подключением Вашего Битрикс24

5040 руб.

04.05.2021    17551    6    15    

13

Интеграция с сервисом vetmanager

WEB-интеграция Платформа 1С v8.3 Бухгалтерский учет 1С:Бухгалтерия 3.0 Бытовые услуги, сервис Платные (руб)

Внешняя обработка разрабатывалась для загрузки документов из Ветменеджер в 1С: Бухгалтерия 3.0

12000 руб.

02.02.2021    16360    42    49    

23

[Расширение] БОР-Навигатор.Культура

Зарплата Бюджетный учет WEB-интеграция Обмен с ГосИС Платформа 1С v8.3 Сложные периодические расчеты 1С:Зарплата и кадры государственного учреждения 3 Государственные, бюджетные структуры Россия Бюджетный учет Платные (руб)

Расширение конфигурации, включающее в себя объекты, необходимые для подготовки и сдачи отчета "Штатная численность" системы "БОР-Навигатор.Культура" в программе "1С:Зарплата и кадры государственного учреждения", редакция 3.1.

8400 руб.

01.02.2019    25741    9    0    

7

Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС

Обмен с ГосИС WEB-интеграция Платформа 1С v8.3 Управляемые формы 1С:Комплексная автоматизация 1.х 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия государственного учреждения 1С:Документооборот 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Платные (руб)

Обработка является альтернативой механизму, разработанному фирмой 1С и заполняющему реквизиты контрагента по ИНН или наименованию. Не требуется действующей подписки ИТС. Вызывается как внешняя дополнительная обработка, т.е. используется, непосредственно, из карточки контрагента. Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС (egrul.nalog.ru) для БП 2.0, БП 3.0, БГУ 1.0, БГУ 2.0, УТ 10.3, УТ 11.x, КА 1.1, КА 2.x, УПП 1.x, ERP 2.x, УНФ 1.5, УНФ 1.6, УНФ 3.0, ДО 2.1

2400 руб.

28.04.2016    88584    160    215    

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

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

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