@@ -61,18 +61,21 @@ The PHP version used on the command line is important and should match the versi
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).
### PHP Version
| | CiviCRM 5.51 ESR | CiviCRM 5.x.x stable |
| | CiviCRM 5.63 ESR | CiviCRM 5.x.x stable |
| ---- | ---- | ---- |
| PHP 8.1 | **incompatible** | compatible from CiviCRM 5.55 however **not recommended** yet until the extension ecosystem catches up. |
| PHP 8.0 | compatible however **not recommended** yet until the extension ecosystem catches up. | compatible from CiviCRM 5.39 however **not recommended** yet until the extension ecosystem catches up. |
| PHP 7.4 | compatible and **recommended** | compatible and **recommended** |
| PHP 7.3 | compatible and **recommended** | compatible but **not recommended** due to to [PHP end-of life](http://php.net/eol.php) in Dec 2021 |
| PHP 7.2 | compatible and **recommended** - but see note below about resaving the SMTP password | **incompatible** as of 5.58.0 |
| PHP 7.1 | **incompatible** | **incompatible** as of 5.35.0 |
| PHP 7.0 | **incompatible** | **incompatible** as of 5.25.0 |
| PHP 5.6 | **incompatible** | **incompatible** |
| 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 if [your installed extensions](https://docs.civicrm.org/user/en/latest/introduction/extensions/#installing-extensions) are compatible**. Support your extension providers and ask them for extension compatibility to help the ecosystem to catch up. | **compatible from CiviCRM 5.55 if [your installed extensions](https://docs.civicrm.org/user/en/latest/introduction/extensions/#installing-extensions) are compatible**. Support your extension providers and ask them for extension compatibility to help the ecosystem to catch up. |
| PHP 8.0 | **compatible if [your installed extensions](https://docs.civicrm.org/user/en/latest/introduction/extensions/#installing-extensions) are compatible**. Support your extension providers and ask them for extension compatibility to help the ecosystem to catch up. | **compatible from CiviCRM 5.39 if [your installed extensions](https://docs.civicrm.org/user/en/latest/introduction/extensions/#installing-extensions) are compatible**. Support your extension providers and ask them for extension compatibility to help the ecosystem to catch up. | compatible from CiviCRM 5.39 however **not recommended** |
| 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 |
| PHP 7.2 | compatible - but see note below about resaving the SMTP password | **not compatible** as of 5.58.0 |
| PHP 7.1 | **not compatible** | **not compatible** as of 5.35.0 |
| PHP 7.0 | **not compatible** | **not compatible** as of 5.25.0 |
The table below gives information on PHP minimum and recommended version compatibility for old versions of CiviCRM:
...
...
@@ -270,7 +273,7 @@ To support full and consistent display of timestamps, the MySQL server requires
| 🛠 | Debian/Ubuntu MariaDB/MySQL | Use `mysql_tzinfo_to_sql` |
| 🛠 | Nix MariaDB/MySQL | Use `mysql_tzinfo_to_sql` |
| ❓ | Amazon RDS | Needs testing/clarification. There are old google-cached forum posts which imply gradual evolution toward support. The current ["Local time zone" page](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.LocalTimeZone) seems to affirm, so probably ✅ ... but the docs don't specifically mention session-scoped timezones. |
| ❓ | cPanel/WHM (without root access) | Needs testing/clarification. If you lack access to `mysql_tzinfo_sql` (SSH) but have other ways to perform MySQL administration, then you may be able to to load [pre-generated MySQL timezone data](https://github.com/civicrm/tzdata-mysql). Key question is whether you have MySQL admin rights. |
| ❓ | cPanel/WHM (without root access) | Needs testing/clarification. If you lack access to `mysql_tzinfo_sql` (SSH) but have other ways to perform MySQL administration, then you may be able to load [pre-generated MySQL timezone data](https://github.com/civicrm/tzdata-mysql). Key question is whether you have MySQL admin rights. |
