install

Установка go\DB

Системные требования

Зависимость самой библиотеки: PHP 5.3+

У каждого адаптера могут быть свои зависимости. Например, адаптер mysql требует PHP-расширения mysqli, а адаптер sqlite расширения sqlite3.

Установка

Рекомендуемый способ:

composer require go/db

Ниже описаны устаревшие.

Получение go\DB

Раздобыть исходные коды библиотеки, можно двумя способами.

Скачать последнюю версию из раздела Tags.

Либо склонировать себе git-репу: git clone https://github.com/vasa-c/go-db.git.

Подключение go\DB

Скачав, получаем 2 каталога. Один каталог - Tests, содержит юнит-тесты. Если вы не злоупотребляете ими, можете его смело проигнорировать. Второй каталог, goDB, содержит нужную нам библиотеку.

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

Самый простой:

require_once('goDB/autoload.php'); // path to goDB
\go\DB\autoloadRegister();

Библиотека готова к работе.

Дополнительные способы автозагрузки

go\DB\autoloadRegister() на самом деле регистрирует в стеке автозагрузчиков (spl_autoload_register) функцию go\DB\autoload, которая определена в файле goDB/autoload.php.

Можно не регистрировать её, а использовать в своём автозагрузчике.

require_once('goDB/autoload.php');

// some code ...

function __autoload($classname) {
    if (strpos($classname, 'go\DB\\') === 0) {
        \go\DB\autoload($classname);
    } else {
        // ...
    }
    // ...
}

Либо не использовать вовсе. Структура классов goDB проста. Каждому классу соответствует одноимённый файл, каждому вложенному пространству имён - подкаталог.

Например, класс go\DB\Helpers\ParserPH описан в файле каталог goDB/Helpers/ParserPH.php.