Drupal Release: 8.3.3

TL;DR

Drupal 8.3.3 is a maintenance release that includes numerous bug fixes, performance improvements, and documentation updates. Key highlights include significant performance improvements to table drag operations, fixes for content moderation workflows, migration enhancements, and important security fixes for URL handling. This release focuses on stability and refinement rather than introducing major new features, making it a recommended upgrade for all Drupal 8.3.x sites.

Highlight of the Release

• 10x performance improvement for table drag operations
• Fixed content moderation issues with revision handling and permissions
• Enhanced migration tools with better cross-database support
• Improved entity autocomplete functionality
• Better test coverage and conversion of web tests to browser tests

Migration Guide

No significant migration steps are required for this maintenance release. This is a bug fix release that maintains backward compatibility with Drupal 8.3.x.

However, developers should note:

1. If you've implemented custom code that interacts with content moderation, review the fixes related to revision handling and entity types without bundles.

2. If you're using migrations, be aware of the improvements to cross-database joins and high-water marks, which may affect your migration processes.

3. If you've extended the HAL RelationLinkManager, check your implementations against the fixed caching behavior.

Upgrade Recommendations

This release contains important bug fixes and performance improvements without introducing breaking changes. It is recommended that all sites running Drupal 8.3.x upgrade to this version.

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

1. Back up your database and code
2. Put your site into maintenance mode
3. Update your codebase to Drupal 8.3.3
4. Run the database updates via the UI at /update.php or using Drush with drush updatedb
5. Take your site out of maintenance mode

No special steps are required for this maintenance release.

Bug Fixes

Content Moderation Fixes

• Fixed an issue where moderation form submission did not set revision author
• Resolved a bug where reverting a revision caused validation errors on edit form submit
• Fixed permission issues with the "Latest revision" tab not respecting "view own unpublished content" permission
• Addressed issues with moderation state widgets for entity types without bundles

Entity and Field Handling

• Fixed entity autocomplete displaying labels only in default language
• Resolved issues with numeric fields not properly supporting negative values in the range of -0.xx
• Fixed path validation setting errors on wrong form elements
• Addressed issues with menu links pointing to non-node entities breaking when resaved

Migration Improvements

• Fixed SQL Base breaking GROUP BY queries
• Resolved issues with cross-database joins in PostgreSQL
• Fixed undefined index warnings in filter settings migrations
• Improved handling of high-water conditions for new migrations

Other Fixes

• Fixed W3C HTML5 validation errors with URL query strings containing brackets
• Resolved issues with HAL RelationLinkManager caching entity type definition objects
• Fixed PageCache issues with request URI handling
• Addressed various notices and warnings throughout the codebase

New Features

New Process Plugin for Migration Logging

A new process plugin has been added to log messages during migrations, providing better visibility into migration processes. This enhancement helps developers track and debug migration operations more effectively.

Updated Initiative Leads

The PHPUnit initiative has new leads, reflecting Drupal's ongoing commitment to improving testing infrastructure and practices.

Security Updates

URL Handling Security Fix

Fixed W3C HTML5 validation errors with PHP array-based query-strings built with url() containing [ ] characters (e.g., views filters). This addresses potential security concerns with URL encoding and handling.

Performance Improvements

Table Drag Performance

The Drupal.tableDrag.restripeTable function has been optimized to be 10 times faster, significantly improving the performance of administrative interfaces that use drag-and-drop table operations.

Menu Link Performance

Improved performance when menu link values match with the original values, reducing unnecessary processing and database operations.

Impact Summary

Drupal 8.3.3 is a maintenance release that focuses on stability and refinement rather than introducing major new features. The most significant improvements include a 10x performance boost for table drag operations, fixes for content moderation workflows, and enhanced migration tools.

For site administrators, the release improves content moderation with better revision handling and permissions, provides clearer status reports, and fixes issues with menu links. Developers will benefit from enhanced migration tools, better documentation for deprecated functions, and improved test coverage. Content editors will see improvements in entity autocomplete functionality and revision handling.

The performance improvements to table drag operations and menu link handling will be particularly noticeable for sites with complex administrative interfaces. The security fix for URL handling addresses potential issues with query string encoding.

Overall, this release represents Drupal's ongoing commitment to stability, performance, and security, making it a recommended upgrade for all Drupal 8.3.x sites.