README

Пакет OrackleDb предоставляет собой легковесную обертку вокруг расширения oci8 для php.

Введение

Установка

Эта библиотека требует PHP 5.5 или более позднюю версию. Установка возможна через composer из custom repository.

Начинаем работать

Создать новый инстанс БД можно следующим образом

<?php
use nightlinus\OracleDb\Database;

$db = new Database("USER", "password", "DEV");

При этом соединение с базой происходит только при первом обращении к ней. Соединение может быть как общее для всех инстансов класса, так и отдельным для каждого инстанса, это контролируется конфигурационной переменной connection.cache

$db->config('connection.cache', true);

В таком виде текущий инстанс будет использовать уже имеющееся соединение с базой данных

$db->config('connection.cache', false);

В таком — будет использовать всегда новое соединение с базой данных. Данное воведение выставлено по умолчанию.

Список текущих настроек и их значения по умолчанию:

• session.charset => AL32UTF8
• session.autocommit => false
• session.dateFormat => DD.MM.YYYY HH24:MI:SS
• session.dateLanguage => false
• connection.persistent => false
• connection.privileged => OCI_DEFAULT
• connection.cache => false
• connection.class => false
• connection.edition => false
• client.identifier =>
• client.info =>
• client.moduleName =>
• profiler.enabled => false
• profiler.class => NAMESPACE . \Profiler
• statement.cache.enabled => true
• statement.cache.size => 50
• statement.cache.class => NAMESPACE . \StatementCache

Создание Statement'a

В библиотеке представлены 2 способа инстанциировать Statement:

$sql = 'SELECT * FROM DUAL';
$statement = $db->prepare($sql);

или

$sql = 'SELECT * FROM DUAL';
$statement = $db->query($sql);

Во втором случае Statement будет сразу выполнен (неявно вызван метод execute).

Связывание переменных

Связывание можно выполнить 2 способами: Через функции bind*

$sql = 'SELECT *, :b_var FROM DUAL';
$statement = $db->prepare($sql);
$statement->bind(['b_var' => 1]);

Или же непосредственно из функции query:

$sql = 'SELECT *, :b_var FROM DUAL';
$statement = $db->query($sql, ['b_var' => 1]);

NB: связывание происходит не с переданным массивом, а со свойством Statementа bindings в котором хранятся значение IN, а так же OUT переменных.

Получение данных

Библиотека основана на генераторах, которые моут быть возвращены из любого метода получения данных, возвращающего несколько кортежей.

$sql = 'SELECT * FROM customers';
$statement = $db->query($sql);

foreach($statement as $row) {
  var_dump($row);
}

$statement->execute() //Делаем вохможным получение данных повторно
          ->setReturnType($statement::RETURN_ITERATOR); //из fetch* функция возвращаем итератор, а не готовый массив
foreach($statement->fetchMap() as $map) {
  var_dump($map['123'])
}