#107907Handle package path also in getFileAbsFileName
Description
A change in the relation chain causes certain path types to be processed earlier than before — for example, in the PageRenderer during preProcessHooks such as:
$GLOBALS[‘TYPO3_CONF_VARS’][‘SC_OPTIONS’][‘t3lib/class.t3lib_pagerenderer.php’][‘render-preProcess’]
Previously, these hooks received the initially set path values.
Now, we are seeing migrated PKG: path identifiers in addition to the traditional file paths.
This is a significant change because there is currently no migration handling for these identifiers — they are being checked manually.
It’s likely an unintended side effect, but it exposes a gap in supporting the new syntax.
Example
New format:
PKG:bk2k/bootstrap-package:Resources/Public/Scss/bootstrap5/theme.scss
Old format:
EXT:bk2k/bootstrap-package/Resources/Public/Scss/bootstrap5/theme.scss
The only difference is the prefix (PKG instead of EXT) and the separator (: instead of /).
The old format was previously supported throughout the system.
Many usages rely on:
GeneralUtility::getFileAbsFileName($file);
Paths like EXT:<path> typically cannot be used directly.<br>As a result, all calls to getFileAbsFileName() — commonly found in extension code — are now affected.</path>
Updating these would require substantial developer effort without adding business value, purely to maintain compatibility.
Reviews 2
Related issues 1
History 812
-
Gerrit Code Review pushed patch set 1 for main to change 91328 status
NewUnder Review <span data-processor="relativetime" data-value="2025-10-29T12:04:19+00:00" > 10/29/25, 12:04 </span> -
Benjamin Kott changed description <span data-processor="relativetime" data-value="2025-10-29T13:25:31+00:00" > 10/29/25, 13:25 </span>
-
Benjamin Kott commented <span data-processor="relativetime" data-value="2025-10-29T18:08:17+00:00" > 10/29/25, 18:08 </span>
Ayke Halder wrote in #note-3:
> > New format:
> > PKG:bk2k/bootstrap-package:Resources/Public/Scss/bootstrap5/theme.scss
> >
> > Old format:
> > EXT:bk2k/bootstrap-package/Resources/Public/Scss/bootstrap5/theme.scss
>
> Old format is without vendor-name, isn’t it?
>EXT:bootstrap-package/Resources/Public/Scss/bootstrap5/theme.scssBoth are supported already.
-
Helmut Hummel changed Related to #107537 <span data-processor="relativetime" data-value="2025-10-30T09:26:12+00:00" > 10/30/25, 09:26 </span>
-
Helmut Hummel commented <span data-processor="relativetime" data-value="2025-10-30T09:33:35+00:00" > 10/30/25, 09:33 </span>
Benjamin Kott wrote:
> New format:
> PKG:bk2k/bootstrap-package:Resources/Public/Scss/bootstrap5/theme.scss
>
> Old format:
> EXT:bk2k/bootstrap-package/Resources/Public/Scss/bootstrap5/theme.scss
>
> The only difference is the prefix (PKG instead of EXT) and the separator (: instead of /).True. That separator is a subtle but important difference. I makes parsing the identifier possible, without knowing the full list of packages and the package name can be resolved unambiguously.
Other options that fulfil these criteria have been discussed, yet no better options could be identified as of now.
-
Helmut Hummel commented <span data-processor="relativetime" data-value="2025-10-30T09:37:23+00:00" > 10/30/25, 09:37 </span>
Benjamin Kott wrote in #note-4:
> Ayke Halder wrote in #note-3:
> > > New format:
> > > PKG:bk2k/bootstrap-package:Resources/Public/Scss/bootstrap5/theme.scss
> > >
> > > Old format:
> > > EXT:bk2k/bootstrap-package/Resources/Public/Scss/bootstrap5/theme.scss
> >
> > Old format is without vendor-name, isn’t it?
> >EXT:bootstrap-package/Resources/Public/Scss/bootstrap5/theme.scss
>
> Both are supported already.Canonical usages:
Old: EXT:<extensionKey>/Relative/Path/To/Resource/
New: PKG:<composer/package-name>:Relative/Path/To/Resource/
Since package name and extension key (both as defined by the package author) are currently interchangeable, one can also be used for the other. I would not recommend doing so for now though.
-
Gerrit Code Review pushed patch set 8 for main to change 91464 <span data-processor="relativetime" data-value="2025-11-18T11:38:49+00:00" > 11/18/25, 11:38 </span>
-
Gerrit Code Review pushed patch set 9 for main to change 91464 <span data-processor="relativetime" data-value="2025-11-18T12:44:55+00:00" > 11/18/25, 12:44 </span>
-
Gerrit Code Review pushed patch set 10 for main to change 91464 <span data-processor="relativetime" data-value="2025-11-20T11:29:00+00:00" > 11/20/25, 11:29 </span>
-
Helmut Hummel commented and changed status
Under ReviewResolved done0 %100 % <span data-processor="relativetime" data-value="2025-11-24T10:00:11+00:00" > 11/24/25, 10:00 </span>Applied in changeset commit:1410751ee83af0ac5683a562f666ee3792439ebe.
-
Benni Mack changed status
ResolvedClosed <span data-processor="relativetime" data-value="2025-12-02T12:04:43+00:00" > 12/02/25, 12:04 </span>
> New format:
> PKG:bk2k/bootstrap-package:Resources/Public/Scss/bootstrap5/theme.scss
>
> Old format:
> EXT:bk2k/bootstrap-package/Resources/Public/Scss/bootstrap5/theme.scss
Old format is without vendor-name, isn’t it?
@EXT:bootstrap-package/Resources/Public/Scss/bootstrap5/theme.scss@