Contrib.social

Request for a 3.x-dev branch to be opened

Open on Drupal.org →
Created on 1 July 2025, about 2 months ago

Problem/Motivation

The official Microsoft Azure Storage PHP SDK used in this module is now archived and no longer maintained. Microsoft explicitly recommends using the Azure Blob Storage REST API for any new development.

This creates a pressing need to modernize the module’s architecture. Continuing to rely on an archived SDK poses long-term risks including:

  • Incompatibility with future PHP versions
  • Security and maintenance issues
  • Lack of vendor support for bug fixes or new features

Proposed resolution

Open a 3.x development branch so that new work - based on direct REST API integration - can proceed without disrupting users of the current 2.x version.

Work on this refactor is already underway. It removes the SDK dependency and replaces it with a clean, testable strategy-based system for authentication. Both SAS tokens and Azure Active Directory (Service Principal) are supported.

Opening a 3.x branch will:

  • Allow iterative MRs for maintainers to review
  • Preserve stability for existing 2.x users
  • Align the module with Microsoft's current guidance

Benefits

  • Future-proofing the module with REST-native architecture
  • Removing a now-archived dependency
  • Supporting both token-based and credential-based auth methods
  • Cleaner, more extensible service structure

Remaining tasks

  • Create 3.x branch on the project
  • Contributor(s) will open merge requests incrementally against that branch

API changes

The 3.x version will introduce significant API changes internally - particularly in how services are defined and injected - but will aim to provide a smooth developer experience through well-documented service interfaces and backward-compatibility fallbacks where feasible.

User interface changes

None planned initially, though the configuration UI in the work I've already started on does give admins the ability to swap between different authentication methods.

🌱 Plan
Status

Active

Version

2.0

Component

Code

Created by

🇬🇧United Kingdom siliconmeadow

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

Comments & Activities

contrib.social Blog FAQ Discussions
Production build 0.71.5 2024