Differences

This shows you the differences between two versions of the page.

--- v5:php_compatibility_status [2021/03/01 10:06] – [Reporting Issues] dregad
+++ v5:php_compatibility_status [2024/08/26 11:29] (current) – Add PHP 8.3 & 8.4 to table dregad
@@ Line 1: / Line 1: @@
 ====== PHP Compatibility Status ======
-===== PHP 8 =====
+Should you discover any PHP compatibility issue in ADOdb,
+kindly [[https://github.com/ADOdb/ADOdb/issues/new?assignees=&labels=triage&template=bug_report.md&title=|report it in our tracker]].
-PHP 8 has been released on 26-Nov-2020, and is fully supported in ADOdb 5.21.0 and later.
+Corrections are published as Hotfix releases((Drop-in replacements to earlier versions of the same release number)), so please make that sure the problem you're facing still exists in the most recent version, including unreleased fixes in the //hotfix/x.xx// branch, before submitting a new issue.
-See the [[https://github.com/ADOdb/ADOdb/labels/PHP8|list of reported compatibility issues]].
-===== PHP 7 =====
+===== Support Matrix by PHP version =====
-PHP 7 is **fully supported** since 5.20.12.
+^ PHP version    ^ ADOdb minimum  ^ End support           ^ Known issues                                           ^
+| 8.4            | TBA            |                       | [[https://github.com/ADOdb/ADOdb/labels/PHP8.4|list]]  |
+| 8.3            | 5.22.8         |                       | [[https://github.com/ADOdb/ADOdb/labels/PHP8.3|list]]  |
+| 8.2            | 5.22.6         |                       | [[https://github.com/ADOdb/ADOdb/labels/PHP8.2|list]]  |
+| 8.1            | 5.22.4         |                       | [[https://github.com/ADOdb/ADOdb/labels/PHP8.1|list]]  |
+| 8.0            | 5.20.20        |                       | [[https://github.com/ADOdb/ADOdb/labels/PHP8|list]]    |
+| 7.4            | 5.20.12        |                       | [[https://github.com/ADOdb/ADOdb/labels/PHP7|list]]    |
+| 7.0 - 7.3      | 5.20.12        | 5.23.0((unreleased))  | :::                                                    |
+| 5.5 - 5.6      | 5.x            | 5.22.0                |                                                        |
+| 5.4 and older  | 5.x            | 5.21.0                |                                                        |
-==== Versions 7.0 to 7.3 ====
+//ADOdb minimum// indicates the earliest ADOdb release with support for the given PHP version. You are always advised to use the latest hotfix release, as there may be unknown or unresolved issues with the specified version; make sure to check the known issues list.
-All the [[https://github.com/ADOdb/ADOdb/issues?q=is%3Aclosed+label%3Aphp7|reported issues]] have been fixed.
+//End support// specifies the ADOdb release where support for the given PHP version was dropped.
+===== Legacy ADOdb Versions Support =====
-==== Version 7.4 ====
+Please note that there are no plans to fix PHP compatibility issues in ADOdb Legacy versions (5.21 and older).
-Fully Supported drivers appear to work correctly in this version, although there has been no formal testing.
-==== Legacy ADOdb Versions Support ====
+==== Upgrading From Earlier Releases ====
-Please note that there are no plans to implement PHP 7 support in ADOdb legacy versions (5.19 and older).
-===== Reporting Issues =====
+Users have reported that upgrading from releases 5.00 (released in 2007) and higher have been reasonably easy, but that earlier versions may require substantial adjustments, due to design considerations in ADOdb version 4.
-Should you discover any PHP compatibility issue in ADOdb, kindly [[https://github.com/ADOdb/ADOdb/issues/new?labels=php8|report the issue in our tracker]].
+If you need guidance, use any of the [[:index#how_to_ask_for_help|support methods]] listed on the main page.
-===== Addressing Issues =====
+==== Moving From Custom Releases ====
+In order to migrate their products from custom older versions of ADOdb back to the core product and take advantage of the active development of the product, as well as compatibility with PHP 7 and later, a number of users have submitted their custom functionality to be integrated into core. If you are in the same situation, contact us about having your feature added.
-Any PHP 7 compatibility issues found are released as Hotfixes to the current stable release, so please make sure you are using the most recent version.
-Hotfix releases are drop-in replacements to earlier versions of the same release number. You can check the current status of PHP 7 issues on the [[https://github.com/ADOdb/ADOdb/labels/php7|Github Issue Tracker]].
-===== Upgrading From Earlier Releases =====
-Users have reported that upgrading from releases 5.00 (released in 2007) and higher have been reasonably easy, but that earlier versions may require substantial adjustments, due to design considerations in ADOdb version 4. If you need guidance, use any of the support methods listed on the [[:index|main page]].
-===== Moving From Custom Releases =====
-In order to migrate their products from custom older versions of ADOdb back to the core product and take advantage of the active development of the product, as well as PHP 7 compatibility, a number of users have submitted their custom functionality to be integrated into core. If you are in the same situation, contact us about having your feature added.
 ===== Package Testing Status =====
 Heavy use drivers are the //tier 1// drivers, plus their PDO variants:
-{{topic>tier1}}
+{{topic>tier1 -v6}}
 ^Package^Status|