Planning for Release 3.0.0, Drupal 10.3+ Compatibility, Flysystem v3.1 Compatibility

Created on 2 August 2023, over 1 year ago
Updated 26 June 2024, 5 months ago

Roadmap

Complete refactoring of drupal/flysystem to implement compatibility with Drupal 10.3 and The PHP League's Flysystem v3 library.

Roadmap for Drupal Flysystem:

  • Modify the Drupal FileSystem service with a Decorator that checks the registerd StreamWrapper instance associated with the "scheme" for an instance of the Flysystem Steam Wrapper, and changes the code flow if the file scheme is configured to use a Flysystem Stream Wrapper.
  • Write a base Flysystem Stream Wrapper that implements Drupal\Core\StreamWrapper\StreamWrapperInterface, and can be configured to utilize different Flysystem Adapters. This will likely turn into a configurable plugin system, with the plugin component being the configuration object for the Flysystem Adapters.
  • Drupal's StreamWrapperManager will be used to register Flysystem Stream Wrapper instances. The Drupal StreamWrapperManager service may or may not also need a Decorator.
  • Implement a configuration UI (current configuration is all done in code via config management in settings.php (see README) for the plugins
  • More TBD

References

The PHP League's Flysystem v3

https://flysystem.thephpleague.com/docs/
https://flysystem.thephpleague.com/docs/upgrade-from-1.x/
https://flysystem.thephpleague.com/docs/what-is-new/

Drupal Core

https://www.drupal.org/project/drupal/issues/2724963 ✨ Make the public file system an optional configuration Active

Issue Queue

https://www.drupal.org/project/flysystem/issues/3195832 🌱 Implement 3.x version based on Flysystem v2 API changes Needs review

Other

Drupal Slack Channel: https://drupal.slack.com/archives/C01KLLNH2MC

Work is actively underway on the refactoring on the 3.0.x branch. Contributions are welcome.

🌱 Plan
Status

Needs work

Version

3.0

Component

Miscellaneous

Created by

πŸ‡ΊπŸ‡ΈUnited States lhridley

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Comments & Activities

Production build 0.71.5 2024