
| Current Path : /var/www/html/stolberg/web/core/tests/Drupal/KernelTests/Core/Database/ |
Linux ift1.ift-informatik.de 5.4.0-216-generic #236-Ubuntu SMP Fri Apr 11 19:53:21 UTC 2025 x86_64 |
| Current File : /var/www/html/stolberg/web/core/tests/Drupal/KernelTests/Core/Database/UpsertTest.php |
<?php
declare(strict_types=1);
namespace Drupal\KernelTests\Core\Database;
use Drupal\Core\Database\Database;
use Drupal\Core\Database\DatabaseExceptionWrapper;
/**
* Tests the Upsert query builder.
*
* @group Database
*/
class UpsertTest extends DatabaseTestBase {
/**
* Confirms that we can upsert (update-or-insert) records successfully.
*/
public function testUpsert(): void {
$connection = Database::getConnection();
$num_records_before = $connection->query('SELECT COUNT(*) FROM {test_people}')->fetchField();
$upsert = $connection->upsert('test_people')
->key('job')
->fields(['job', 'age', 'name']);
// Add a new row.
$upsert->values([
'job' => 'Presenter',
'age' => 31,
'name' => 'Tiffany',
]);
// Update an existing row.
$upsert->values([
'job' => 'Speaker',
// The initial age was 30.
'age' => 32,
'name' => 'Meredith',
]);
$result = $upsert->execute();
$this->assertIsInt($result);
$this->assertGreaterThanOrEqual(2, $result, 'The result of the upsert operation should report that at least two rows were affected.');
$num_records_after = $connection->query('SELECT COUNT(*) FROM {test_people}')->fetchField();
$this->assertEquals($num_records_before + 1, $num_records_after, 'Rows were inserted and updated properly.');
$person = $connection->query('SELECT * FROM {test_people} WHERE [job] = :job', [':job' => 'Presenter'])->fetch();
$this->assertEquals('Presenter', $person->job, 'Job set correctly.');
$this->assertEquals(31, $person->age, 'Age set correctly.');
$this->assertEquals('Tiffany', $person->name, 'Name set correctly.');
$person = $connection->query('SELECT * FROM {test_people} WHERE [job] = :job', [':job' => 'Speaker'])->fetch();
$this->assertEquals('Speaker', $person->job, 'Job was not changed.');
$this->assertEquals(32, $person->age, 'Age updated correctly.');
$this->assertEquals('Meredith', $person->name, 'Name was not changed.');
}
/**
* Confirms that we can upsert records with keywords successfully.
*/
public function testUpsertWithKeywords(): void {
$num_records_before = $this->connection->query('SELECT COUNT(*) FROM {select}')->fetchField();
$upsert = $this->connection->upsert('select')
->key('id')
->fields(['id', 'update']);
// Add a new row.
$upsert->values([
// Test a non sequence ID for better testing of the default return value.
'id' => 3,
'update' => 'Update value 2',
]);
// Update an existing row.
$upsert->values([
'id' => 1,
'update' => 'Update value 1 updated',
]);
$result = $upsert->execute();
$this->assertIsInt($result);
// The upsert returns the number of rows affected. For MySQL the return
// value is 3 because the affected-rows value per row is 1 if the row is
// inserted as a new row, 2 if an existing row is updated. See
// https://dev.mysql.com/doc/c-api/8.0/en/mysql-affected-rows.html.
$this->assertGreaterThanOrEqual(2, $result, 'The result of the upsert operation should report that at least two rows were affected.');
$num_records_after = $this->connection->query('SELECT COUNT(*) FROM {select}')->fetchField();
$this->assertEquals($num_records_before + 1, $num_records_after, 'Rows were inserted and updated properly.');
$record = $this->connection->query('SELECT * FROM {select} WHERE [id] = :id', [':id' => 1])->fetch();
$this->assertEquals('Update value 1 updated', $record->update);
$record = $this->connection->query('SELECT * FROM {select} WHERE [id] = :id', [':id' => 3])->fetch();
$this->assertEquals('Update value 2', $record->update);
// An upsert should be re-usable.
$upsert->values([
'id' => 4,
'update' => 'Another value',
]);
$return_value = $upsert->execute();
$this->assertSame(1, $return_value);
$record = $this->connection->query('SELECT * FROM {select} WHERE [id] = :id', [':id' => 4])->fetch();
$this->assertEquals('Another value', $record->update);
}
/**
* Upsert on a not existing table throws a DatabaseExceptionWrapper.
*/
public function testUpsertNonExistingTable(): void {
$this->expectException(DatabaseExceptionWrapper::class);
$upsert = $this->connection->upsert('a-table-that-does-not-exist')
->key('id')
->fields(['id', 'update']);
$upsert->values([
'id' => 1,
'update' => 'Update value 1 updated',
]);
$upsert->execute();
}
/**
* Tests that we can upsert a null into blob field.
*/
public function testUpsertNullBlob(): void {
$id = $this->connection->insert('test_one_blob')
->fields(['blob1' => 'test'])
->execute();
$r = $this->connection->query('SELECT * FROM {test_one_blob} WHERE [id] = :id', [':id' => $id])->fetchAssoc();
$this->assertSame('test', $r['blob1']);
$this->connection->upsert('test_one_blob')
->key('id')
->fields(['id', 'blob1'])
->values(['id' => $id, 'blob1' => NULL])
->values(['id' => $id + 1, 'blob1' => NULL])
->execute();
$r = $this->connection->query('SELECT * FROM {test_one_blob} WHERE [id] = :id', [':id' => $id])->fetchAssoc();
$this->assertNull($r['blob1']);
$r = $this->connection->query('SELECT * FROM {test_one_blob} WHERE [id] = :id', [':id' => $id + 1])->fetchAssoc();
$this->assertNull($r['blob1']);
}
}