interface EnvironmentCleanerInterface

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

Defines an interface for cleaning up test results and fixtures.

This interface is marked internal. It does not imply an API.

@todo Formalize this interface in https://www.drupal.org/project/drupal/issues/3075490

@internal

Hierarchy

Expanded class hierarchy of EnvironmentCleanerInterface

All classes that implement EnvironmentCleanerInterface

See also

https://www.drupal.org/project/drupal/issues/3075490

File

core/lib/Drupal/Core/Test/EnvironmentCleanerInterface.php, line 17

Namespace

Drupal\Core\Test
View source
interface EnvironmentCleanerInterface {
  
  /**
   * Removes all test-related database tables and directories.
   *
   * This method removes fixture files and database entries from the system
   * under test.
   *
   * @param bool $clear_results
   *   (optional) Whether to clear the test results storage. Defaults to TRUE.
   * @param bool $clear_temp_directories
   *   (optional) Whether to clear the test site directories. Defaults to TRUE.
   * @param bool $clear_database
   *   (optional) Whether to clean up the fixture database. Defaults to TRUE.
   */
  public function cleanEnvironment(bool $clear_results = TRUE, bool $clear_temp_directories = TRUE, bool $clear_database = TRUE) : void;
  
  /**
   * Remove database entries left over in the fixture database.
   */
  public function cleanDatabase() : void;
  
  /**
   * Finds all leftover fixture site directories and removes them.
   */
  public function cleanTemporaryDirectories() : void;
  
  /**
   * Clears test results from the results storage.
   *
   * @param \Drupal\Core\Test\TestRun $test_run
   *   The test run object to remove results for, or NULL to remove all
   *   results.
   *
   * @return int
   *   The number of results that were removed.
   */
  public function cleanResults(?TestRun $test_run = NULL) : int;

}

Members

Title Sort descending Modifiers Object type Summary Overrides
EnvironmentCleanerInterface::cleanDatabase public function Remove database entries left over in the fixture database. 1
EnvironmentCleanerInterface::cleanEnvironment public function Removes all test-related database tables and directories. 1
EnvironmentCleanerInterface::cleanResults public function Clears test results from the results storage. 1
EnvironmentCleanerInterface::cleanTemporaryDirectories public function Finds all leftover fixture site directories and removes them. 1

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