Try a hosted Drupal demo

Install

To start a new Drupal project with version 8.8.0-beta1@beta:

To update your site and all dependencies to the latest version of Drupal:

To update your site to this specific release:
Pinning to a specific release may make it more challenging to update your site in future, see composer documentation for managing pinned versions

Using Composer to manage Drupal site dependencies

Downloads

Download tar.gz 17.87 MB
MD5: e3e1df68078d59d96f0b0491ed2c5b6a
SHA-1: 45e708fb7c97841d2bcc4df06c93bfc5057baa1e
SHA-256: 3de05f883184b420e7d6140ddc2df89912816743edcbb59fa3fb563a70f0b684
Download zip 29.04 MB
MD5: 9039946dfc6435872813f7a2d58ecae6
SHA-1: 1f75d179e8d15211d493ed67ccd4689b30c93350
SHA-256: a9dbeb6f663f749f0993b0d97a42fc48589c01366b098268ecb38093b805de1b

Release notes

This is a beta release for the next minor version (feature release) of Drupal 8. Betas are good testing targets for developers and site builders who are comfortable reporting (and where possible, fixing) their own bugs. Beta releases are not recommended for non-technical users, nor for production websites. More information on beta releases.

This minor release provides new improvements and functionality without breaking backward compatibility (BC) for public APIs. There may be changes in internal APIs and experimental modules that require updates to contributed and custom modules and themes per Drupal core's backwards compatibility and experimental module policies.

Minor releases may include string changes and additions. Translators can review the latest translation status on localize.drupal.org.

Beta testing program

The Drupal Association and the Drupal core maintainers are partnering with agencies and site owners in an official beta testing program for Drupal core minor releases. The program aims to identify and minimize regressions in minor releases. Participating in the program is a way to contribute to the Drupal project and will be credited accordingly.

Important update information and changes since 8.8.0-alpha1

For additional important update information for this beta release, also see the 8.8.0-alpha1 release notes.

Changes to path aliases and a critical note for sites using the Pathauto contributed module

  • If you have the contributed Pathauto module enabled, you must update to the latest version of Pathauto before you update to Drupal 8.8.0. Failure to update Pathauto before updating core could result in data loss. Drupal 8.8.0-beta1 declares a conflict with Pathauto 8.x-1.5 or lower for this reason.

  • The Path Alias core subsystem has been moved to the path_alias module. This may require updates to service providers that altered or decorated the legacy services.

    An upgrade path is provided from Drupal 8.7 for this change. The upgrade path has been updated so that it should also work for upgrading from 8.8.0-alpha; however, note that upgrade paths from alpha releases are not officially supported.

Deprecated core modules

  • The SimpleTest module (labeled Testing in the Drupal core user interface) has been deprecated in Drupal core. Developers are encouraged to run tests via run-tests.sh or the PHPUnit CLI, or to use the SimpleTest contributed module in Drupal 9.

    Note that the final decision to deprecate SimpleTest still has some dependencies on the in-progress Drupal 9 issue, so exact details of the deprecation may be revised.

  • The Place Blocks module (already hidden in previous releases of Drupal core) has been deprecated and will be removed in Drupal 9.0.0. See the change record on the Place Blocks module for alternatives.

Changes to JavaScript dependencies and new JavaScript deprecations

jQuery UI is end-of-life, so most jQuery UI libraries are being deprecated in 8.8 for removal in 9.0.x. The deprecated libraries have been made available as contributed projects so that modules and themes that depend on them can upgrade easily to Drupal 9, but where possible, it is recommended to find a replacement for the longer term. See the change record on the deprecated jQuery UI libraries and their replacement modules for more information.

Drupal 8.8.0-beta1 deprecates two additional jQuery UI libraries that were not yet deprecated in 8.8.0-alpha1:

  • The jQueryUI Datepicker library has been deprecated. Browsers that support native datepickers are unaffected; browsers that do not will instead provide text inputs to enter dates starting in Drupal 9. More information can be found in the change record on Datepicker.

  • The CKEditor, Layout Builder, and Media Library modules previously depended on the jQuery UI Sortable asset library. Since jQuery UI is end-of-life, we've removed the dependency on jQuery UI sortable and added a dependency on the SortableJS library instead. It's recommended that
    any modules or themes that use jQuery UI sortable also update their code to use SortableJS. Modules extending CKEditor, Media Library, or Layout Builder may also require small changes.

    The Paragraphs contributed project uses an older version of Sortable for its experimental widget. There is a chance that this could lead into version conflicts when both the Paragraphs experimental widget and the core library are used on the same page (for example, on a form with the Media Library). If you notice JavaScript issues when using the Paragraphs experimental widget in 8.8, report them in the Paragraphs issue queue.

8.8.0-beta1 also deprecates the classList browser polyfill, which is no required by any of the browsers supported by Drupal core. (Several other browser polyfills were already deprecated in 8.8.0-alpha1.)

Composer integration changes

In 8.8.0-alpha1, the wikimedia/composer-merge-plugin was deprecated and replaced with a Composer path repository. The previous release notes did not mention that, following this change, core developers who update core's dependencies must set COMPOSER_ROOT_VERSION explicitly to avoid unexpected results (including possible accidental deletion of the core directory). Read Managing Composer updates for Drupal core for more information.

New stable core module: Media Library

Media Library provides content editors and site builders an interface to visually browse and manage media in their site. It also provides an intuitive modal dialog for reusing media in entity reference fields and text editors. Users with appropriate access can also add new media from directly within the library.

This module was introduced as an experimental core module in Drupal 8.6.0, but is now stable and ready for production use! For sites using the experimental module prior to 8.8.0 there are some important changes:

  • All of Media Library's styling and associated CSS classes were moved into Classy and Seven. Classy provides a very minimal amount of basic layout for the media library; Seven provides a more complete experience. If you are not using Seven to display the media library, you may need to add code to your theme to ensure that the moved CSS classes are applied to the media library in the correct places. See Media Library exposes templates for theming and Media Library no longer applies presentational CSS classes by default for more information, and refer to core/themes/seven/seven.theme for examples of how to apply the required CSS classes in your theme.
  • The "add" forms provided by the Media Library module now have two different form IDs. Previously, both shared the same form ID (media_library_add_form). This is now their shared base form ID. Their individual form IDs are now media_library_add_form_upload and media_library_add_form_oembed. Any code altering either of these forms may be adjusted, and any custom form extending \Drupal\media_library\Form\AddFormBase will need to be changed as well. See Media Library's AddFormBase now requires subclasses to provide a form ID for more information.
  • The media library's administrative grid interface is no longer exposed at /admin/content/media. That path now shows the administrative table listing of media items, as it does without Media Library installed. The grid interface is linked from there, and exposed at /admin/content/media-grid. An update path for this is provided; no further action is needed from existing sites.

Numerous other changes to the Media Library were also made in 8.8.0-alpha1.

JSON:API changes

JSON:API now provides HTTP error codes as strings instead of integers in order to comply with the specification. If your client application relies on an integer data type for an HTTP error code, it may need to be updated.

Dependency updates

  • Diactoros has been updated from 1.7.2 to 1.8.7, a long-term support version which will receive security coverage until Drupal 8's end-of-life. Note that the above documentation incorrectly indicates that 1.7 is the long-term support version, but we have confirmed with the Diactoros maintainers that 1.8 will continue to receive security coverage until 2022.

  • A few dependency requirements have been updated to better support PHP 7.4:

    • Symfony components (from 3.4.32 to 3.4.33).
    • mikey179/vfsstream (from 1.6.7 to 1.6.8).
    • pear/archive_tar (from 1.4.5 to 1.4.8).
    • typo3/phar-stream-wrapper (from 3.1.2 to 3.1.3).
    • composer/composer has been updated from 1.8.5 to 1.9.1 (and 1.9 or higher is now explicitly required for sites managed with Composer).

  • CKEditor has been updated from from 4.11.4 to 4.13.0, which includes numerous bugfixes and improvements.

Other dependencies have already been updated in 8.8.0-alpha1.

Important bug fixes

The following other critical issues have also been fixed in Drupal 8.8.0-beta1:

Known issues

  • There are some outstanding compatibility issues with PHP 7.4 (which will be released later in November). These issues are being addressed in #3086374: Make Drupal 8 & 9 compatible with PHP 7.4.

  • A data loss issue for path aliases has been reported in #3086638: Drupal 8 update failing on ddev builds. It appears this issue may have been due to a database misconfiguration, but we are tracking the issue to ensure it does not affect other users. Be sure to back up your data before upgrading, and report any issues with this update in the issue above.

All changes since 8.8.0-alpha1

What’s next?

  1. Learn how to install Drupal
  2. Learn how to update Drupal
  3. Extend Drupal to do more
  4. Get training
  5. Check out what others built
Created by: xjm
Created on: 8 Nov 2019 at 23:36 UTC
Last updated: 18 Dec 2019 at 19:56 UTC
Git tag 8.8.0-beta1
Bug fixes
New features
Insecure
Unsupported

Other releases