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 21§

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 11

Relations§

Instantiated in 3