Drupal Release: 8.9.12

TL;DR

Drupal 8.9.12 is a maintenance release that addresses several critical bugs and improves system stability. This update fixes issues with PostgreSQL database queries, image handling, and documentation errors. Key improvements include resolving a race condition in image style derivatives, fixing multiple image upload functionality, and addressing compatibility issues with newer PCRE library versions. This release is important for maintaining site stability and security, particularly for sites using PostgreSQL or handling multiple image uploads.

Highlight of the Release

• Fixed multiple image upload functionality that previously broke image dimensions
• Resolved critical PostgreSQL database query issues when using case-insensitive properties
• Fixed race condition in ImageStyle::createDerivative() that could cause image display problems
• Improved compatibility with PCRE library version 10.35 when JIT is enabled
• Corrected various documentation errors and broken links

Migration Guide

No migration steps are required for this maintenance release. This is a standard update that fixes bugs and improves system stability without introducing breaking changes.

To update to Drupal 8.9.12:

1. Back up your database and site files
2. Update your codebase using Composer:

   composer update drupal/core-recommended --with-dependencies
   

3. Run database updates:

   drush updatedb
   

4. Clear caches:

   drush cache:rebuild
   

Upgrade Recommendations

This is a maintenance release containing important bug fixes, particularly for sites using PostgreSQL or handling multiple image uploads.

Priority: Medium

• Sites using PostgreSQL should update promptly to fix the case-insensitive query issues
• Sites with heavy image processing should update to resolve the race condition in image style derivatives and the multiple image upload bug
• Sites using PCRE library version 10.35 with JIT enabled should update to fix translation file pattern issues

As this is a bug fix release with no security updates, the update is recommended but not urgent unless you're experiencing the specific issues addressed in this release.

Bug Fixes

Critical Bug Fixes

• Multiple Image Upload Fix: Resolved an issue where uploading multiple images would break image dimensions (Issue #2644468).

• PostgreSQL Query Fix: Fixed EntityStorageBase::loadByProperties() which was broken on PostgreSQL when using two or more case-insensitive properties, causing incorrect query results (Issue #3162603).

• Image Style Race Condition: Fixed a race condition in ImageStyle::createDerivative() that could cause issues with image generation and display (Issue #3036494).

• PCRE Library Compatibility: Resolved an issue where PCRE library version 10.35 with pcre.jit=1 caused regex patterns in FileTranslation::getTranslationFilesPattern() to misbehave (Issue #3181644).

• MapItem Base Fields: Fixed an issue where MapItem base fields could not be properly uninstalled (Issue #3145076).

Documentation and Error Message Fixes

• @ContextDefinition Annotation: Fixed an issue where the @ContextDefinition annotation was incorrectly removing labels and descriptions (Issue #2916376).

• API Documentation Links: Corrected broken links in the main page for api.drupal.org (Issue #3188816).

• Form API Documentation: Updated documented links in form.api.php (Issue #3189101).

• Error Message Corrections:

  • Fixed typo "the the" in "core/classList" deprecation message (Issue #3181870)
  • Corrected error text in EntityViewBuilder constructor (Issue #3133386)
  • Fixed missing word in the documentation for ThirdPartySettingsInterface (Issue #3178066)

New Features

No significant new features were added in this maintenance release. Drupal 8.9.12 focuses on bug fixes, documentation improvements, and compatibility enhancements to ensure system stability.

Security Updates

No specific security fixes were mentioned in the release notes. This appears to be primarily a bug fix and maintenance release. As always, keeping your Drupal installation updated to the latest version is recommended for overall security.

Performance Improvements

This release includes performance-related fixes that indirectly improve system stability:

• The fix for the race condition in ImageStyle::createDerivative() (Issue #3036494) improves the reliability of image derivative creation, which can prevent redundant processing and resource usage.

• The PostgreSQL query fix (Issue #3162603) ensures that database queries with case-insensitive properties return correct results efficiently, preventing potential performance degradation from incorrect query execution.

Impact Summary

Drupal 8.9.12 is a maintenance release that addresses several important bugs and improves system stability. The most significant fixes include resolving issues with PostgreSQL database queries, fixing multiple image upload functionality, and addressing a race condition in image style derivative creation.

For site administrators and content editors, the fixes to multiple image uploads and image style derivatives will improve content management workflows and prevent issues with image display. Developers will benefit from corrections to API documentation, error messages, and compatibility improvements with newer PCRE library versions.

This release demonstrates Drupal's commitment to maintaining stable long-term support releases by addressing both critical functionality issues and improving documentation accuracy. While there are no new features, the bug fixes enhance the reliability of core Drupal functionality, particularly around database operations and media handling.

Sites experiencing any of the specific issues addressed should update to this version to ensure proper functionality, especially those using PostgreSQL or handling multiple image uploads.