oracledb plugin

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

Версия: 2.2

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

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

connect

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

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, $oracledb);

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

// строка соединения
$connection_string = 'Data Source=localhost:1521/XE;User Id=SYS;Password=921;DBA Privilege=SYSDBA;';

//1
echo("Соединимся с БД:");
echo($oracledb->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, oracledb)

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

// строка соединения
connection_string = 'Data Source=localhost:1521/XE;User Id=SYS;Password=921;DBA Privilege=SYSDBA;'

//1
echo("Соединимся с БД:")
echo(oracledb.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, oracledb)

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

# строка соединения
connection_string = 'Data Source=localhost:1521/XE;User Id=SYS;Password=921;DBA Privilege=SYSDBA;'

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

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

# выход
app.quit()

disconnect

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

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, $oracledb);

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

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

// конец теста
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, oracledb)

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

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

// конец теста
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, oracledb)

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

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

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

# выход
app.quit()

execute_query

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

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, $oracledb);

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

// строка соединения
$alias = 'local1';
//запрос
$query = 'select dba_users.username from dba_users';

//1
echo("Выполнить SQL запрос: ");
echo($oracledb->execute_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, oracledb)

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

// строка соединения
alias = 'local1'
//запрос
query = 'select dba_users.username from dba_users'

//1
echo("Выполнить SQL запрос: ")
echo(oracledb.execute_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, oracledb)

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

# строка соединения
alias = 'local1'
#запрос
query = 'select dba_users.username from dba_users'

#1
echo("Выполнить SQL запрос: ")
echo(oracledb.execute_query(alias, query))

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

# выход
app.quit()

execute_scalar

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

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, $oracledb);

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

// строка соединения
$alias = 'local1';
//запрос
$query = 'select count(dba_users.username) from dba_users';

//1
echo("1.Выполнить SQL запрос-скаляр:");
echo($oracledb->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, oracledb)

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

// строка соединения
alias = 'local1'
//запрос
query = 'select count(dba_users.username) from dba_users'

//1
echo("1.Выполнить SQL запрос-скаляр:")
echo(oracledb.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, oracledb)

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

# строка соединения
alias = 'local1'
#запрос
query = 'select count(dba_users.username) from dba_users'

#1
echo("1.Выполнить SQL запрос-скаляр:")
echo(oracledb.execute_scalar(alias, query))

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

# выход
app.quit()

execute_non_query

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

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, $oracledb);

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

//синоним
$alias = 'local1';
//команда
$query = 'update regions set REGION_NAME = \'Jupiter\' where REGION_ID=1';

//1
echo("Выполнитиь SQL команду: ");
echo($oracledb->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, oracledb)

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

//синоним
alias = 'local1'
//команда
query = 'update regions set REGION_NAME = \'Jupiter\' where REGION_ID=1'

//1
echo("Выполнитиь SQL команду: ")
echo(oracledb.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, oracledb)

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

#синоним
alias = 'local1'
#команда
query = 'update regions set REGION_NAME = \'Jupiter\' where REGION_ID=1'

#1
echo("Выполнитиь SQL команду: ")
echo(oracledb.execute_non_query(alias, query))

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

# выход
app.quit()

call_stored_procedure

вызов хранимои процедуры (oracle)

call_stored_procedure(string alias, string procedure_name, string parameters)
alias псевдоним подключения
procedure_name имя хранимои процедуры в базе данных
parameters строка параметров

Описание возврата: результат запроса (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, $oracledb);

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

// соединение
$alias = 'local1';
// вызываемая процедура
$procedure_name = 'add_region';
// парметры процедуры
$parameters = 'REGION_NAME=Africa';

//1
echo("Вызовем хранимую проедуру: ");
echo($oracledb->call_stored_procedure($alias, $procedure_name, $parameters));

// конец теста
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, oracledb)

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

// соединение
alias = 'local1'
// вызываемая процедура
procedure_name = 'add_region'
// парметры процедуры
parameters = 'REGION_NAME=Africa'

//1
echo("Вызовем хранимую проедуру: ")
echo(oracledb.call_stored_procedure(alias, procedure_name, parameters))

// конец теста
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, oracledb)

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

# соединение
alias = 'local1'
# вызываемая процедура
procedure_name = 'add_region'
# парметры процедуры
parameters = 'REGION_NAME=Africa'

#1
echo("Вызовем хранимую проедуру: ")
echo(oracledb.call_stored_procedure(alias, procedure_name, parameters))

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

# выход
app.quit()