Drupal Release: 10.1.1

TL;DR

Drupal 10.1.1: Bug Fix and Security Maintenance Release

This minor release addresses several critical bugs and improves stability across Drupal 10.1.x. Key fixes include resolving comment system issues, addressing file handling problems, fixing media embedding functionality, and updating CKEditor 5 to version 38.1.0. This release is primarily focused on bug fixes rather than introducing new features, making it a recommended update for all Drupal 10.1.x sites.

Highlight of the Release

• Fixed critical comment system issues affecting statistics and access control
• Updated CKEditor 5 to version 38.1.0
• Resolved media embedding issues in the editor
• Fixed compatibility issues with PHP 8.3
• Improved asset handling and aggregation

Migration Guide

No specific migration steps are required when updating from Drupal 10.1.0 to 10.1.1. This is a maintenance release that focuses on bug fixes and does not introduce any breaking changes or require special migration procedures.

Standard update procedures apply:

1. Back up your database and site files
2. Put your site into maintenance mode
3. Update Drupal core using your preferred method (Composer, Drush, or manual update)
4. Run the database updates
5. Clear caches
6. Take your site out of maintenance mode

Upgrade Recommendations

Priority: High

All sites running Drupal 10.1.0 should upgrade to 10.1.1 as soon as possible. This release contains several important bug fixes that improve stability and address issues that could affect site functionality, particularly around comments, media handling, and entity validation.

The update process is straightforward with no known upgrade issues. As always, it's recommended to:

• Test the update on a staging environment before applying to production
• Perform a full backup of your site and database before upgrading
• Review your site functionality after the update, particularly features related to comments, media embedding, and file uploads

Bug Fixes

Comment System Fixes

• Fixed random test failures in CommentStatisticsTest
• Resolved an issue where CommentSelection::entityQueryAlter() would fail on validation when the referencing entity is not a comment
• Fixed a critical bug in CommentAccessControlHandler::checkCreateAccess() that wasn't properly checking the commented entity's comment field status property

Media and File Handling

• Fixed an issue where media embedded in a view mode with a configured link would incorrectly be clickable in CKEditor
• Resolved problems with image dimension calculations when min_resolution is larger than 600x600
• Fixed "Set default value" incorrect default state when using Media Library
• Addressed issues with the autocomplete throbber remaining visible when entering a blacklist character

Entity and Form Handling

• Fixed inconsistencies in EntityConstraintViolationList::findByCodes
• Resolved issues with field layouts not working for embedded forms
• Fixed asset controller filename prefix validation

UI and Display

• Fixed display of plus sign on inline block create button with Stable9 theme
• Replaced "Recipe Instruction" label with a better alternative

System Performance and Stability

• Improved asset aggregation URL hash building from normalized list of libraries
• Removed the aggregate stale file threshold and state entry
• Fixed issues with the forum_index table not having a primary key (reverted and addressed properly)

Compatibility

• Fixed compatibility with PHP 8.3 in MaximumFileSizeExceededUploadTest
• Resolved blocking update issue with guzzlehttp/promises 2.0 and AWS SDK

New Features

No significant new features were introduced in this maintenance release. Drupal 10.1.1 focuses on bug fixes and stability improvements to the existing 10.1.0 feature set.

Security Updates

This release does not contain any documented security fixes. However, keeping your Drupal installation up-to-date is always recommended as a security best practice, as it ensures you have the latest bug fixes that might indirectly affect security.

Performance Improvements

Asset Handling Improvements

• Enhanced asset aggregation URL hash building by using a normalized list of libraries, which improves caching consistency and performance
• Removed the aggregate stale file threshold and state entry, streamlining the asset management system

Database Optimization

• Addressed issues with the forum_index table structure to improve query performance and database integrity

Impact Summary

Drupal 10.1.1 is a maintenance release that addresses multiple bugs and stability issues in the 10.1.x branch. The impact is primarily positive, resolving issues that could affect site functionality and user experience.

The most significant fixes address problems in the comment system, including access control and statistics handling, which could cause errors or unexpected behavior on sites with active comment sections. Media embedding and handling improvements ensure content editors can work with media elements more reliably in CKEditor 5, which has been updated to version 38.1.0.

For developers, this release resolves several technical issues including PHP 8.3 compatibility, entity validation inconsistencies, and asset handling improvements. The fixes for field layouts in embedded forms and the resolution of dependency issues with guzzlehttp/promises will be particularly beneficial for module maintainers.

While this release doesn't introduce new features, the bug fixes and stability improvements make it a recommended update for all Drupal 10.1.x sites. The update process is straightforward with no breaking changes, making it a low-risk, high-benefit upgrade.