Предварительные требования

WEB Application Builder (WAB) – система быстрой разработки WEB-приложений - представляет собой WEB-приложение. Для работы приложения необходимы

  • Apache / nginx WEB-сервер
  • PHP 7.2 + (пакеты php-cli php-fpm php-json php-common php-mysql php-zip php-gd phpmbstring php-curl php-xml php-pear php-pgsql) рабочим PDO драйвером MySQL
  • Maria DB 10.1+ или совместимые MySQL (с версии 5.6)
  • Python 3.6.5+ (пакеты pandas, mysql.connector, psycopg2, bs4, sklearn, lxml)

Windows

Для быстрой установки Apache/PHP и Maria DB на персональный компьютер под Windows может быть использован XAMPP: https://www.apachefriends.org/ru/index.html.

Python может быть установлен с официального сайта https://www.python.org/downloads/. Пакеты могут быть установлены командами:

  • pip install pandas
  • pip install mysql.connector
  • pip install psycopg2-binary
  • pip install bs4
  • pip install sklearn
  • pip install lxml

Linux (Ubuntu 20.04 LTS)

Php может быть установлен командами:

  • sudo apt update
  • sudo apt install php php-cli php-fpm php-json php-common php-mysql php-zip
  • php-gd php-mbstring php-curl php-xml php-pear php-pgsql

Пакеты python должны быть доступны для пользователя, под которым выполняется WEB-сервис. Для Ubuntu 20.04 LTS установить пакеты можно с помощью следующий команд:

sudo mkdir /var/www/.localsudo mkdir /var/www/.cachesudo chown www-data:www-data /var/www/.localsudo chown www-data:www-data /var/www/.cachesudo -u www-data pip3 install pandassudo -u www-data pip3 install mysql.connectorsudo -u www-data pip3 install psycopg2-binarysudo -u www-data pip3 install pbs4sudo -u www-data pip3 install sklearnsudo -u www-data pip3 install lxml

Установка

Установка производится из установочного архива с названием wab_xxxx_yyyy.zip, где xxxx – дата создания дистрибутива, yyyy – уникальный идентификатор. Для выполнения команд для linuxсистем может потребоваться использование sudo.

Создание базы данных wab:

mysql -u root -p < wab.sql

Файл wab.sql находится в папке sql архива; если пользователь root не имеет пароля, то флажок -p может быть опущен.

Далее нужно распаковать папку app архива в корень WEB-сервера. Для XAMPP (Windows) обычно это папка C:\xampp\htdocs, а для Ubuntu - /var/www/html.

После этого нужно создать папку app/connect в корне WEB-сервера, и скопировать из архива файл connect/wab.php.

Для linux-систем владельцем папки app и вложенных нужно установить пользователя, под которым выполняется WEB-сервис. Например, для Ubuntu 20.04 LTS команда следующая (пользователь WEB-сервиса - www-data):

sudo chown -R www-data:www-data /var/www/html/appx

В случае необходимости нужно настроить в файле wab.php параметры подключения к базе данных, положение журнала, а также путь к нужной версии python.

Проверка установки

Для проверки нужно открыть приложение в браузере:

http://[server]/app/wab

Здесь [server] – адрес WEB-сервера.

Должно открыться приложение с запросом параметров авторизации. Для подключения суперпользвателем используйте имя пользователя admin и пароль admin123

Если приложение не открывается, то ошибки обычно можно выявить с помощь журналов webсервера и журнала приложения. Наиболее частными ошибками являются

  • Не установлены пакеты PHP
  • Пакеты не разрешены в php.ini
  • Неправильные учетные данные для подключения к базе данных

Что дальше?

Для начала работы обратитесь к документу «ВВЕДЕНИЕ В СИСТЕМУ РАЗРАБОТКИ WAB».