Deprecation: #99810 - "versionNumberInFilename" option now boolean

See forge#99810

Description

The system-wide setting $TYPO3_CONF_VARS[FE][versionNumberInFilename] was previously evaluated as a "string" value, having three possible options:

  • ""

  • "querystring"

  • "embed"

Depending on the option, resources used in TYPO3's Frontend templates, such as JavaScript or CSS assets, had their "modification time" in either the querystring ("myfile.js?1675703622"), or in the file name itself "myfile.1675703622.js" - the "embed" option). The latter option required a .htaccess rule.

This existing feature ("cachebusting") is especially important for proxy / CDN setups.

For the sake of simplicity, the option is now a boolean option - and behaves similar to the backend-variant $TYPO3_CONF_VARS[BE][versionNumberInFilename].

Impact

If the option is now set to "false", it behaves as "querystring" before, setting it to "true", the feature behaves exactly to "embed". The original empty option is removed, so all assets within the TYPO3 frontend rendering always include cachebusting, by default a querystring, which is fully backwards-compatible.

Affected installations

TYPO3 installations that have actively set this option in LocalConfiguration.php, AdditionalConfiguration.php or in an extensions' ext_localconf.php.

Migration

When updating TYPO3 and accessing the maintenance area, an explicitly set option is automatically migrated. If this is not possible - e.g. configuration in AdditionalConfiguration.php is set - the value is always migrated on-the-fly when the setting is evaluated.