marko / database-mysql

0.11.0 2026-10-06 13:57 UTC

Requires

• php: ^8.5
• ext-pdo: *
• marko/core: 0.11.0
• marko/database: 0.11.0

Requires (Dev)

• marko/testing: 0.11.0
• pestphp/pest: ^4.0

MIT

Published on Packagist.org on 2026-10-06 15:39 UTC

README

MySQL and MariaDB driver for the Marko framework database layer.

Installation

composer require marko/database-mysql

This automatically installs marko/database (the interface package) as a dependency.

Configuration

Create config/database.php with a flat array of connection details:

<?php

declare(strict_types=1);

use Marko\Config\Env;

return [
    'driver' => 'mysql',
    'host' => Env::string('DB_HOST', 'localhost'),
    'port' => Env::int('DB_PORT', 3306, min: 1, max: 65535),
    'database' => Env::string('DB_DATABASE', 'marko'),
    'username' => Env::string('DB_USERNAME', 'root'),
    'password' => Env::string('DB_PASSWORD', ''),
];

driver, host, port, database, username, and password are all required. Set the corresponding values in your .env file:

DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=marko
DB_USERNAME=root
DB_PASSWORD=secret

For multiple connections (for example, read replicas), use marko/database-readwrite, which adds the connections layout.

Driver Notes

This driver supports MySQL 8.0+ and MariaDB 10.11+. Both are fully supported via the same driver key (mysql).

Quick Example

use Marko\Database\Connection\ConnectionInterface;

class MyService
{
    public function __construct(
        private ConnectionInterface $connection,
    ) {}

    public function doSomething(): void
    {
        $result = $this->connection->query('SELECT * FROM users');
    }
}

Documentation

Full configuration, driver notes, and API reference: marko/database-mysql