class EnvironmentCleaner

Same name and namespace in other branches
  1. 9 core/lib/Drupal/Core/Test/EnvironmentCleaner.php \Drupal\Core\Test\EnvironmentCleaner
  2. 8.9.x core/lib/Drupal/Core/Test/EnvironmentCleaner.php \Drupal\Core\Test\EnvironmentCleaner
  3. 11.x core/lib/Drupal/Core/Test/EnvironmentCleaner.php \Drupal\Core\Test\EnvironmentCleaner

Helper class for cleaning test environments.

@internal

Hierarchy

Expanded class hierarchy of EnvironmentCleaner

1 file declares its use of EnvironmentCleaner
EnvironmentCleanerTest.php in core/tests/Drupal/KernelTests/Core/Test/EnvironmentCleanerTest.php

File

core/lib/Drupal/Core/Test/EnvironmentCleaner.php, line 14

Namespace

Drupal\Core\Test
View source
class EnvironmentCleaner implements EnvironmentCleanerInterface {
  
  /**
   * Constructs a test environment cleaner.
   *
   * @param string $root
   *   The path to the root of the Drupal installation.
   * @param \Drupal\Core\Database\Connection $testDatabase
   *   Connection to the database against which tests were run.
   * @param \Drupal\Core\Test\TestRunResultsStorageInterface $testRunResultsStorage
   *   The test run results storage.
   * @param \Symfony\Component\Console\Output\OutputInterface $output
   *   A Symfony console output object.
   * @param \Drupal\Core\File\FileSystemInterface $fileSystem
   *   Drupal's file_system service.
   */
  public function __construct(protected string $root, protected Connection $testDatabase, protected TestRunResultsStorageInterface $testRunResultsStorage, protected OutputInterface $output, protected FileSystemInterface $fileSystem) {
  }
  
  /**
   * {@inheritdoc}
   */
  public function cleanEnvironment(bool $clear_results = TRUE, bool $clear_temp_directories = TRUE, bool $clear_database = TRUE) : void {
    $count = 0;
    if ($clear_database) {
      $this->doCleanDatabase();
    }
    if ($clear_temp_directories) {
      $this->doCleanTemporaryDirectories();
    }
    if ($clear_results) {
      $count = $this->cleanResults();
      $this->output
        ->write('Test results removed: ' . $count);
    }
    else {
      $this->output
        ->write('Test results were not removed.');
    }
  }
  
  /**
   * {@inheritdoc}
   */
  public function cleanDatabase() : void {
    $count = $this->doCleanDatabase();
    if ($count > 0) {
      $this->output
        ->write('Leftover tables removed: ' . $count);
    }
    else {
      $this->output
        ->write('No leftover tables to remove.');
    }
  }
  
  /**
   * Performs the fixture database cleanup.
   *
   * @return int
   *   The number of tables that were removed.
   */
  protected function doCleanDatabase() : int {
    /** @var \Drupal\Core\Database\Schema $schema */
    $schema = $this->testDatabase
      ->schema();
    $tables = $schema->findTables('test%');
    $count = 0;
    foreach ($tables as $table) {
      // Only drop tables which begin wih 'test' followed by digits, for example,
      // {test12345678node__body}.
      if (preg_match('/^test\\d+.*/', $table, $matches)) {
        $schema->dropTable($matches[0]);
        $count++;
      }
    }
    return $count;
  }
  
  /**
   * {@inheritdoc}
   */
  public function cleanTemporaryDirectories() : void {
    $count = $this->doCleanTemporaryDirectories();
    if ($count > 0) {
      $this->output
        ->write('Temporary directories removed: ' . $count);
    }
    else {
      $this->output
        ->write('No temporary directories to remove.');
    }
  }
  
  /**
   * Performs the cleanup of temporary test directories.
   *
   * @return int
   *   The count of temporary directories removed.
   */
  protected function doCleanTemporaryDirectories() : int {
    $count = 0;
    $simpletest_dir = $this->root . '/sites/simpletest';
    if (is_dir($simpletest_dir)) {
      $files = scandir($simpletest_dir);
      foreach ($files as $file) {
        if ($file[0] != '.') {
          $path = $simpletest_dir . '/' . $file;
          $this->fileSystem
            ->deleteRecursive($path, function ($any_path) {
            @chmod($any_path, 0700);
          });
          $count++;
        }
      }
    }
    return $count;
  }
  
  /**
   * {@inheritdoc}
   */
  public function cleanResults(?TestRun $test_run = NULL) : int {
    return $test_run ? $test_run->removeResults() : $this->testRunResultsStorage
      ->cleanUp();
  }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
EnvironmentCleaner::cleanDatabase public function Remove database entries left over in the fixture database. Overrides EnvironmentCleanerInterface::cleanDatabase
EnvironmentCleaner::cleanEnvironment public function Removes all test-related database tables and directories. Overrides EnvironmentCleanerInterface::cleanEnvironment
EnvironmentCleaner::cleanResults public function Clears test results from the results storage. Overrides EnvironmentCleanerInterface::cleanResults
EnvironmentCleaner::cleanTemporaryDirectories public function Finds all leftover fixture site directories and removes them. Overrides EnvironmentCleanerInterface::cleanTemporaryDirectories
EnvironmentCleaner::doCleanDatabase protected function Performs the fixture database cleanup.
EnvironmentCleaner::doCleanTemporaryDirectories protected function Performs the cleanup of temporary test directories.
EnvironmentCleaner::__construct public function Constructs a test environment cleaner.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.