vasa-c / go-db

Work with different databases from PHP

go\DB: работа с различными БД из PHP

• Поддерживаемые адаптеры: MySQL, SQLite, PgSQL
• Документация: https://github.com/vasa-c/go-db/wiki
• Обсуждение на pyha.ru: http://pyha.ru/forum/topic/554.0
• Версия 1.x: https://github.com/vasa-c/godb-old
• Лицензия: MIT (https://github.com/vasa-c/go-db/blob/master/LICENSE)
• Тестировано под Debian для PHP 5.(3,4,5,6), PHP 7.(0.1.2), HHVM

Установка

• Composer: go/db
• Релизы: https://github.com/vasa-c/go-db/tags
• Репа: [email protected]:vasa-c/go-db.git

Документация

• Идеология и основные принципы
• Установка и системные требования
• Создание подключения к базе
• Выполнение запроса
• Шаблон запроса: плейсхолдеры
• Именованные плейсхолдеры
• Префикс имён таблиц
• Разбор результата
• Обработка ошибок
• Хранилище объектов подключений
• Отладочная информация
• Отложенное подключение и закрытие соединения
• Клонирование объекта базы
• Надстройка над таблицами

Форматы данных

• Формат WHERE
• Формат COLS
• Формат TABLE
• Формат SET

Дополнительно

• Unit-тесты
• Написание адаптеров
• Compat: совместимость со старыми версиями

Поддерживаемые адаптеры

• mysql
• mysqlold
• sqlite
• pgsql

Отдельное спасибо

• Dallone aka Алексей Полев, за адаптер PgSQL

go-db's Issues

Изменение организации юнит-тестов

С общим тестом на все адаптеры не вышло - написать отдельные.

Плейсхолдер ?w с параметром true,false,null или array() генерирует условие не работающее в PostgreSQL

$db->query('SELECT "schema_name" FROM "information_schema"."schemata" WHERE ?w', array( array() ));
//  "SELECT "schema_name" FROM "information_schema"."schemata" WHERE 1"; 
//  error="ERROR:  argument of WHERE must be type boolean, not type integer


$db->query("SET search_path TO information_schema");
$table = new go\DB\Table($db, 'schemata');
$table->select(array('schema_name') );

// "SELECT "schema_name" FROM "schemata" WHERE 1"; 
//  error="ERROR:  argument of WHERE must be type boolean, not type integer

Имя адаптера - имя класса

\absolute\path\to\Adapter
Relative - \go\DB\Adapters\Relative
mysql - alias

Refactoring unit tests

Шаблоны в запросе

Error reporting and query

SQLite: finalize error for iterators

Implementation\Sqlite::freeCursor();

The SQLite3Result object has not been correctly initialised

Deprecated modificator `null`

Test for extended ?t и ?c

1. Table prefix
2. Table object and the fields map

Расширенный DEBUG

Placeholder ?where

array(
    'a' => 1,
    'b' => 2,
    'c' => array(3, 4, 5),
);

?where:

WHERE `a`=1 AND `b`=2 AND `c` IN (3, 4, 5)

empty array => WHERE 1

Travis-ci

Итераторы иногда вылетают

godb молча падает при ошибке подключени

При отсутсвии функции pg_connect godb падает без описании ошибки.
Предположительно баг здесь https://github.com/vasa-c/go-db/blob/master/goDB/Helpers/Connector.php#L65-67
$errorInfo не заполнена.

Named data and query without placeholders

$db->query('SELECT 1', [1, 2]); // Error - DataMuch

In the following example, the error should not be

$db->query('SELECT 1', ['id' => 1]);

Exception: filename and line of error

Последние коммиты ломают совместимость с 5.3

1cd7070#diff-f77070f4da973d36c5915aecbca00c09R31
c95873c#diff-64892fea78719d56ab84d66312e58a7fR74
Короткий варинт записи массива - 5.4+

Адаптер для goDB 1.x

Расширенный ?cols

db
table
col
func
as

Unit tests bootstrap

DataInvalidFormat

Бросать в нужных случаях

col & vars: use key

Table

$table = $db->getTable('tablename');

$table->select($cols, $where)->assoc();
$table->delete($where);
$table->getCount();

Coding standart PSR-1

?order

ORDER BY ?o
ORDER BY ?order

scalar: id - id ASC
list: ['a','b'] - a ASC, b ASC
dict: ['a' => true, 'b' => false] - a ASC, b DESC

Расширенный ?set

col=col+1

autoreplace {} (Even if there is no prefix)

/* Замена {table} */
        if($this->prefix) {
            $query = \preg_replace_callback('~{(.*?)}~', array($this, 'tableClb'), $this->pattern);
        }else{
            $query=$this->pattern;
        }

lifehack

Table & columns map

table->join()

Deprecated parsing {table}

Транзакции

Как узнать insert_id

В mysql есть возможность получить $mysqli->insert_id . Как это сделать в goDB?

Data elements less then placeholders

Hi, на одном сервере обновил php с 5.3 до 5.4 с сохранением списка расширений, но godb теперь ругается на сабж. В коде ничего не менялось, подключение:

$db = go\DB\Storage::getInstance()->create($this->params);

далее я делаю запросы через

go\DB\query("SELECT * FROM ?t WHERE id=?i LIMIT 1", array('forms', $id), 'row')

но почему-то массив с data пустой
вотафак?

конфиг пхп:

PHP 5.4.38 (cli) (built: Mar  8 2015 15:03:16) 
Copyright (c) 1997-2014 The PHP Group
Zend Engine v2.4.0, Copyright (c) 1998-2014 Zend Technologies
    with eAccelerator v1.0-dev, Copyright (c) 2004-2012 eAccelerator, by eAccelerator

[PHP Modules]
bz2
Core
ctype
curl
date
dom
eAccelerator
ereg
filter
gd
hash
iconv
json
libxml
mbstring
mhash
mysql
mysqli
mysqlnd
pcre
PDO
pdo_mysql
Phar
posix
Reflection
session
SimpleXML
soap
SPL
standard
tokenizer
xml
xmlreader
xmlrpc
xmlwriter
zip
zlib

[Zend Modules]
eAccelerator

\go\DB\Exceptions\Query::getErrorCode() возвращает NULL

try {
//.. запрос с ошибкой
} catch (\go\DB\Exceptions\Query $e){
var_dump($e->getErrorCode()); //NULL
var_dump($e->getCode()); // Здесь возвращает нужный
}

В конструкторе не устанавливается $this->errorcode = (int)$errorcode;

Autoloader

Подготовленные выражения

При пустом WHERE неоднозначности

Проверить clone + preQueries

Момент, когда уничтожается cursor не всегда ясен.

Требуется изменить организацию юнит-тестов.

Расширенный ?where

Мультизапросы

Pre-queries

Configuration queries executed only when connected

Небуферизированные запросы

Привет,

насколько мне удалось изучить документацию и код, сейчас нет возможности выполнить небуферизированный запрос.
Для Mysql это MYSQLI_USE_RESULT при mysqli::query, для Mysqlold это mysql_unbuffered_query и т.д.
Это очень полезно если запросы возвращают большие объемы данных, например при дампе таблиц и пр.
Были ли мысли добавить такой функционал, и если да то как, я бы мог помочь с реализацией если необходимо.

?cols: empty array is `*`, string is column name

Pgsql driver, не устанавливается параметр host

$params = array(
'host' => 'localhost', // <-- игнорируется
'username' => 'test',
'password' => 'test',
'dbname' => 'test',
'charset' => 'utf8',
'_debug' => true,
'_prefix' => '',
);

$db = go\DB\DB::create($params, 'pgsql');
// З.Ы. Я заметил что, все параметры которые не указаны в $paramsDefault (Implementations/Pgsql)
// отбрасываются. У postgresql параметров подключения несколько больше
// http://www.postgresql.org/docs/9.1/interactive/libpq-connect.html

Chain db.table.col for ?t and ?c

See comments in #44

English wiki

Subj + Russian edit

Fatal error: Wrong parameters for Exception (pgsql, wrong password)

Fatal error: Wrong parameters for Exception([string $exception [, long $code [, Exception $previous = NULL]]]) in /.../goDB/Exceptions/Runtime.php on line 24

var_dump($message, $code, $previous); //
array(4) { ["type"]=> int(2) ["message"]=> string(118) "pg_connect(): Unable to connect to PostgreSQL server: FATAL: Peer authentication failed for user "postgres"" ["file"]=> string(64) "/.../goDB/Implementations/Pgsql.php" ["line"]=> int(48) } NULL NULL

Sqlite: экранирование

http://www.php.net/manual/ru/sqlite3.escapestring.php#99300

Extended Table format

'name' -> `prefix_name`
['db' => 'dbname', 'table' => 'name'] -> `dname`.`prefix_table`
['one', 'two', 'three'] -> `one`.`two`.`prefix_three`