
| 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/FetchTest.php |
<?php
declare(strict_types=1);
namespace Drupal\KernelTests\Core\Database;
use Drupal\Core\Database\RowCountException;
use Drupal\Core\Database\StatementInterface;
use Drupal\Tests\system\Functional\Database\FakeRecord;
/**
* Tests the Database system's various fetch capabilities.
*
* We get timeout errors if we try to run too many tests at once.
*
* @group Database
*/
class FetchTest extends DatabaseTestBase {
/**
* Confirms that we can fetch a record properly in default object mode.
*/
public function testQueryFetchDefault(): void {
$records = [];
$result = $this->connection->query('SELECT [name] FROM {test} WHERE [age] = :age', [':age' => 25]);
$this->assertInstanceOf(StatementInterface::class, $result);
foreach ($result as $record) {
$records[] = $record;
$this->assertIsObject($record);
$this->assertSame('John', $record->name);
}
$this->assertCount(1, $records, 'There is only one record.');
}
/**
* Confirms that we can fetch a record to an object explicitly.
*/
public function testQueryFetchObject(): void {
$records = [];
$result = $this->connection->query('SELECT [name] FROM {test} WHERE [age] = :age', [':age' => 25], ['fetch' => \PDO::FETCH_OBJ]);
foreach ($result as $record) {
$records[] = $record;
$this->assertIsObject($record);
$this->assertSame('John', $record->name);
}
$this->assertCount(1, $records, 'There is only one record.');
}
/**
* Confirms that we can fetch a record to an associative array explicitly.
*/
public function testQueryFetchArray(): void {
$records = [];
$result = $this->connection->query('SELECT [name] FROM {test} WHERE [age] = :age', [':age' => 25], ['fetch' => \PDO::FETCH_ASSOC]);
foreach ($result as $record) {
$records[] = $record;
$this->assertIsArray($record);
$this->assertArrayHasKey('name', $record);
$this->assertSame('John', $record['name']);
}
$this->assertCount(1, $records, 'There is only one record.');
}
/**
* Confirms that we can fetch a record into a new instance of a custom class.
*
* @see \Drupal\system\Tests\Database\FakeRecord
*/
public function testQueryFetchClass(): void {
$records = [];
$result = $this->connection->query('SELECT [name] FROM {test} WHERE [age] = :age', [':age' => 25], ['fetch' => FakeRecord::class]);
foreach ($result as $record) {
$records[] = $record;
$this->assertInstanceOf(FakeRecord::class, $record);
$this->assertSame('John', $record->name);
}
$this->assertCount(1, $records, 'There is only one record.');
}
/**
* Confirms that we can fetch a record into a class using fetchObject.
*
* @see \Drupal\Tests\system\Functional\Database\FakeRecord
* @see \Drupal\Core\Database\StatementPrefetch::fetchObject
*/
public function testQueryFetchObjectClass(): void {
$records = 0;
$query = $this->connection->query('SELECT [name] FROM {test} WHERE [age] = :age', [':age' => 25]);
while ($result = $query->fetchObject(FakeRecord::class, [1])) {
$records += 1;
$this->assertInstanceOf(FakeRecord::class, $result);
$this->assertSame('John', $result->name, '25 year old is John.');
$this->assertSame(1, $result->fakeArg, 'The record has received an argument through its constructor.');
}
$this->assertSame(1, $records, 'There is only one record.');
}
/**
* Confirms that we can fetch a record into a class without constructor args.
*
* @see \Drupal\Tests\system\Functional\Database\FakeRecord
* @see \Drupal\Core\Database\StatementPrefetch::fetchObject
*/
public function testQueryFetchObjectClassNoConstructorArgs(): void {
$records = 0;
$query = $this->connection->query('SELECT [name] FROM {test} WHERE [age] = :age', [':age' => 25]);
while ($result = $query->fetchObject(FakeRecord::class)) {
$records += 1;
$this->assertInstanceOf(FakeRecord::class, $result);
$this->assertSame('John', $result->name);
$this->assertSame(0, $result->fakeArg);
}
$this->assertSame(1, $records);
}
/**
* Confirms that we can fetch a record into a new instance of a custom class.
*
* The name of the class is determined from a value of the first column.
*
* @see \Drupal\Tests\system\Functional\Database\FakeRecord
*
* @group legacy
*/
public function testQueryFetchClasstype(): void {
$this->expectDeprecation('Fetch mode FETCH_CLASS | FETCH_CLASSTYPE is deprecated in drupal:10.2.0 and is removed from drupal:11.0.0. Use supported modes only. See https://www.drupal.org/node/3377999');
$records = [];
$result = $this->connection->query('SELECT [classname], [name], [job] FROM {test_classtype} WHERE [age] = :age', [':age' => 26], ['fetch' => \PDO::FETCH_CLASS | \PDO::FETCH_CLASSTYPE]);
foreach ($result as $record) {
$records[] = $record;
$this->assertInstanceOf(FakeRecord::class, $record);
$this->assertSame('Kay', $record->name);
$this->assertSame('Web Developer', $record->job);
$this->assertFalse(isset($record->classname), 'Classname field not found, as intended.');
}
$this->assertCount(1, $records, 'There is only one record.');
}
/**
* Confirms that we can fetch a record into an indexed array explicitly.
*/
public function testQueryFetchNum(): void {
$records = [];
$result = $this->connection->query('SELECT [name] FROM {test} WHERE [age] = :age', [':age' => 25], ['fetch' => \PDO::FETCH_NUM]);
foreach ($result as $record) {
$records[] = $record;
$this->assertIsArray($record);
$this->assertArrayHasKey(0, $record);
$this->assertSame('John', $record[0]);
}
$this->assertCount(1, $records, 'There is only one record');
}
/**
* Confirms that we can fetch a record into a doubly-keyed array explicitly.
*
* @group legacy
*/
public function testQueryFetchBoth(): void {
$this->expectDeprecation('Fetch mode FETCH_BOTH is deprecated in drupal:10.2.0 and is removed from drupal:11.0.0. Use supported modes only. See https://www.drupal.org/node/3377999');
$records = [];
$result = $this->connection->query('SELECT [name] FROM {test} WHERE [age] = :age', [':age' => 25], ['fetch' => \PDO::FETCH_BOTH]);
foreach ($result as $record) {
$records[] = $record;
$this->assertIsArray($record);
$this->assertArrayHasKey(0, $record);
$this->assertSame('John', $record[0]);
$this->assertArrayHasKey('name', $record);
$this->assertSame('John', $record['name']);
}
$this->assertCount(1, $records, 'There is only one record.');
}
/**
* Confirms that we can fetch all records into an array explicitly.
*/
public function testQueryFetchAllColumn(): void {
$query = $this->connection->select('test');
$query->addField('test', 'name');
$query->orderBy('name');
$query_result = $query->execute()->fetchAll(\PDO::FETCH_COLUMN);
$expected_result = ['George', 'John', 'Paul', 'Ringo'];
$this->assertEquals($expected_result, $query_result, 'Returned the correct result.');
}
/**
* Confirms that we can fetch an entire column of a result set at once.
*/
public function testQueryFetchCol(): void {
$result = $this->connection->query('SELECT [name] FROM {test} WHERE [age] > :age', [':age' => 25]);
$column = $result->fetchCol();
$this->assertCount(3, $column, 'fetchCol() returns the right number of records.');
$result = $this->connection->query('SELECT [name] FROM {test} WHERE [age] > :age', [':age' => 25]);
$i = 0;
foreach ($result as $record) {
$this->assertSame($column[$i++], $record->name, 'Column matches direct access.');
}
}
/**
* Tests ::fetchAllAssoc().
*/
public function testQueryFetchAllAssoc(): void {
$expected_result = [
"Singer" => [
"id" => "2",
"name" => "George",
"age" => "27",
"job" => "Singer",
],
"Drummer" => [
"id" => "3",
"name" => "Ringo",
"age" => "28",
"job" => "Drummer",
],
];
$statement = $this->connection->query('SELECT * FROM {test} WHERE [age] > :age', [':age' => 26]);
$result = $statement->fetchAllAssoc('job', \PDO::FETCH_ASSOC);
$this->assertSame($expected_result, $result);
$statement = $this->connection->query('SELECT * FROM {test} WHERE [age] > :age', [':age' => 26]);
$result = $statement->fetchAllAssoc('job', \PDO::FETCH_OBJ);
$this->assertEquals((object) $expected_result['Singer'], $result['Singer']);
$this->assertEquals((object) $expected_result['Drummer'], $result['Drummer']);
}
/**
* Tests ::fetchField().
*/
public function testQueryFetchField(): void {
$this->connection->insert('test')
->fields([
'name' => 'Foo',
'age' => 0,
'job' => 'Dummy',
])
->execute();
$this->connection->insert('test')
->fields([
'name' => 'Kurt',
'age' => 27,
'job' => 'Singer',
])
->execute();
$expectedResults = ['25', '27', '28', '26', '0', '27'];
$statement = $this->connection->select('test')
->fields('test', ['age'])
->orderBy('id')
->execute();
$actualResults = [];
while (TRUE) {
$result = $statement->fetchField();
if ($result === FALSE) {
break;
}
$this->assertIsNumeric($result);
$actualResults[] = $result;
}
$this->assertSame($expectedResults, $actualResults);
}
/**
* Tests that rowCount() throws exception on SELECT query.
*/
public function testRowCount(): void {
$result = $this->connection->query('SELECT [name] FROM {test}');
try {
$result->rowCount();
$exception = FALSE;
}
catch (RowCountException $e) {
$exception = TRUE;
}
$this->assertTrue($exception, 'Exception was thrown');
}
}