#110490Remove absolute path resolving of PKG: system resource identifiers
Description
Problem
- 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
Related issues 1
History 12
-
Stefan Bürk changed Related to #110440 <span data-processor="relativetime" data-value="2026-08-15T15:23:27+00:00" > 08/15/26, 15:23 </span>
-
Gerrit Code Review pushed patch set 1 for main to change 95342 status
NewUnder Review <span data-processor="relativetime" data-value="2026-08-15T16:23:29+00:00" > 08/15/26, 16:23 </span>