Review 11.5 Merged

76674[BUGFIX] Do not mark the FAL-related Extbase models as internal anymore

Benni Mack CR +2 V +2 Easy +0 −6 updated 11/18/22, 11:04

Commit message

The FAL-related Extbase models are documented in the "TYPO3 Explained"
documentation, and they are the recommended way to use FAL in an
Extbase context. So the following classes are not marked as `@internal`
anymore in order to not send mixed signals to extension developers:

- TYPO3\CMS\Extbase\Domain\Model\File
- TYPO3\CMS\Extbase\Domain\Model\FileReference
- TYPO3\CMS\Extbase\Domain\Model\Folder

There is no point in forcing extension authors to re-implement
those classes (and duplicating the code from the Core) when
the Core implementation is stable now and has proven to
work fine.

Some history for what has happened:

Those classes started out marked as experimental (when they were
indeed still experimental). Then, in a cleanup bulk change in
3888dae8f3f71c3f5e1db1c00bcbfe7d0d8fed2e5966e6533c9353b6d7485f32,
the classes were converted to use the `@internal` annotation,
even though at least the three FAL Extbase models should have
been made public API instead by that time.

This is where the usage of the FAL models is documented in
"TYPO3 Explained":
https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/Fal/UsingFal/Frontend.html

Review

  • Code review CR +2

    Imported before Forger kept the single votes, the next import adds them.

  • Verified V +2

    Imported before Forger kept the single votes, the next import adds them.

Issues 1

Files 3