classDuplicateKeyException

packages/ztd-query-core/src/Exception/DuplicateKeyException.php:18

final class DuplicateKeyException<TValue>
    extends SimulationException

Exception thrown when a PRIMARY KEY or UNIQUE constraint is violated.

A refusal says what it is about without naming the schema it came from, so the key values it carries are spelled out here rather than imported.

Type Aliases§

KeyValues = array<string, TValue>

Methods§

public function __construct(
    string $sql,
    string $tableName,
    string $keyName,
    KeyValues $keyValues = [],
)

source §

Parameters

`$sql`	`string`	The SQL statement.
`$tableName`	`string`	The name of the table.
`$keyName`	`string`	The name of the key constraint.
`$keyValues`	`KeyValues`	The duplicate key values.

Calls 4

static-call DuplicateKeyException::formatKeyValue() line 52
function-call implode line 54
static-call SimulationException::__construct() line 55
function-call sprintf line 55

public function getSql(): string

source §

Get the SQL statement.

Returns

string

Test cases 1

DuplicateKeyExceptionTest::testGetSqlReturnsOriginalSql calls

public function getTableName(): string

source §

Get the name of the table.

Returns

string

Test cases 1

DuplicateKeyExceptionTest::testGetTableNameReturnsTableName calls

public function getKeyName(): string

source §

Get the name of the key constraint.

Returns

string

Test cases 1

DuplicateKeyExceptionTest::testGetKeyNameReturnsKeyName calls

public function getKeyValues(): KeyValues

source §

Get the duplicate key values.

Returns

KeyValues

Test cases 1

DuplicateKeyExceptionTest::testGetKeyValuesReturnsKeyValues calls

public static function formatKeyValue(mixed $value): string

source §

Formats a duplicate value without coercing the value stored in the exception.

Parameters

$value mixed

Returns

string

Test cases 1

DuplicateKeyExceptionTest::testFormatKeyValueKeepsErrorMessagesReadableForDriverValues calls

Called from 1

static-call ZtdQuery\Exception\DuplicateKeyException::__construct() packages/ztd-query-core/src/Exception/DuplicateKeyException.php:52

Calls 4

function-call is_string line 105
function-call is_scalar line 108
function-call is_resource line 108
function-call get_debug_type line 112

Private surface 4§

Implementation details, listed for orientation only.

private string $sql

private string $tableName

private string $keyName

private KeyValues $keyValues

Test cases 17§

Test cases that cover or call this symbol, from the coverage report and from the analyzed test sources.

Dedicated tests 10

Other tests reaching this symbol 7

Relations§

Instantiated in 3