3 namespace Drupal\Tests\Core\Extension;
5 use Drupal\Core\Extension\Extension;
6 use Drupal\Core\Extension\ExtensionDiscovery;
7 use Drupal\Tests\UnitTestCase;
8 use org\bovigo\vfs\vfsStream;
9 use Symfony\Component\Yaml\Yaml;
12 * Tests discovery of extensions.
14 * @coversDefaultClass \Drupal\Core\Extension\ExtensionDiscovery
17 class ExtensionDiscoveryTest extends UnitTestCase {
20 * Tests extension discovery in a virtual filesystem with vfsStream.
24 public function testExtensionDiscoveryVfs() {
26 // Set up the file system.
28 $files_by_type_and_name_expected = $this->populateFilesystemStructure($filesystem);
30 $vfs = vfsStream::setup('root', NULL, $filesystem);
33 $this->assertFileExists($root . '/core/modules/system/system.module');
34 $this->assertFileExists($root . '/core/modules/system/system.info.yml');
36 // Create an ExtensionDiscovery with $root.
37 $extension_discovery = new ExtensionDiscovery($root, FALSE, NULL, 'sites/default');
39 /** @var \Drupal\Core\Extension\Extension[][] $extensions_by_type */
40 $extensions_by_type = [];
41 $files_by_type_and_name = [];
42 foreach (['profile', 'module', 'theme', 'theme_engine'] as $type) {
43 $extensions_by_type[$type] = $extension_discovery->scan($type, FALSE);
44 foreach ($extensions_by_type[$type] as $name => $extension) {
45 $files_by_type_and_name[$type][$name] = $extension->getPathname();
47 if ($type === 'profile') {
48 // Set profile directories for discovery of the other extension types.
49 $extension_discovery->setProfileDirectories(['myprofile' => 'profiles/myprofile']);
53 $this->assertEquals($files_by_type_and_name_expected, $files_by_type_and_name);
55 $extension_expected = new Extension($root, 'module', 'core/modules/system/system.info.yml', 'system.module');
56 $extension_expected->subpath = 'modules/system';
57 $extension_expected->origin = 'core';
58 $this->assertEquals($extension_expected, $extensions_by_type['module']['system'], 'system');
60 $extension_expected = new Extension($root, 'theme_engine', 'core/themes/engines/twig/twig.info.yml', 'twig.engine');
61 $extension_expected->subpath = 'themes/engines/twig';
62 $extension_expected->origin = 'core';
63 $this->assertEquals($extension_expected, $extensions_by_type['theme_engine']['twig'], 'twig');
67 * Adds example files to the filesystem structure.
69 * @param array $filesystem_structure
72 * Format: $[$type][$name] = $yml_file
73 * E.g. $['module']['system'] = 'system.info.yml'
75 protected function populateFilesystemStructure(array &$filesystem_structure) {
77 'core/profiles/standard/standard.info.yml' => [
80 'core/profiles/minimal/minimal.info.yml' => [
83 // Override the core instance of the 'minimal' profile.
84 'sites/default/profiles/minimal/minimal.info.yml' => [
87 'profiles/myprofile/myprofile.info.yml' => [
90 'profiles/myprofile/modules/myprofile_nested_module/myprofile_nested_module.info.yml' => [],
91 'profiles/otherprofile/otherprofile.info.yml' => [
94 'core/modules/user/user.info.yml' => [],
95 'profiles/otherprofile/modules/otherprofile_nested_module/otherprofile_nested_module.info.yml' => [],
96 'core/modules/system/system.info.yml' => [],
97 'core/themes/seven/seven.info.yml' => [
100 // Override the core instance of the 'seven' theme.
101 'sites/default/themes/seven/seven.info.yml' => [
104 'modules/devel/devel.info.yml' => [],
105 'modules/poorly_placed_theme/poorly_placed_theme.info.yml' => [
108 'core/themes/engines/twig/twig.info.yml' => [
109 'type' => 'theme_engine',
113 $files_by_type_and_name_expected = [];
114 $content_by_file = [];
115 foreach ($info_by_file as $file => $info) {
116 $name = basename($file, '.info.yml');
119 'name' => "Name of ($name)",
122 $type = $info['type'];
123 $content_by_file[$file] = Yaml::dump($info);
124 $files_by_type_and_name_expected[$type][$name] = $file;
127 $content_by_file['core/modules/system/system.module'] = '<?php';
128 $content_by_file['core/themes/engines/twig/twig.engine'] = '<?php';
130 foreach ($content_by_file as $file => $content) {
131 $pieces = explode('/', $file);
132 $this->addFileToFilesystemStructure($filesystem_structure, $pieces, $content);
135 unset($files_by_type_and_name_expected['module']['otherprofile_nested_module']);
137 return $files_by_type_and_name_expected;
141 * @param array $filesystem_structure
142 * @param string[] $pieces
143 * Fragments of the file path.
144 * @param string $content
146 protected function addFileToFilesystemStructure(array &$filesystem_structure, array $pieces, $content) {
147 $piece = array_shift($pieces);
148 if ($pieces !== []) {
149 $filesystem_structure += [$piece => []];
150 $this->addFileToFilesystemStructure($filesystem_structure[$piece], $pieces, $content);
153 $filesystem_structure[$piece] = $content;