Issue Task Under Review Stale

#110490Remove absolute path resolving of PKG: system resource identifiers

Stefan Bürk 08/15/26, 15:23 updated 08/15/26, 16:23

Description

Problem

  1. introduced the System Resource API and the PKG: resource identifier syntax.
    #107907 then changed GeneralUtility::getFileAbsFileName to resolve resources through
    that API and deprecated obtaining an absolute file system path from a PKG: identifier.
    The deprecation message announces the removal for “TYPO3 v14 LTS”.

Both changes were pushed with “Releases: main” while main was 14.0.0-dev, so both
shipped in v14.0.0. Since v14.3 is the released LTS and main is 15.0.0-dev, the
announced milestone has passed without the removal happening. Something deprecated
in v14.0 can only be removed in v15.

In addition, no Deprecation changelog was ever written for #107907, so the
deprecation is undocumented.

Solution

Remove the deprecated behaviour on main:

  • ExtensionManagementUtility::resolvePackagePath throws an
    InvalidSystemResourceIdentifierException instead of triggering an
    E_USER_DEPRECATED when a PKG: identifier is given
  • GeneralUtility::getFileAbsFileName consequently returns an empty string for
    PKG: identifiers
  • add a Breaking changelog entry for 15.0

Impact

PKG: identifiers can no longer be used where TYPO3 resolves a resource string to an
absolute file system path, for example Fluid template root paths, XLIFF label files,
TypoScript and TSconfig file includes or TCA icon references. The EXT: syntax keeps
working in all of those places, and the System Resource API itself is unaffected.

Relation

Related to #110440, which makes the backend logo use the System Resource API and
thus avoids the deprecated code path. That one is a bugfix and gets backported to
14.3, therefore the removal is split off into this separate change for main only.

Reviews 1

History 12