sqlite plugin

Плагин для работы с СУБД SQLite

Версия: 2.2

Дата релиза: 23 ноября 2022

Список методов плагина

connect

Подключиться к базе данных (sqlite)

connect(string alias, string connection_string)
alias псевдоним подключения
connection_string строка подключения к базе данных

Описание возврата: обьект подключения

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $sqlite);

// начало теста
$test->echo_header('connect');

// путь
$path = $test->get_test_file_full_path('test.db');
// строка соединения
$connection_string = 'Data Source='.$path;

// 1
echo('Соединимся с БД :');
echo($sqlite->connect('local1', $connection_string));

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, sqlite)

// начало теста
test.echo_header('connect')

// путь
path = test.get_test_file_full_path('test.db')
// строка соединения
connection_string = `Data Source=${path}`

// 1
echo('Соединимся с БД :')
echo(sqlite.connect('local1', connection_string))

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, sqlite)

# начало теста
test.echo_header('connect')

# путь
path = test.get_test_file_full_path('test.db')
# строка соединения
connection_string = f'Data Source={path}'

# 1
echo('Соединимся с БД :')
echo(sqlite.connect('local1', connection_string))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

disconnect

Отключиться от базы данных (sqlite)

disconnect(string alias)
alias псевдоним подключения
Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $sqlite);

// начало теста
$test->echo_header('disconnect');

// имя синонима соединения
$alias = 'local1';

// 1
echo ("Отсоединимся от БД : ");
echo($sqlite->disconnect($alias));

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, sqlite)

// начало теста
test.echo_header('disconnect')

// имя синонима соединения
alias = 'local1'

// 1
echo ("Отсоединимся от БД : ")
echo(sqlite.disconnect(alias))

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, sqlite)

# начало теста
test.echo_header('disconnect')

# имя синонима соединения
alias = 'local1'

# 1
echo ("Отсоединимся от БД : ")
echo(sqlite.disconnect(alias))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

create_database

создать базу данных (sqlite)

create_database(string path)
path путь к базе данных

Описание возврата: результат

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $sqlite);

// начало теста
$test->echo_header('create_database');

// путь
$path = $test->get_test_file_full_path('test1.db');

// 1
echo("Создать БД:");
echo($sqlite->create_database($path));

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, sqlite)

// начало теста
test.echo_header('create_database')

// путь
path = test.get_test_file_full_path('test1.db')

// 1
echo("Создать БД:")
echo(sqlite.create_database(path))

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, sqlite)

# начало теста
test.echo_header('create_database')

# путь
path = test.get_test_file_full_path('test1.db')

# 1
echo("Создать БД:")
echo(sqlite.create_database(path))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

execute_query

выполнить запрос query (sqlite)

execute_query(string alias, string query)
alias псевдоним подключения
query запрос к базе данных

Описание возврата: результат запроса (json)

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $sqlite);

// начало теста
$test->echo_header('execute_query');

// имя синонима соединения
$alias = 'local1';
// запрос
$query = 'select last_name from Customers';

$res = $sqlite->execute_query($alias, $query);
echo 'res: '.$res."\n";

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, sqlite)

// начало теста
test.echo_header('execute_query')

// имя синонима соединения
alias = 'local1'
// запрос
query = 'select last_name from Customers'

res = sqlite.execute_query(alias, query)
echo(`res: ${res}\n`)

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, sqlite)

# начало теста
test.echo_header('execute_query')

# имя синонима соединения
alias = 'local1'
# запрос
query = 'select last_name from Customers'

res = sqlite.execute_query(alias, query)
print(f'res: {res}')

# конец теста
print('\n<hr><br>')

# выход
app.quit()

execute_scalar

выполнить запрос scalar (sqlite)

execute_scalar(string alias, string query)
alias псевдоним подключения
query запрос к базе данных

Описание возврата: результат scalar

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $sqlite);

// начало теста
$test->echo_header('execute_scalar');

// имя синонима соединения
$alias = 'local1';
// строка соединения
$query = 'select count(customer_id) from Customers';

// 1
echo('Выполнить запрос-скаляр к БД :');
echo($sqlite->execute_scalar($alias, $query));

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, sqlite)

// начало теста
test.echo_header('execute_scalar')

// имя синонима соединения
alias = 'local1'
// строка соединения
query = 'select count(customer_id) from Customers'

// 1
echo('Выполнить запрос-скаляр к БД :')
echo(sqlite.execute_scalar(alias, query))

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, sqlite)

# начало теста
test.echo_header('execute_scalar')

# имя синонима соединения
alias = 'local1'
# строка соединения
query = 'select count(customer_id) from Customers'

# 1
echo('Выполнить запрос-скаляр к БД :')
echo(sqlite.execute_scalar(alias, query))

# конец теста
print('\n<hr><br>')

# выход
app.quit()

execute_non_query

выполнить запрос non query (sqlite)

execute_non_query(string alias, string query)
alias псевдоним подключения
query запрос к базе данных

Описание возврата: результат запроса

Примеры использования 
<?php
// инициализация
$xhe_host = '127.0.0.1:7010';
$relative_app_dir = '..\\..\\..\\';
require($relative_app_dir.'Templates/init.php');
include($relative_app_dir.'Templates/_for_tests_.php');

$bUTF8Ver = true;
$PHP_Use_Trought_Shell = true;

// рабочая папка
$script_folder = $debug->get_cur_script_folder();
// отсносительный путь
$app_dir = realpath($script_folder.$relative_app_dir);
// тестовые данные
$test = new _for_tests_($script_folder, $sqlite);

// начало теста
$test->echo_header('execute_non_query');

// имя синонима соединения
$alias = 'local1';
// запрос
$query = 'update Customers set last_name=\'unkown\' where customer_id=1';

// 1
echo("Выполним команду БД: ");
echo($sqlite->execute_non_query($alias, $query));

// конец теста
echo "\n<hr><br>";

// выход
$app->quit();
?>

// связь с платформой
xhe_host = '127.0.0.1:7014'
_path = require('path')
relative_app_dir = '..\\..\\..\\'
echo = require(_path.join(relative_app_dir, 'Templates JS', 'init.js'))
_for_tests_ = require(_path.join(relative_app_dir, 'Templates JS', '_for_tests_.js'))

// рабочая папка
script_folder = debug.get_cur_script_folder()
// отсносительны йпуть
app_dir = _path.resolve(_path.join(script_folder, relative_app_dir))
// тестовые данные
test = new _for_tests_(script_folder, sqlite)

// начало теста
test.echo_header('execute_non_query')

// имя синонима соединения
alias = 'local1'
// запрос
query = 'update Customers set last_name=\'unkown\' where customer_id=1'

// 1
echo("Выполним команду БД: ")
echo(sqlite.execute_non_query(alias, query))

// конец теста
echo('\n<hr><br>')

// выход
app.quit()

# дополнительные пути
import sys, os
relative_app_dir = '..\\..\\..\\'
sys.path.append(os.path.join(relative_app_dir, 'Templates PY'))

# связь с платофрмой
xhe_host = '127.0.0.1:7010'
from xweb_human_emulator import *
from _for_tests_ import _for_tests_

# рабочая папка
script_folder = debug.get_cur_script_folder()
# относительный путь
app_dir = os.path.abspath(os.path.join(script_folder, relative_app_dir))

# тестовые данные
test = _for_tests_(script_folder, sqlite)

# начало теста
test.echo_header('execute_non_query')

# имя синонима соединения
alias = 'local1'
# запрос
query = 'update Customers set last_name=\'unkown\' where customer_id=1'

# 1
echo("Выполним команду БД: ")
echo(sqlite.execute_non_query(alias, query))

# конец теста
print('\n<hr><br>')

# выход
app.quit()