Skip to content
Snippets Groups Projects

Indicate that 8.2 and 8.3 are supported for certain sites

Merged Indicate that 8.2 and 8.3 are supported for certain sites
Joe-2024-01-10 into master
Merged JoeMurray requested to merge Joe-2024-01-10 into master
Compare
and
1 file
+ 7
− 7
Compare changes
  • Side-by-side
  • Inline
docs/general/requirements.md
+ 7
− 7
@@ -10,7 +10,7 @@ A recommended server environment should typically meet these guidelines:
* __Operating system__: Linux
* __CMS__: Backdrop, Drupal 7, Drupal 10, Joomla 4 or WordPress
* __PHP__: 7.4 -- with configuration and extension requirements. PHP 8.0 is supported from 5.40. PHP 8.1 is supported from 5.55
* __PHP__: PHP 8.1 or 8.2 is recommended
* __MySQL__: MySQL 5.7.5+ or MariaDB 10.2+ -- with configuration requirements
Other environments may also meet the system requirements. The following sections present requirements more precisely.
@@ -61,19 +61,19 @@ Each CMS has its own policies for which versions are supported or receiving only
The PHP version used on the command line is important and should match the version used by the web server. For example, using PHP 7.4 (or lower) on the command line and using PHP 8.0 (or higher) on the web server has been known to cause issues.
It is also important to ensure that the same PHP extensions/modules are loaded on the command line and the web server.
You can find the lifecycle of current PHP versions [here](https://www.php.net/supported-versions.php).
It is also important to ensure that the same PHP extensions/modules are loaded and enabled on both the command line version of PHP and the web server version.
### PHP Version
The following recommendations relate to the CiviCRM core codebase. CiviCRM native extensions, and modules and plugins that integrate CiviCRM with CMSes are maintained and released on other schedules. As they typically lag in supporting newer versions of PHP, it is recommended that you test your full site including this other software extensively as part of migrating to a newer version of PHP.
You can find the lifecycle of current PHP versions [here](https://www.php.net/supported-versions.php).
| | CiviCRM 5.63 ESR | CiviCRM 5.x.x stable |
| ---- | ---- | ---- |
| PHP 8.3 | **not compatible.** You can support this effort [by fixing open issues](https://lab.civicrm.org/dev/core/-/issues/?sort=created_date&state=opened&label_name[]=php8%2B) or with [funding](https://civicrm.org/contribute) | **not compatible.** You can support this effort [by fixing open issues](https://lab.civicrm.org/dev/core/-/issues/?sort=created_date&state=opened&label_name[]=php8%2B) or with [funding](https://civicrm.org/contribute) |
| PHP 8.2 | **not compatible.** You can support this effort [by fixing open issues](https://lab.civicrm.org/dev/core/-/issues/?sort=created_date&state=opened&label_name[]=php8%2B) or with [funding](https://civicrm.org/contribute) | **not compatible.** You can support this effort [by fixing open issues](https://lab.civicrm.org/dev/core/-/issues/?sort=created_date&state=opened&label_name[]=php8%2B) or with [funding](https://civicrm.org/contribute) |
| PHP 8.1 | **compatible and recommended**. | **compatible and recommended**. |
| PHP 8.3 | **supported** for sites willing to report potential occasional compatibility bugs. You can support this effort [by fixing open issues](https://lab.civicrm.org/dev/core/-/issues/?sort=created_date&state=opened&label_name[]=php8%2B) or with [funding](https://civicrm.org/contribute) | **supported** for sites willing to report potential occasional compatibility bugs. You can support this effort [by fixing open issues](https://lab.civicrm.org/dev/core/-/issues/?sort=created_date&state=opened&label_name[]=php8%2B) or with [funding](https://civicrm.org/contribute) |
| PHP 8.2 | **supported** for sites interested in deploying latest stable releases. You can support this effort [by fixing open issues](https://lab.civicrm.org/dev/core/-/issues/?sort=created_date&state=opened&label_name[]=php8%2B) or with [funding](https://civicrm.org/contribute) | **supported** for sites interested in deploying latest stable releases. You can support this effort [by fixing open issues](https://lab.civicrm.org/dev/core/-/issues/?sort=created_date&state=opened&label_name[]=php8%2B) or with [funding](https://civicrm.org/contribute) |
| PHP 8.1 | **compatible and recommended** | **compatible and recommended** |
| PHP 8.0 | compatible but **not recommended** due to [PHP end-of life](http://php.net/eol.php) in Nov 2023 | compatible but **not recommended** due to [PHP end-of life](http://php.net/eol.php) in Nov 2023 |
| PHP 7.4 | compatible but **not recommended** due to [PHP end-of life](http://php.net/eol.php) in Nov 2022 | compatible but **not recommended** due to [PHP end-of life](http://php.net/eol.php) in Nov 2022 |
| PHP 7.3 | compatible but **not recommended** due to [PHP end-of life](http://php.net/eol.php) in Dec 2021 | compatible but **not recommended** due to [PHP end-of life](http://php.net/eol.php) in Dec 2021 |