Differences

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

--- v5:php7_status [2018/06/12 18:25] – Rephrase PHP 7 support to make compatibility clearer, add link to report PHP7 issues dregad
+++ v5:php_compatibility_status [2023/06/12 14:55] (current) – New PHP 8.2 compatibility fixes in 5.22.6 dregad
@@ Line 1: / Line 1: @@
-====== PHP 7 ======
+====== PHP Compatibility Status ======
-**PHP 7 is fully supported** (up to version 7.2) in the latest [[https://github.com/ADOdb/ADOdb/releases/latest|ADOdb Stable Release]] (5.20.12 or later), as well as in the 5.21 Development release (//master// branch).
+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]].
-Please note that there are no plans to implement PHP 7 support in ADOdb legacy versions (5.19 and older).
+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.
-===== Reporting Issues =====
-Should you discover any PHP 7 incompatibility in ADOdb, kindly [[https://github.com/ADOdb/ADOdb/issues/new?labels=php7|report the issue in our tracker]].
+===== Support Matrix by PHP version =====
-===== Addressing Issues =====
+^ PHP version    ^ ADOdb minimum  ^ End support           ^ Known issues                                           ^
+| 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                |                                                        |
-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.
+//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.
-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]].
+//End support// specifies the ADOdb release where support for the given PHP version was dropped.
+===== Legacy ADOdb Versions Support =====
-===== Upgrading From Earlier Releases =====
+Please note that there are no plans to fix PHP compatibility issues in ADOdb Legacy versions (5.21 and older).
-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 =====
+==== Upgrading From Earlier 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.
+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 [[:index#how_to_ask_for_help|support methods]] listed on the 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 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.
 ===== Package Testing Status =====
+Heavy use drivers are the //tier 1// drivers, plus their PDO variants:
+{{topic>tier1 -v6}}
 ^Package^Status|
-|Core database Methods|In full-time testing|
+|Core database Methods|Testing complete on heavy use drivers, others are as reported|
-|Data Dictionary|In full-time testing|
+|Data Dictionary|Testing complete on heavy use drivers, others are as reported|
-|AXMLS|Not Yet tested|
+|AXMLS|Testing in progress on heavy use drivers|
 |Date/Time Library|Not Yet Tested|
-|Performance Monitoring|Not Yet Tested|
+|Performance Monitoring|Testing complete on supported drivers, IBM DB2 currently not supported|
-|ADOdb Active Record|Not Yet Tested|
+|ADOdb Active Record|Testing complete on heavy use drivers, others are as reported|
-|Session Management|Not Yet Tested|
+|Session Management|Testing complete, PDO now supported|
 {{htmlmetatags>metatag-keywords=(php,adodb,php7,upgrade,custom,package)}}
 {{htmlmetatags>metatag-description=(ADOdb can be run successfully with PHP 7)}}