class SystemListingTest

Same name and namespace in other branches
  1. 11.x core/modules/system/tests/src/Kernel/Common/SystemListingTest.php \Drupal\Tests\system\Kernel\Common\SystemListingTest
  2. 10 core/modules/system/tests/src/Kernel/Common/SystemListingTest.php \Drupal\Tests\system\Kernel\Common\SystemListingTest
  3. 8.9.x core/modules/system/tests/src/Kernel/Common/SystemListingTest.php \Drupal\Tests\system\Kernel\Common\SystemListingTest

Tests scanning system directories in drupal_system_listing().

@group Common

Hierarchy

Expanded class hierarchy of SystemListingTest

File

core/modules/system/tests/src/Kernel/Common/SystemListingTest.php, line 14

Namespace

Drupal\Tests\system\Kernel\Common
View source
class SystemListingTest extends KernelTestBase {
  
  /**
   * Tests that files in different directories take precedence as expected.
   */
  public function testDirectoryPrecedence() {
    // Define the module files we will search for, and the directory precedence
    // we expect.
    $expected_directories = [
      // When both copies of the module are compatible with Drupal core, the
      // copy in the profile directory takes precedence.
'drupal_system_listing_compatible_test' => [
        'core/profiles/testing/modules',
        'core/modules/system/tests/modules',
      ],
    ];
    // This test relies on two versions of the same module existing in
    // different places in the filesystem. Without that, the test has no
    // meaning, so assert their presence first.
    foreach ($expected_directories as $module => $directories) {
      foreach ($directories as $directory) {
        $filename = "{$directory}/{$module}/{$module}.info.yml";
        $this->assertFileExists($this->root . '/' . $filename);
      }
    }
    // Now scan the directories and check that the files take precedence as
    // expected.
    $listing = new ExtensionDiscovery($this->root);
    $listing->setProfileDirectories([
      'core/profiles/testing',
    ]);
    $files = $listing->scan('module');
    foreach ($expected_directories as $module => $directories) {
      $expected_directory = array_shift($directories);
      $expected_uri = "{$expected_directory}/{$module}/{$module}.info.yml";
      $this->assertEquals($expected_uri, $files[$module]->getPathname(), new FormattableMarkup('Module @actual was found at @expected.', [
        '@actual' => $files[$module]->getPathname(),
        '@expected' => $expected_uri,
      ]));
    }
  }
  
  /**
   * Tests that directories matching file_scan_ignore_directories are ignored.
   */
  public function testFileScanIgnoreDirectory() {
    $listing = new ExtensionDiscovery($this->root, FALSE);
    $listing->setProfileDirectories([
      'core/profiles/testing',
    ]);
    $files = $listing->scan('module');
    $this->assertArrayHasKey('drupal_system_listing_compatible_test', $files);
    // Reset the static to force a re-scan of the directories.
    $reflected_class = new \ReflectionClass(ExtensionDiscovery::class);
    $reflected_property = $reflected_class->getProperty('files');
    $reflected_property->setAccessible(TRUE);
    $reflected_property->setValue($reflected_class, []);
    $this->setSetting('file_scan_ignore_directories', [
      'drupal_system_listing_compatible_test',
    ]);
    $listing = new ExtensionDiscovery($this->root, FALSE);
    $listing->setProfileDirectories([
      'core/profiles/testing',
    ]);
    $files = $listing->scan('module');
    $this->assertArrayNotHasKey('drupal_system_listing_compatible_test', $files);
  }

}

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