Drupal Release: 9.4.1

TL;DR

Drupal 9.4.1 is a maintenance release that focuses on PHP 8.2 compatibility, test improvements, and documentation fixes. It addresses several issues including PHP 8.2 string interpolation deprecation warnings, Composer dependency updates, and various test failures. This release is important for sites planning to upgrade to PHP 8.2 and those experiencing specific test failures or documentation issues.

Highlight of the Release

• PHP 8.2 compatibility improvements addressing deprecated string interpolation
• Fixed Composer update instructions for Drupal core metapackages
• Updated Guzzle HTTP dependency requirements
• Multiple test improvements and fixes for random test failures

Migration Guide

No migration guide is necessary for this minor maintenance release. Drupal 9.4.1 is a bug fix release that maintains backward compatibility with Drupal 9.4.0 and does not introduce any breaking changes that would require migration steps.

Upgrade Recommendations

This is a recommended upgrade for:

• Sites planning to use PHP 8.2, as it addresses deprecation warnings
• Sites experiencing the specific test failures or issues mentioned in the bug fixes
• Sites using Composer to manage dependencies, as it updates Guzzle HTTP requirements

As a maintenance release, upgrading from Drupal 9.4.0 to 9.4.1 should be straightforward with minimal risk. Follow the standard minor version update process:

1. Back up your database and code
2. Update using Composer: composer update drupal/core 'drupal/core-*' --with-all-dependencies
3. Run database updates: drush updatedb or visit /update.php
4. Clear caches: drush cache:rebuild or via the admin interface

For sites not affected by the specific issues addressed in this release, upgrading is still recommended as a best practice to stay current with the latest bug fixes.

Bug Fixes

• PHP 8.2 Compatibility: Fixed deprecated ${} string interpolation usage (#3280033)
• Composer Dependencies: Updated Guzzle HTTP dependency requirements to ensure compatibility with guzzlehttp/psr7 ^1.9 (#3291780)
• Scaffold Operations: Fixed an error in ReplaceOp::copyScaffold() that occurred with empty files (#3283498)
• Documentation:
  • Corrected example in FormBuilder::submitForm API documentation (#2747273)
  • Fixed incorrect Composer update instructions for Drupal core metapackages (#3145738)
  • Fixed or ignored 15 words used in Help Topics (#3164699)
  • Fixed a comment typo in FileFieldWidgetTest (#3283235)
• Testing:
  • Fixed and un-skipped QuickEditIntegrationTest::testArticleNode() (#3268244)
  • Added explicit test for session-based language negotiation (#2430379)
  • Improved ForumNodeAccessTest to use tracker module properly (#3291265)
  • Fixed PHPStan L0 errors in test code related to missing return statements (#3283794)
  • Added test to ensure fieldset allows any non-empty-string #title (#1645328)
  • Removed unnecessary override in SettingsTrayBlockFormTest (#3257600)

New Features

No significant new features were added in this maintenance release. Drupal 9.4.1 focuses on bug fixes, compatibility improvements, and test enhancements rather than introducing new functionality.

Security Updates

No explicit security fixes were mentioned in the release information. However, the update to Guzzle HTTP dependencies may include security improvements as part of the dependency maintenance.

Performance Improvements

No specific performance improvements were highlighted in this maintenance release. The focus was primarily on bug fixes, compatibility improvements for PHP 8.2, and test enhancements rather than performance optimizations.

Impact Summary

Drupal 9.4.1 is a maintenance release that primarily addresses compatibility with PHP 8.2, fixes various test issues, and improves documentation. The most significant impact is for developers preparing to upgrade to PHP 8.2, as this release eliminates deprecation warnings related to string interpolation.

The release also fixes several test-related issues, which improves the development experience and test reliability. Documentation improvements, including corrections to Composer update instructions and Help Topics, provide clearer guidance for developers and content editors.

While this is not a feature-rich release, it represents important maintenance work that keeps Drupal compatible with modern PHP versions and ensures the testing infrastructure remains reliable. Site administrators should consider this a low-risk update that helps maintain compatibility with current and future PHP versions.