Install

To start a new Drupal project with version 10.0.0-alpha2@alpha:

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 18.04 MB
MD5: 36cdbfb4480560061cd020de5ded68a0
SHA-1: 3058ba14e5693a421b869e321203317582d130b3
SHA-256: d21449dc46fbf2eb0379b4e736e868a8e89580456f0b467477e8718732ac0ab2
Download zip 30.4 MB
MD5: 1ba1aeedfe61ee37e56c2cccf74e99bc
SHA-1: 7defda7fba20857e21b1c205ce8cfc899ffc458a
SHA-256: 395492d0b7d118e6ef0feebfc26d8c8941bbf8e2ab1d214e92ee47cde22175bf

Release notes

This is an alpha release for the next major version of Drupal. This alpha release is intended for module or theme authors to test whether their code is compatible with recent significant changes in Drupal 10.0.x. Drupal 10 alpha releases should not be used in production. No upgrade path will be provided between Drupal 10 alpha releases, nor to Drupal 10.0.0-beta1.

This release fixes security vulnerabilities. Sites are urged to update immediately after reading the notes below and the security announcements:

Many breaking changes will be added before Drupal 10.0.0-beta1

Drupal 10 alphas do not include all the breaking changes that will be included in 10.0.0. Any further alpha releases as well as the first beta release will include more dependency updates and remove more APIs that are (or that will be) deprecated in Drupal 9, including several core modules and themes that will be moved to contributed projects. Refer to How to prepare your Drupal 7 or 8 site for Drupal 9 for tools you can use to check the Drupal 10 compatibility of modules, themes, and sites.

Specific, highly disruptive changes that are not available in 10.0.0-alpha2:

  1. CKEditor 4 will be removed from Drupal 10 core, and content created with CKEditor 4 might not work in CKEditor 5 because of upstream changes. You must either install the CKEditor 4 module in contrib (which will receive security fixes until Drupal 9's end-of-life in 2023), or update your site and content to CKEditor 5. There is a beta-stability CKEditor 5 module available for testing in Drupal 9 and 10.

  2. Various core modules and themes will be moved to contributed projects.

  3. Numerous JavaScript libraries and APIs will be removed.

There will be many other specific updates and deprecated API removals beyond this list. For more information on 10.0.x development, see #3118143: [meta] Release Drupal 10 on December 14... or 15... 2022.

The 10.0.x branch also includes all the latest commits that will be backported to 9.4.x and earlier branches. 10.0.x will be nearly identical to 9.4.x except for the following:

  1. Deprecated code will be removed, including entire deprecated modules.
  2. Dependencies will be updated to new major versions as appropriate.

For all other changes, refer to the 9.4.x branch.

Important update information

Refer to the Drupal 10.0.0-alpha1 release notes for additional changes from 9.4.x.

Drupal 10 platform requirement changes

PHP requirements

Drupal 10 now requires PHP 8.1. (We will publish a broader announcement about this requirement in the near future, including recommendations for sites that do not yet have PHP 8.1 available to them.)

PostgreSQL requirements

Drupal 10's PostgreSQL database driver requires PostgreSQL 12 with the pg_trgm extension enabled. A requirements error is now displayed when installing or updating a PostgreSQL site without this extension enabled.

SQLite requirements

Drupal 10's SQLite database drives requires SQLite 3.26 with the json1 extension. In Drupal 9.4, site owners will receive warnings if this extension is not available. In Drupal 10, Drupal cannot be installed or updated without the extension. (Refer to the change record for information on checking for JSON support with other computational database drivers.)

Note that the MySQL database server requirements are unchanged from Drupal 9. (More information on Drupal 10's database server requirements.)

Data updates before 9.3.0 have been removed

Data updates added prior to Drupal 9.3.0 have been removed from Drupal 10.0.x. To update to Drupal 10, you must first ensure your site is running Drupal 9.3.0 or a later release. We recommend updating to the most recent core 9.x release, as well as updating all of your contributed modules to their latest releases, prior to updating to Drupal 10.

Removed core modules

The following modules have been removed from core in 10.0.0-alpha2:

  • Entity Reference: If this module is installed on your site for some reason, simply uninstall it. (It is an obsolete, empty stub with no impact on site functionality.)

  • Migrate Drupal Multilingual: This functionality is now provided by the core Migrate Drupal module. If this module is installed on your site for some reason, simply uninstall it. (It is an obsolete, empty stub with no impact on site functionality.)

Numerous other modules and themes will be removed prior to 10.0.0-beta1.

Per-table prefixing support removed

Drupal previously supported per-table prefixing for complex multisite setups. This functionality has been deprecated since Drupal 8.2. Warnings are displayed on the status reports of sites that still use this functionality from Drupal 9.3.0 on, and the functionality has been removed from Drupal 10. See the change record for alternatives to per-table prefixing.

SimpleTest support removed from the core test runner

The SimpleTest module was moved to contrib prior to Drupal 9.0.0. Drupal 10 removes support for SimpleTest from the core test runner. Projects that use SimpleTest should convert their tests to PHPUnit.

Deprecated API removals

Numerous deprecated core APIs have been removed since 10.0.0-alpha1. Many more will be removed between 10.0.0-alpha2 and 10.0.0-beta1.

Change to hook_entity_view_mode_alter()

hook_entity_view_mode_alter() no longer receives the $context argument, which was always empty arra. Existing implementations of hook_entity_view_mode_alter() should remove the $context argument. See the hook_entity_view_mode_alter() change record for more details.

Dependency updates

The following dependencies have been changed or updated since 10.0.0-alpha1:

Symfony

Symfony has been updated from Symfony 5.4 to 6.0, except for the symfony/console component which will remain at version 5.4 until an upstream Composer issue is resolved.

Twig

Drupal 10's Twig version requirement has been increased from 3.0 to 3.3.8 to address a security vulnerability in Twig. (The vulnerability required advanced, administrator-level permissions to exploit in Drupal.)

Development dependencies

  • Drupal's composer/composer development dependency is now required to be at least version 2.2.4 to support the Automatic Updates initiative. (2.3 may be required before 10.0.0 to resolve an upstream bug, and composer/composer may also become a production dependency.)

  • The Stylelint development dependency has been updated to version 14, and minor changes have been made to whitespace and quoting in core CSS. Refer to the change record on the Stylelint 14 update for more information.

  • Drupal core's JavaScript development dependencies have been updated to the latest allowed minor and patch versions to address a few security issues in those dependencies. This should have minimal impact on contributed or custom code and CI workflows. Core developers should completely remove their node_modules directory and re-run yarn install from within the core/ directory.

    Additionally, acorn has been temporarily added as a direct development dependency of core to work around an upstream bug in Terser. Acorn will be removed as a direct dependency again once Terser creates a new release with a fix for the bug.

Added dependencies

Removed dependencies

  • Drupal 10 core no longer depends on the TYPO3/phar-stream-wrapper library, because this library is only needed for PHP 7.3 and earlier.

More backend and frontend dependency changes will be made prior to beta1.

What's next?

We may release further alpha versions as needed. There are two remaining release scenarios for Drupal 10. If we complete all Drupal 10.0.0 beta requirements by the May 13, the first beta will be released on the week of May 16 and Drupal 10.0.0 will be released on August 17, 2022. If the beta requirements are not completed by May 13, a later beta window will be used.

Known issues

Search the issue queue for known issues.

All changes since 10.0.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: 18 Feb 2022 at 17:06 UTC
Last updated: 6 May 2022 at 23:32 UTC
Insecure
Bug fixes
New features
Unsupported

Other releases