Drupal Release: 8.0.5

TL;DR

Drupal 8.0.5 is a maintenance release that addresses numerous bugs, improves performance, and enhances documentation across the system. This update includes fixes for entity handling, REST API functionality, migration tools, form handling, and accessibility improvements. While there are no major new features, the release significantly improves stability and addresses several critical issues that could cause fatal errors or data inconsistencies.

Highlight of the Release

• Fixed fatal error when editing book nodes with children in large books
• Added backtrace for logged exceptions to improve debugging
• Fixed issues with REST API serialization and error handling
• Improved entity handling with better caching and serialization
• Enhanced migration tools with new process plugins and bug fixes
• Fixed accessibility issues with progress bars and form elements
• Improved handling of multilingual content and translations

Migration Guide

Drupal 8.0.5 is a maintenance release that primarily contains bug fixes and minor improvements. As such, there are no specific migration steps required when upgrading from Drupal 8.0.4 to 8.0.5.

Upgrade Steps:

1. Backup your site: Always create a complete backup of your files and database before upgrading.

2. Update through Composer (recommended):

   composer update drupal/core --with-dependencies
   

3. Or update manually:

   • Download the Drupal 8.0.5 release
   • Replace your core files with the new version
   • Run the database update script by navigating to /update.php in your browser

4. Clear caches: After upgrading, clear all caches either through the admin interface or using Drush:

   drush cr
   

5. Test your site: Thoroughly test your site's functionality after the upgrade to ensure everything is working as expected.

Special Considerations:

• If you've been experiencing issues with book module functionality, particularly when editing book nodes with children in large books, this release contains a fix for that issue.

• If you're using REST API functionality, several fixes in this release address serialization and error handling issues.

• If you're working with multilingual content, check that menu links for translated content are now being stored correctly.

• If you're using migrations, particularly from Drupal 6, several fixes in this release may improve migration outcomes.

Upgrade Recommendations

Recommendation: Upgrade at your earliest convenience

Drupal 8.0.5 is a maintenance release that fixes numerous bugs and improves system stability. While it doesn't contain critical security fixes that would necessitate an immediate upgrade, the improvements to stability, performance, and functionality make it worthwhile to upgrade in your normal maintenance cycle.

Who should upgrade immediately:

• Sites experiencing specific issues fixed in this release, particularly:
  • Sites with large book structures experiencing fatal errors
  • Sites using REST API functionality with serialization issues
  • Sites with multilingual content having menu link storage problems
  • Sites using migrations from Drupal 6

Who can schedule the upgrade during regular maintenance:

• Sites running Drupal 8.0.4 without experiencing any of the specific issues addressed in this release

Preparation steps:

1. Review the full list of changes to identify if any fixes address issues you're currently experiencing
2. Test the upgrade on a staging environment before applying to production
3. Ensure you have a complete backup of your site before upgrading
4. Plan for a brief maintenance window to perform the upgrade and test critical site functionality

This release contains no known breaking changes, so the upgrade process should be straightforward for most sites.

Bug Fixes

Entity Handling

• Fixed issues with entity serialization and caching
• Corrected the handling of entity values to use NULL instead of misleading unset() method
• Fixed issues with entity translation creation not invoking proper hooks
• Resolved problems with theme registry not supporting switching the active theme
• Fixed static caching in EntityTypeManagerInterface::getFormObject()

REST API and Serialization

• Fixed REST configuration failures when plugin references don't exist
• Corrected REST entity resource missing entity & field access cacheability metadata
• Fixed ResourceResponse inability to serialize empty arrays
• Added content type format name in error responses
• Fixed REST entity POST request cacheability metadata handling

Views

• Fixed issues with Views filtering on boolean fields
• Corrected click-sorting in previews
• Fixed Views validation on cancel
• Resolved issues with Views allowing removal of required relationships
• Fixed pager option not being saved on views add form page widget
• Improved handling of translated strings in Views UI
• Fixed Views preview query cache handling

Migration

• Fixed issues with migrated URL aliases not working until nodes are re-saved
• Corrected handling of Drupal 6 image field settings after migration
• Fixed migration SQL base toString method accessibility
• Enhanced migration source key handling using hash instead of verbatim values

Forms and UI

• Fixed progress bar display issues where the bar appeared higher than the track
• Corrected AJAX errors when using progress bars on file field widgets
• Fixed issues with form states not working correctly
• Resolved issues with menu title maxlength in forms

Book Module

• Fixed fatal error when trying to edit book nodes with children in large books
• Corrected book module breadcrumb caching when node title or access changes
• Fixed "Remove from outline" button going to node/x/delete instead

Multilingual

• Fixed issues with HTML head having alternate hreflang links to unpublished translations
• Corrected menu link storage for multilingual content
• Fixed translated strings being loaded into Views UI and saved as default language strings

Other

• Fixed issues with dependency removal logic affecting indirect dependents
• Corrected container serialization for caching
• Fixed fnmatch() compatibility issues on certain environments
• Resolved issues with Drupal Ajax objects and settings growing endlessly

New Features

While Drupal 8.0.5 is primarily a bug fix release, it does include a few minor enhancements:

• New Migration Process Plugin: Added an explode/separator process plugin for migrations, making it easier to split source data during migration.

• Email Field Widget Enhancement: Added a size setting to the email widget, allowing for better control of the display size of email fields.

• Improved Error Reporting: Added backtrace information for logged exceptions, making debugging easier for developers.

• Enhanced Testing Capabilities: Improved run-tests.sh to allow running just the JavaScript Functional tests, making testing more efficient.

Security Updates

This release does not contain any major security fixes. Security updates are typically handled in separate security releases. However, some of the bug fixes may indirectly improve security by fixing issues that could potentially lead to unexpected behavior.

For the latest security information, always refer to the official Drupal Security Advisories at https://www.drupal.org/security.

Performance Improvements

• Optimized System Path Handling: Fixed performance issues with system_path_* functions by ensuring they pass the source parameter correctly.

• Improved Entity Caching: Several fixes to entity caching mechanisms help improve overall system performance, particularly for sites with complex entity relationships.

• Enhanced Query Handling: Fixed issues with Postgres insert queries that fail in a transaction, preventing them from breaking the entire transaction.

• Better Views Caching: Improved Views query cache handling during preview operations, ensuring that the cache is properly ignored when needed.

• Optimized Ajax Handling: Fixed issues with Drupal Ajax objects and settings that were growing endlessly, which could cause performance degradation over time.

• More Efficient Container Handling: Resolved issues with container serialization for caching, improving the performance of dependency injection container operations.

Impact Summary

Drupal 8.0.5 is a maintenance release that focuses on bug fixes, performance improvements, and documentation enhancements. While it doesn't introduce major new features, it significantly improves the stability and reliability of Drupal 8.

The most notable improvements address issues with entity handling, REST API functionality, Views, and the book module. Site administrators will benefit from fixes to critical issues like the fatal error when editing book nodes with children in large books. Developers will appreciate the improved error reporting with added backtrace for logged exceptions and fixes to REST API serialization issues.

Content editors will see improvements in multilingual content handling and form functionality. End users will benefit from better accessibility with fixes to progress bars and form elements, as well as improved search form handling.

Performance improvements include optimized system path handling, better entity caching, and fixed issues with container serialization. These changes should result in more stable and efficient operation, particularly for complex sites with many entities or heavy use of the REST API.

Overall, this release represents an important maintenance update that addresses a wide range of issues across the Drupal system. While not introducing dramatic new capabilities, it strengthens the foundation of Drupal 8 and improves the experience for all types of users.