REDROOM

Navigation

Breadcrumbs

/ / home / ecopackply / www / demo / system / Test

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 9.70 KB

/home/ecopackply/www/demo/system/Test/DatabaseTestTrait.php

Text Base64

<?php

declare(strict_types=1);

/**
 * This file is part of CodeIgniter 4 framework.
 *
 * (c) CodeIgniter Foundation <admin@codeigniter.com>
 *
 * For the full copyright and license information, please view
 * the LICENSE file that was distributed with this source code.
 */

namespace CodeIgniter\Test;

use CodeIgniter\Database\BaseBuilder;
use CodeIgniter\Database\BaseConnection;
use CodeIgniter\Database\Exceptions\DatabaseException;
use CodeIgniter\Database\MigrationRunner;
use CodeIgniter\Database\Seeder;
use CodeIgniter\Test\Constraints\SeeInDatabase;
use Config\Database;
use Config\Migrations;
use PHPUnit\Framework\Attributes\AfterClass;

/**
 * DatabaseTestTrait
 *
 * Provides functionality for refreshing/seeding
 * the database during testing.
 *
 * @property BaseConnection                 $db
 * @property list<array<int|string, mixed>> $insertCache
 * @property Seeder|null                    $seeder
 * @property MigrationRunner|null           $migrations
 * @property list<string>|string|null       $namespace
 *
 * @mixin CIUnitTestCase
 */
trait DatabaseTestTrait
{
    /**
     * Is db migration done once or more than once?
     *
     * @var bool
     */
    private static $doneMigration = false;

/**
     * Is seeding done once or more than once?
     *
     * @var bool
     */
    private static $doneSeed = false;

// --------------------------------------------------------------------
    // Staging
    // --------------------------------------------------------------------

/**
     * Runs the trait set up methods.
     *
     * @return void
     */
    protected function setUpDatabase()
    {
        $this->loadDependencies();
        $this->setUpMigrate();
        $this->setUpSeed();
    }

/**
     * Runs the trait set up methods.
     *
     * @return void
     */
    protected function tearDownDatabase()
    {
        $this->clearInsertCache();
    }

/**
     * Load any database test dependencies.
     *
     * @return void
     */
    public function loadDependencies()
    {
        if ($this->db === null) {
            $this->db = Database::connect($this->DBGroup);
            $this->db->initialize();
        }

if ($this->migrations === null) {
            // Ensure that we can run migrations
            $config          = new Migrations();
            $config->enabled = true;

$this->migrations = service('migrations', $config, $this->db, false);
            $this->migrations->setSilent(false);
        }

if ($this->seeder === null) {
            $this->seeder = Database::seeder($this->DBGroup);
            $this->seeder->setSilent(true);
        }
    }

// --------------------------------------------------------------------
    // Migrations
    // --------------------------------------------------------------------

/**
     * Migrate on setUp
     *
     * @return void
     */
    protected function setUpMigrate()
    {
        if ($this->migrateOnce === false || self::$doneMigration === false) {
            if ($this->refresh === true) {
                $this->regressDatabase();

// Reset counts on faked items
                Fabricator::resetCounts();
            }

$this->migrateDatabase();
        }
    }

/**
     * Regress migrations as defined by the class
     *
     * @return void
     */
    protected function regressDatabase()
    {
        if ($this->migrate === false) {
            return;
        }

// If no namespace was specified then rollback all
        if ($this->namespace === null) {
            $this->migrations->setNamespace(null);
            $this->migrations->regress(0, 'tests');
        }

// Regress each specified namespace
        else {
            $namespaces = is_array($this->namespace) ? $this->namespace : [$this->namespace];

foreach ($namespaces as $namespace) {
                $this->migrations->setNamespace($namespace);
                $this->migrations->regress(0, 'tests');
            }
        }
    }

/**
     * Run migrations as defined by the class
     *
     * @return void
     */
    protected function migrateDatabase()
    {
        if ($this->migrate === false) {
            return;
        }

// If no namespace was specified then migrate all
        if ($this->namespace === null) {
            $this->migrations->setNamespace(null);
            $this->migrations->latest('tests');
            self::$doneMigration = true;
        }
        // Run migrations for each specified namespace
        else {
            $namespaces = is_array($this->namespace) ? $this->namespace : [$this->namespace];

foreach ($namespaces as $namespace) {
                $this->migrations->setNamespace($namespace);
                $this->migrations->latest('tests');
                self::$doneMigration = true;
            }
        }
    }

// --------------------------------------------------------------------
    // Seeds
    // --------------------------------------------------------------------

/**
     * Seed on setUp
     *
     * @return void
     */
    protected function setUpSeed()
    {
        if ($this->seedOnce === false || self::$doneSeed === false) {
            $this->runSeeds();
        }
    }

/**
     * Run seeds as defined by the class
     *
     * @return void
     */
    protected function runSeeds()
    {
        if ($this->seed !== '') {
            if ($this->basePath !== '') {
                $this->seeder->setPath(rtrim($this->basePath, '/') . '/Seeds');
            }

$seeds = is_array($this->seed) ? $this->seed : [$this->seed];

foreach ($seeds as $seed) {
                $this->seed($seed);
            }
        }

self::$doneSeed = true;
    }

/**
     * Seeds that database with a specific seeder.
     *
     * @return void
     */
    public function seed(string $name)
    {
        $this->seeder->call($name);
    }

// --------------------------------------------------------------------
    // Utility
    // --------------------------------------------------------------------
    /**
     * Reset $doneMigration and $doneSeed
     *
     * @return void
     */
    #[AfterClass]
    public static function resetMigrationSeedCount()
    {
        self::$doneMigration = false;
        self::$doneSeed      = false;
    }

/**
     * Removes any rows inserted via $this->hasInDatabase()
     *
     * @return void
     */
    protected function clearInsertCache()
    {
        foreach ($this->insertCache as $row) {
            $this->db->table($row[0])
                ->where($row[1])
                ->delete();
        }
    }

/**
     * Loads the Builder class appropriate for the current database.
     *
     * @return BaseBuilder
     */
    public function loadBuilder(string $tableName)
    {
        $builderClass = str_replace('Connection', 'Builder', $this->db::class);

return new $builderClass($tableName, $this->db);
    }

/**
     * Fetches a single column from a database row with criteria
     * matching $where.
     *
     * @param array<string, mixed> $where
     *
     * @return bool
     *
     * @throws DatabaseException
     */
    public function grabFromDatabase(string $table, string $column, array $where)
    {
        $query = $this->db->table($table)
            ->select($column)
            ->where($where)
            ->get();

$query = $query->getRow();

return $query->{$column} ?? false;
    }

// --------------------------------------------------------------------
    // Assertions
    // --------------------------------------------------------------------

/**
     * Asserts that records that match the conditions in $where DO
     * exist in the database.
     *
     * @param array<string, mixed> $where
     *
     * @return void
     *
     * @throws DatabaseException
     */
    public function seeInDatabase(string $table, array $where)
    {
        $constraint = new SeeInDatabase($this->db, $where);
        static::assertThat($table, $constraint);
    }

/**
     * Asserts that records that match the conditions in $where do
     * not exist in the database.
     *
     * @param array<string, mixed> $where
     *
     * @return void
     */
    public function dontSeeInDatabase(string $table, array $where)
    {
        $count = $this->db->table($table)
            ->where($where)
            ->countAllResults();

$this->assertTrue($count === 0, 'Row was found in database');
    }

/**
     * Inserts a row into to the database. This row will be removed
     * after the test has run.
     *
     * @param array<string, mixed> $data
     *
     * @return bool
     */
    public function hasInDatabase(string $table, array $data)
    {
        $this->insertCache[] = [
            $table,
            $data,
        ];

return $this->db->table($table)->insert($data);
    }

/**
     * Asserts that the number of rows in the database that match $where
     * is equal to $expected.
     *
     * @param array<string, mixed> $where
     *
     * @return void
     *
     * @throws DatabaseException
     */
    public function seeNumRecords(int $expected, string $table, array $where)
    {
        $count = $this->db->table($table)
            ->where($where)
            ->countAllResults();

$this->assertEquals($expected, $count, 'Wrong number of matching rows in database.');
    }

/**
     * Sets $DBDebug to false.
     *
     * WARNING: this value will persist! take care to roll it back.
     */
    protected function disableDBDebug(): void
    {
        $this->setPrivateProperty($this->db, 'DBDebug', false);
    }

/**
     * Sets $DBDebug to true.
     */
    protected function enableDBDebug(): void
    {
        $this->setPrivateProperty($this->db, 'DBDebug', true);
    }
}

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 4 × Files: 15

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
Constraints DIR	-	drwxr-xr-x	2026-01-24 08:10:54	Edit Download recursive recursive
Filters DIR	-	drwxr-xr-x	2026-01-24 08:10:54	Edit Download recursive recursive
Interfaces DIR	-	drwxr-xr-x	2026-01-24 08:11:01	Edit Download recursive recursive
Mock DIR	-	drwxr-xr-x	2026-01-24 08:11:37	Edit Download recursive recursive
bootstrap.php	3.48 KB	lrw-r--r--	2026-01-24 08:03:33	Edit Download recursive recursive
CIUnitTestCase.php	13.61 KB	lrw-r--r--	2026-01-24 08:03:33	Edit Download recursive recursive
ConfigFromArrayTrait.php	1.09 KB	lrw-r--r--	2026-01-24 08:03:35	Edit Download recursive recursive
ControllerTestTrait.php	7.55 KB	lrw-r--r--	2026-01-24 08:03:35	Edit Download recursive recursive
DatabaseTestTrait.php	9.70 KB	lrw-r--r--	2026-01-24 08:03:37	Edit Download recursive recursive
DOMParser.php	7.84 KB	lrw-r--r--	2026-01-24 08:03:37	Edit Download recursive recursive
Fabricator.php	17.08 KB	lrw-r--r--	2026-01-24 08:03:39	Edit Download recursive recursive
FeatureTestTrait.php	11.82 KB	lrw-r--r--	2026-01-24 08:03:39	Edit Download recursive recursive
FilterTestTrait.php	9.19 KB	lrw-r--r--	2026-01-24 08:03:41	Edit Download recursive recursive
IniTestTrait.php	729 B	lrw-r--r--	2026-01-24 08:03:41	Edit Download recursive recursive
PhpStreamWrapper.php	1.57 KB	lrw-r--r--	2026-01-24 08:03:43	Edit Download recursive recursive
ReflectionHelper.php	2.47 KB	lrw-r--r--	2026-01-24 08:03:43	Edit Download recursive recursive
StreamFilterTrait.php	979 B	lrw-r--r--	2026-01-24 08:03:46	Edit Download recursive recursive
TestLogger.php	2.40 KB	lrw-r--r--	2026-01-24 08:03:46	Edit Download recursive recursive
TestResponse.php	13.51 KB	lrw-r--r--	2026-01-24 08:03:48	Edit Download recursive recursive