TYPO3 Logo
TYPO3 Core Changelog
Options
Give feedback View source How to edit Edit on GitHub Full documentation (single file)

TYPO3 Core Changelog

  • ChangeLog v14
    • 14.1 Changes
    • 14.0 Changes
    • 14.x Changes by type
  • ChangeLog v13
    • 13.4.x Changes
    • 13.4 Changes
    • 13.3 Changes
    • 13.2 Changes
    • 13.1 Changes
    • 13.0 Changes
    • 13.x Changes by type
  • ChangeLog v12
    • 12.4.x Changes
    • 12.4 Changes
    • 12.3 Changes
    • 12.2 Changes
    • 12.1 Changes
    • 12.0 Changes
    • 12.x Changes by type
  • ChangeLog v11
    • 11.5.x Changes
    • 11.5 Changes
    • 11.4 Changes
    • 11.3 Changes
    • 11.2 Changes
    • 11.1 Changes
    • 11.0 Changes
    • 11.x Changes by type
  • ChangeLog v10
    • 10.4.x Changes
    • 10.4 Changes
    • 10.3 Changes
    • 10.2 Changes
    • 10.1 Changes
    • 10.0 Changes
    • 10.x Changes by type
  • ChangeLog v9
    • 9.5.x Changes
    • 9.5 Changes
    • 9.4 Changes
    • 9.3 Changes
    • 9.2 Changes
    • 9.1 Changes
    • 9.0 Changes
    • 9.x Changes by type
  • ChangeLog v8
    • 8.7.x Changes
    • 8.7 Changes
    • 8.6 Changes
    • 8.5 Changes
    • 8.4 Changes
    • 8.3 Changes
    • 8.2 Changes
    • 8.1 Changes
    • 8.0 Changes
    • 8.x Changes by type
  • ChangeLog v7
    • 7.6.x Changes
    • 7.6 Changes
    • 7.5 Changes
    • 7.4 Changes
    • 7.3 Changes
    • 7.2 Changes
    • 7.1 Changes
    • 7.0 Changes
    • 7.x Changes by type
  • Documenting Changes
  • Sitemap
  1. TYPO3 Core Changelog
  2. ChangeLog v14
  3. 14.0 Changes
  4. Breaking: #106427 - File Abstraction Layer related changes
Give feedback Edit on GitHub

Breaking: #106427 - File Abstraction Layer related changes 

See forge#106427

Description 

In TYPO3 v14, the PHP API of the File Abstraction Layer (FAL) has undergone major internal changes that may affect extension authors.

  1. Most PHP classes and interfaces within FAL are now strongly typed using native PHP type declarations.
  2. Several methods have been moved from AbstractFile to its concrete implementation File , since only this class should provide such behavior. The moved methods are:

    • AbstractFile->rename()
    • AbstractFile->copyTo()
    • AbstractFile->moveTo()
  3. The FileInterface method rename() has been removed, as this operation is only relevant to the concrete File implementation.
  4. Classes implementing FolderInterface must now implement the following methods to stay compatible with the new Folder class:

    • getSubFolder()
    • getReadablePath()
    • getFiles()
    • searchFiles()

    Previously, this was not enforced, but it is now required to make Folder more interchangeable across implementations.

Impact 

Calling PHP classes or methods from the File Abstraction Layer directly may result in fatal PHP errors if incorrect or missing argument types are used.

Affected installations 

TYPO3 installations with third-party extensions that interact with the FAL PHP API in non-documented ways.

Migration 

Ensure that all FAL-related code passes and expects the correct PHP types when using or extending the API.

If you provide custom implementations of FolderInterface or classes extending AbstractFile , make sure to implement the newly required methods accordingly.

  • Previous
  • Next
Reference to the headline

Copy and freely share the link

This link target has no permanent anchor assigned. You can make a pull request on GitHub to suggest an anchor. The link below can be used, but is prone to change if the page gets moved.

Copy this link into your TYPO3 manual.

  • Home
  • Contact
  • Issues
  • Repository

Last rendered: Dec 10, 2025 17:14

© since 1997 by the TYPO3 contributors
  • Legal Notice
  • Privacy Policy