Database Connection

A database connection can be created manually with the respective database connection model, with the database connection factory or with the database pool which also manages multiple database connections.

Database Connection

A connection takes an array which contains the database connection information and create the connection:

$con = new MysqlConnection([
    'db'       => 'mysql', /* db type */
    'host'     => '127.0.0.1', /* db host address */
    'port'     => '3306', /* db host port */
    'login'    => 'root', /* db login name */
    'password' => '', /* db login password */
    'database' => 'oms', /* db name */
    'prefix'   => 'oms_', /* db table prefix */
]);

With getStatus() you can check the status of the connection.

Database Factory

The connection factory automatically creates the correct connection based on the database definition:

$con = ConnectionFactory::create([
    'db'       => 'mysql', /* this is used by the connection factory to pick the correct connection */
    'host'     => '127.0.0.1',
    'port'     => '3306',
    'login'    => 'root',
    'password' => '',
    'database' => 'oms',
    'prefix'   => 'oms_',
]);

Database Pool

Existing database connections can be added to the database pool:

$dbPool = new DatabasePool();
$dbPool->add('read', $con1);
$dbPool->add('write', $con2);

$dbPool->get('read'); // returns $con1

This allows to create different database connections with different permissions or handling database connections with different databases.

A new database connection can also be directly created by the database pool:

$dbPool = new DatabasePool();
$dbPool->create('read',
    [
        'db'       => 'mysql',
        'host'     => '127.0.0.1',
        'port'     => '3306',
        'login'    => 'root',
        'password' => '',
        'database' => 'oms',
        'prefix'   => 'oms_',
    ]
);

1.9 KiB Raw Blame History

Database Connection