This version of the library is no longer maintained. Please consider upgrading to the latest release

Working with databases is done with the help of the Opis\Database\Database class, which provides various methods that will ease the process of manipulating tables and records. The constructor of the Database class takes as an argument an instance of the Opis\Database\Connection class. The Connection class is responsible for establishing a connection to the database server, as well as for sending and receiving data. The constructor of the Connection class accepts parameters for specifying the DSN and optionally for the username and password(if any).

use Opis\Database\Database;
use Opis\Database\Connection;

$connection = new Connection('mysql:host=localhost;dbname=test', 'username', 'password');

$db = new Database($connection);

You can also create a connection by using the create static method of Opid\Database\Connection class.

$connection = Connection::create('mysql:host=localhost;dbname=test', 'user', 'password');

Connection options

The DSN, the username and the password provided when instantiating a new Opis\Database\Connection class, will be further used to build a PDO object that will actually establish a connection to the database. Opis Database allows you to specify options for the PDO object by calling the option method.

$connection = Connection::create($dsn, $user, $password)
                        ->option(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_OBJ)
                        ->option(PDO::ATTR_STRINGIFY_FETCHES, false);

Setting multiple options simultaneously is done by calling the options method and passing as an argument an array of options.

$connection = Connection::create($dsn, $user, $password)
                        ->options(array(
                            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_OBJ,
                            PDO::ATTR_STRINGIFY_FETCHES => false
                        ));

Making a connection persistent is done by using the persistent method.

$connection = Connection::create($dsn, $user, $password)
                        ->persistent();

You can keep a log with all of the queries sent to a database by calling the logQueries method. Retrieving the list of logged queries is done using the getLog method.

$connection = Connection::create($dsn, $user, $password)
                        ->logQueries();

//Your queries...

foreach ($connection->getLog() as $entry) {
    echo $entry;
}

You also have the possibility to specify a list of commands that will be executed after connecting to a database by using the initCommand method.

$connection = Connection::create($dsn, $user, $password)
                        ->initCommand('SET NAMES UTF-8');