Set platform requirements

Last updated on
10 January 2026

Platform requirements should be set at least 6 months before a major release.

The final decision regarding a platform is made in a core issue, part of the meta issue for a major version.

Composer

Guidelines

  • The Composer major version is increased when it becomes burdensome to maintain compatibility with two versions of Composer.
  • The minimum Composer requirement should be the latest secure version of the selected major version.

PHP

The PHP requirements is set so that the latest Drupal version is as forward-compatible as possible.

This makes it easier to stay up to date with dependencies that release new minor or major versions that are only compatible with newer PHP versions.

Guidelines

  • The minimum PHP requirement is set to the highest stable PHP version available at the time beta1 of the next major version is released, assuming support has already been added in a Drupal minor release.
  • If a dependency is not sufficiently compatible with that PHP version by the time of beta1 of the next major version then the earlier version of PHP may be used that for new major only.

Help improve this page

Page status: No known problems

You can: