Change record status: 
Project: 
Introduced in branch: 
10.0.x
Introduced in version: 
10.0.0
Description: 

Minimum PHP requirement increased

Drupal 10's minimum PHP version requirements has been increased to PHP 8.1.0. It will not be possible to run Drupal 10 on PHP 8.0 or earlier.

What if my Linux distribution does not support PHP 8.1 by default?

Ubuntu

Ubuntu 22.04 LTS "Jammy Jellyfish" is currently in beta and is due to be released on April 21, 2022. Jammy currently provides PHP 8.1 by default and is the recommended Ubuntu version for your Drupal 10 site.

Debian

Debian "Bookworm" is expected in mid- to late 2023, and is expected to support PHP 8.1 by default.

Debian 11.2 "Bullseye" was released on December 18, 2021. It uses PHP 7.4. Until Bookworm is available, we recommend using 11.2 Bullseye and upgrading the PHP version to PHP 8.1 using a personal package archive (PPA) or similar method.

Several online resources suggest the ondrej/php PPA for upgrading PHP in Debian. Here are a couple potential resources:

RedHat Enterprise Linux

Currently, no stable or development versions of RedHat Enterprise Linux include PHP 8.1 by default. For the time being, we recommend installing the latest stable version of RedHat Enterprise (8.4) or the CentOS Stream, and upgrading the PHP version using a third-party RPM package.

Remi's RPM repository is frequently recommended for upgrading the PHP version that comes with RedHat or CentoOS, and provides a wizard for upgrade instructions depending on the OS and PHP version needed. Additional resources:

Alpine

A new version of Alpine Linux (3.16) will be released in June 2022, and it is planned that it will use PHP 8.1 by default. (See Alpine's roadmap for PHP 8.1 for more information.)

What if my hosting service provider does not support PHP 8.1?

See our PHP 8.0 and 8.1 hosting service provider tracking issue for more information on specific hosting service providers.

If your hosting provider does not yet support PHP 8.1, file a support ticket.

Here is a sample message you can use if you are unsure whether the hosting provider has PHP 8.1 support already:

Hello,

I use your service to host a website with the Drupal web software. Drupal 10 requires PHP 8.1 and will be released later this year. I would like to update my site once the new release is available. I was wondering if my account supports PHP 8.1.

Thanks!

Here is sample message you can use if you know that your hosting provider does not support PHP 8.1:

Hello,

I use your service to host a website with the Drupal web software. Drupal 10 requires PHP 8.1 and will be released later this year. I would like to update my site once the new release is available.

I was wondering when PHP 8.1 will be available for my account. I would like to continue using your service.

Thanks!

Impacts: 
Site builders, administrators, editors
Module developers
Themers
Distribution developers
Updates Done (doc team, etc.)
Online documentation: 
Not done
Theming guide: 
Not done
Module developer documentation: 
Not done
Examples project: 
Not done
Coder Review: 
Not done
Coder Upgrade: 
Not done
Other: 
Other updates done