Add docs link, misc format tweaks

This commit is contained in:
2024-07-21 22:02:16 -04:00
parent d8330d828a
commit 0659de3f99
16 changed files with 49 additions and 48 deletions

View File

@@ -38,13 +38,13 @@ class Configuration
public static ?array $options = null;
/** @var Option<Mode> The mode in which the library is operating */
public static Option $_mode;
public static Option $mode;
/** @var Option<string> The data source name (DSN) of the connection string */
private static Option $_pdoDSN;
private static Option $pdoDSN;
/** @var PDO|null The PDO instance to use for database commands */
private static ?PDO $_pdo = null;
private static ?PDO $pdo = null;
/**
* Use a Data Source Name (DSN)
@@ -55,10 +55,10 @@ class Configuration
public static function useDSN(string $dsn): void
{
if (empty($dsn)) {
self::$_mode = self::$_pdoDSN = None::create();
self::$mode = self::$pdoDSN = None::create();
} else {
self::$_mode = Some::create(Mode::deriveFromDSN($dsn));
self::$_pdoDSN = Some::create($dsn);
self::$mode = Some::create(Mode::deriveFromDSN($dsn));
self::$pdoDSN = Some::create($dsn);
}
}
@@ -70,14 +70,14 @@ class Configuration
*/
public static function dbConn(): PDO
{
if (is_null(self::$_pdo)) {
$dsn = (self::$_pdoDSN ?? None::create())->getOrThrow(
if (is_null(self::$pdo)) {
$dsn = (self::$pdoDSN ?? None::create())->getOrThrow(
new DocumentException('Please provide a data source name (DSN) before attempting data access'));
self::$_pdo = new PDO($dsn, $_ENV['PDO_DOC_USERNAME'] ?? self::$username,
self::$pdo = new PDO($dsn, $_ENV['PDO_DOC_USERNAME'] ?? self::$username,
$_ENV['PDO_DOC_PASSWORD'] ?? self::$password, self::$options);
}
return self::$_pdo;
return self::$pdo;
}
/**
@@ -88,7 +88,7 @@ class Configuration
*/
public static function mode(?string $process = null): Mode
{
return self::$_mode->getOrThrow(
return self::$mode->getOrThrow(
new DocumentException('Database mode not set' . (is_null($process) ? '' : "; cannot $process")));
}
@@ -99,7 +99,7 @@ class Configuration
*/
public static function overrideMode(?Mode $mode): void
{
self::$_mode = Option::fromValue($mode);
self::$mode = Option::fromValue($mode);
}
/**
@@ -107,6 +107,6 @@ class Configuration
*/
public static function resetPDO(): void
{
self::$_pdo = null;
self::$pdo = null;
}
}