NEW Get the version for an individual module

_config/cache.yml

@@ -42,3 +42,7 @@ SilverStripe\Core\Injector\Injector:
     constructor:
       namespace: 'EmbedShortcodeProvider'
       defaultLifetime: 86400
+  Psr\SimpleCache\CacheInterface.VersionProvider:
+    factory: SilverStripe\Core\Cache\CacheFactory
+    constructor:
+      namespace: 'VersionProvider'

docs/en/02_Developer_Guides/01_Templates/02_Common_Variables.md

@@ -123,18 +123,18 @@ on a per-page basis.
 If you don’t want to include the title tag use `$MetaTags(false)`.
 [/notice]
 
-By default `$MetaTags` renders:
+By default `$MetaTags` renders (assuming 4.11.0 is the current version of silverstripe/framework):
 
 ```ss
 <title>Title of the Page</title>
-<meta name="generator" content="SilverStripe - https://www.silverstripe.org">
+<meta name="generator" content="Silverstripe CMS 4.11">
 <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
 ```
 
 `$MetaTags(false)` will render
 
 ```ss
-<meta name="generator" content="SilverStripe - https://www.silverstripe.org">
+<meta name="generator" content="Silverstripe CMS 4.11">
 <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
 ```
 
@@ -145,6 +145,20 @@ $MetaTags(false)
 <title>$Title - Bob's Fantasy Football</title>
 ```
 
+### Disabling the meta generator tag
+
+The meta generator tag includes the current version of `silverstripe/framework`. This version number
+provides aggregate installation numbers to the product team who maintain Silverstripe CMS which is
+used to make informed product decisions.
+
+If it's felt this creates a security concern for your website, then the version portion of the meta
+generator tag can be disabled via yaml configuration:
+
+```yml
+SilverStripe\CMS\Model\SiteTree:
+  show_meta_generator_version: false
+```
+
 ### Modifying Meta Tags
 
 You can override the `MetaComponents()` method on your `SiteTree` sub-classes or make use of the `MetaComponents` extension point to manipulate the underlying data that is rendered by `$MetaTags`. Example (for `Page` class):

docs/en/04_Changelogs/4.11.0.md

@@ -21,6 +21,19 @@ In accordance with our [PHP support policy](/Getting_Started/Server_Requirements
 
 ## Features and enhancements {#features-and-enhancements}
 
+### Meta generator tag now shows framework version number
+
+The meta generator tag, which can be seen in the meta tags when you view source on a regular page, now includes the framework version truncated to show just the major and minor version, e.g. 4.11. 
+
+This version number will provide aggregate installation numbers to the product team who maintain Silverstripe CMS which will be used to make informed product decisions.
+
+If it's felt this creates a security concern for your website, then the version portion of the meta
+generator tag can be configured off via
+
+```yml
+SilverStripe\CMS\Model\SiteTree:
+  show_meta_generator_version: false
+```
 
 ## Bugfixes {#bugfixes}
 

src/Core/Manifest/VersionProvider.php

@@ -2,10 +2,11 @@
 
 namespace SilverStripe\Core\Manifest;
 
+use InvalidArgumentException;
 use SilverStripe\Core\Config\Config;
 use Psr\SimpleCache\CacheInterface;
 use SilverStripe\Core\Config\Configurable;
-use SilverStripe\Core\Convert;
+use SilverStripe\Core\Injector\Injectable;
 use SilverStripe\Core\Injector\Injector;
 
 /**
@@ -25,8 +26,8 @@
  */
 class VersionProvider
 {
-
     use Configurable;
+    use Injectable;
 
     /**
      * @var array
@@ -43,6 +44,11 @@ class VersionProvider
      */
     public function getVersion()
     {
+        $key = sprintf('%s-%s', $this->getComposerLockPath(), 'all');
+        $version = $this->getCachedValue($key);
+        if ($version) {
+            return $version;
+        }
         $modules = $this->getModules();
         $lockModules = $this->getModuleVersionFromComposer(array_keys($modules));
         $moduleVersions = [];
@@ -59,7 +65,70 @@ public function getVersion()
             list($title, $version) = $value;
             $ret[] = "$title: $version";
         }
-        return implode(', ', $ret);
+        $version = implode(', ', $ret);
+        $this->setCacheValue($key, $version);
+        return $version;
+    }
+
+    /**
+     * Get the version of a specific module
+     * Will strip out the leading "module name" from the returned value
+     *
+     * @param string $module - e.g. silverstripe/framework
+     * @return string - e.g. 4.10
+     */
+    public function getModuleVersion(string $module): string
+    {
+        $key = sprintf('%s-%s', $this->getComposerLockPath(), $module);
+        $version = $this->getCachedValue($key);
+        if ($version) {
+            return $version;
+        }
+        $previousModules = $this->getModules();
+        Config::modify()->set(self::class, 'modules', [$module => 'MODULE_NAME']);
+        $version = $this->getVersion();
+        $version = str_replace('MODULE_NAME: ', '', $version);
+        Config::modify()->set(self::class, 'modules', $previousModules);
+        $this->setCacheValue($key, $version);
+        return $version;
+    }
+
+    /**
+     * @return CacheInterface
+     */
+    private function getCache(): CacheInterface
+    {
+        return Injector::inst()->get(CacheInterface::class . '.VersionProvider');
+    }
+
+    /**
+     * @param string $key
+     *
+     * @return string
+     */
+    private function getCachedValue(string $key): string
+    {
+        $cache = $this->getCache();
+        try {
+            if ($cache->has($key)) {
+                return $cache->get($key);
+            }
+        } catch (InvalidArgumentException $e) {
+        }
+        return '';
+    }
+
+    /**
+     * @param string $key
+     * @param string $value
+     */
+    private function setCacheValue(string $key, string $value): void
+    {
+        $cache = $this->getCache();
+        try {
+            $cache->set($key, $value);
+        } catch (InvalidArgumentException $e) {
+        }
     }
 
     /**

tests/php/Core/Manifest/VersionProviderTest.php

@@ -188,4 +188,18 @@ public function testGetModulesFromComposerLock()
         $result = $mock->getVersion();
         $this->assertStringContainsString('Some Package: 1.2.3', $result);
     }
+
+    public function testGetModuleVersion()
+    {
+        $provider = $this->getMockProvider(__DIR__ . '/fixtures/VersionProviderTest/composer.recipe-core.testlock');
+        Config::modify()->set(VersionProvider::class, 'modules', [
+            'silverstripe/framework' => 'Framework',
+            'silverstripe/recipe-core' => 'Core Recipe'
+        ]);
+        $this->assertSame('1.2.3', $provider->getModuleVersion('silverstripe/framework'));
+        // assert that the temporary config changes in getModuleVersion() had no side-effects
+        $result = $provider->getVersion();
+        $this->assertStringNotContainsString('Framework: 1.2.3', $result);
+        $this->assertStringContainsString('Core Recipe: 7.7.7', $result);
+    }
 }