Drupal Release: 9.1.10

TL;DR

Drupal 9.1.10: Bug Fixes and Stability Improvements

This release focuses on fixing several critical bugs and improving stability across various Drupal components. Key improvements include resolving route serialization incompatibilities between PHP versions, fixing image style directory race conditions, addressing migration source count caching issues, and correcting several error conditions that could cause exceptions or failures in common operations.

Highlight of the Release

• Fixed route serialization incompatibilities between PHP 7.3 and 7.4
• Resolved race condition when generating subdirectories for image styles
• Fixed source count caching for migrations
• Improved error handling for entity reference fields targeting entity types without an ID

Migration Guide

No specific migration steps are required when updating from Drupal 9.1.9 to 9.1.10. This is a bugfix release that maintains compatibility with previous 9.1.x versions.

If you're experiencing any of the specific issues addressed in this release, upgrading to 9.1.10 is recommended to resolve those problems.

Upgrade Recommendations

It is recommended to update to Drupal 9.1.10 if you are currently running any previous version of Drupal 9.1.x, especially if you are experiencing any of the specific issues addressed in this release.

The update process follows the standard Drupal minor version update procedure:

1. Back up your database and code
2. Put the site into maintenance mode
3. Update Drupal core using Composer: composer update drupal/core 'drupal/core-*' --with-all-dependencies
4. Run database updates: drush updatedb or visit /update.php
5. Clear caches: drush cache:rebuild or clear caches through the admin interface
6. Take the site out of maintenance mode

This release contains only bug fixes and no API changes, so the update should be straightforward with minimal risk.

Bug Fixes

• Route Serialization: Fixed incompatibilities between PHP 7.3 and 7.4 that could cause issues with route serialization.

• Image Styles: Resolved a race condition when generating subdirectories for image styles that could lead to failures in image processing.

• Entity Reference Fields: Fixed an exception that occurred when creating an entity reference field targeting an entity type without an ID.

• Migration Source Count Caching: Fixed broken source count caching for SqlBase-based source plugins, which was causing unnecessary cache I/O operations.

• Statistics Module: Resolved an error in statistics_tokens() where a call to getTotalCount() on a boolean value was causing failures.

• Aggregator Module: Fixed AggregatorFeedBlock::build() to always return an array as required.

• Views Error Reporting: Improved error reporting for missing Views in preRenderViewElement().

• DbDumpCommand: Fixed failures that occurred when data types were not mapped to Drupal schema field names.

• Context Definition: Resolved issues with ContextDefinition::create() when used with entity-specific datatypes like entity:user.

• Link Module Field Formatters: Fixed mapping of Link module's field formatters from Drupal 7 to Drupal 8/9.

New Features

No significant new features were added in this release. Drupal 9.1.10 is primarily a bugfix and stability release that addresses several issues found in previous versions.

Security Updates

No specific security fixes were included in this release. For security-related updates, always refer to the official Drupal Security Advisories.

Performance Improvements

• Migration Source Count Caching: Fixed and optimized source count caching for SqlBase-based source plugins, reducing unnecessary cache I/O operations during migrations.

• Image Style Generation: The fix for the race condition in image style subdirectory generation also improves performance by preventing redundant directory creation attempts.

Impact Summary

Drupal 9.1.10 is a maintenance release that focuses on bug fixes and stability improvements. The most significant impacts include:

1. Improved PHP Compatibility: Fixed route serialization issues between PHP 7.3 and 7.4, ensuring better cross-version compatibility.

2. Enhanced Stability: Several critical bugs that could cause exceptions or errors in common operations have been fixed, including issues with image style generation, entity reference fields, and the statistics module.

3. Migration Improvements: Fixed source count caching for migrations and improved Link module field formatter migration from Drupal 7.

4. Developer Experience: Better error reporting for missing Views and fixes for development tools like DbDumpCommand.

This release does not introduce new features or API changes, making it a low-risk update that focuses on improving the stability and reliability of existing functionality.