mirror of
https://code.mensbeam.com/MensBeam/Arsse.git
synced 2024-12-23 08:04:54 +00:00
f902346b6c
- RuntimeData has now been replaced by a single static Data class - The Data class has a load() method which fills the same role as the constructor of RuntimeData - The static Lang class is now an instantiable class and is a member of Data - All tests have been adjusted and pass - The Exception tests no longer require convoluted workarounds: a simple mock for Data::$l suffices; Lang tests also use a mock to prevent loops now instead of using a workaround
29 lines
No EOL
1.6 KiB
PHP
29 lines
No EOL
1.6 KiB
PHP
<?php
|
|
declare(strict_types=1);
|
|
namespace JKingWeb\Arsse\Db;
|
|
|
|
interface Driver {
|
|
function __construct(bool $install = false);
|
|
// returns a human-friendly name for the driver (for display in installer, for example)
|
|
static function driverName(): string;
|
|
// returns the version of the scheme of the opened database; if uninitialized should return 0
|
|
function schemaVersion(): int;
|
|
// begin a real or synthetic transactions, with real or synthetic nesting
|
|
function begin(): bool;
|
|
// commit either the latest or all pending nested transactions; use of this method should assume a partial commit is a no-op
|
|
function commit(bool $all = false): bool;
|
|
// rollback either the latest or all pending nested transactions; use of this method should assume a partial rollback will not work
|
|
function rollback(bool $all = false): bool;
|
|
// attempt to advise other processes that they should not attempt to access the database; used during live upgrades
|
|
function lock(): bool;
|
|
function unlock(): bool;
|
|
function isLocked(): bool;
|
|
// attempt to perform an in-place upgrade of the database schema; this may be a no-op which always throws an exception
|
|
function schemaUpdate(int $to): bool;
|
|
// execute one or more unsanitized SQL queries and return an indication of success
|
|
function exec(string $query): bool;
|
|
// perform a single unsanitized query and return a result set
|
|
function query(string $query): Result;
|
|
// ready a prepared statement for later execution
|
|
function prepare(string $query, string ...$paramType): Statement;
|
|
} |