Differences

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

--- index [2023/03/12 10:31] – Update legacy release link - was still pointing to 5.20 dregad
+++ index [2024/08/26 11:43] (current) – Gitter link dregad
@@ Line 5: / Line 5: @@
 ADOdb is a fast, easy to use, popular database abstraction layer for [[wp>PHP]]. It allows the same code to be used when accessing a [[v5:database:supported|wide range of databases]].
-It has been actively maintained since 2000 by the project's founder, John Lim, who decided to retire from the project in 2013. Damien Regad and Mark Newnham took over the project, with the help of numerous [[https://github.com/ADOdb/ADOdb/graphs/contributors|community contributors]].
+It has been actively maintained since 2000 by the project's founder, John Lim, who decided to retire in 2013. Damien Regad and Mark Newnham took over the project, with the help of numerous [[https://github.com/ADOdb/ADOdb/graphs/contributors|community contributors]].
 ADOdb contains components for querying and updating databases, as well as an Object Orientated [[v5:activerecord:activerecord_index|Active Record]] library, schema management and performance monitoring. It also contains the following standalone extensions:
-  * A [[v5:datetime:datetime_index|Date/Time]] library to handle dates outside of the normal PHP limits.
+  * A (deprecated) [[v5:datetime:datetime_index|Date/Time]] library to handle dates outside of the normal PHP limits.
   * A [[v5:session:session_index|Session Management]] library that extends the normal PHP functionality to allow storing of session management data in a database, or in encrypted values
@@ Line 27: / Line 27: @@
 <wrap padding-left:10px> **Documentation**
 </wrap>
 == Current Status ==
 ^ Description                 ^ Version                                                                        ^
-| Stable Release  | [[https://github.com/ADOdb/ADOdb/releases/latest|5.22.4]]                     |
+| Stable Release  | [[https://github.com/ADOdb/ADOdb/releases/latest|5.22.7]]                     |
 | Legacy Release((This is the earliest supported release - **Security and critical bug fixes only**)) | [[https://github.com/ADOdb/ADOdb/releases/v5.21.4|5.21.4]]                    |
 | Older, unsupported Releases | [[https://sourceforge.net/projects/adodb/files/adodb-php5-only/|SourceForge]]  |
@@ Line 36: / Line 37: @@
 | Development Track           | [[project:version_6_development|Version 6]]                       |
-<WRAP center 70%>
+<WRAP center 80%>
 <wrap left>
 [[https://twitter.com/ADODB_announce|{{:2021_twitter_logo_-_blue.png?50|Follow @ADODB_announce on
 Twitter}}]]
 </wrap>
-Follow us on Twitter \\ <html>
+Follow us on Twitter \\
-  <a href="https://twitter.com/ADODB_announce">
+**[[https://twitter.com/ADODB_announce|@ADODB_announce]]**
-    <strong>@ADODB_announce</strong>
-  </a>
-</html>
 </WRAP>
-<html>We are also <b>@adodb</b> on
-<a rel="me" href="https://phpc.social/@adodb">Mastodon</a> at phpc.social
-</html>
+<WRAP center 80%>
+<wrap left>
+[[https://phpc.social/@adodb|{{:mastodon-logo.svg?50|Follow @adodb on Mastodon}}]]
+</wrap>
+We are also **[[https://phpc.social/@adodb|@adodb]]** \\
+on Mastodon's //phpc.social// community.
 </WRAP>
+</WRAP>
 ===== Installation =====
@@ Line 57: / Line 61: @@
 ==== System requirements ====
-ADOdb is compatible with and supported on all [[https://www.php.net/supported-versions|active versions of PHP]] (>= 7.4 as of this writing), including PHP 8.1.
+ADOdb is compatible with and supported on all [[https://www.php.net/supported-versions|active versions of PHP]] (>= 7.4 as of this writing), including PHP 8.3.
 See [[v5:php_compatibility_status]] for further details.
@@ Line 69: / Line 73: @@
 | 5.20           | 5.3.2                 |
 </WRAP>
+==== Manual Installation ====
+Download the software using the links on the right, and unpack it into the directory of your choice.
 ==== Installation Via Composer ====
@@ Line 74: / Line 82: @@
 This is the recommended installation method.
 ADOdb is available on [[https://packagist.org/packages/adodb/adodb-php|Packagist]].
+<WRAP clear></WRAP>
 === Current Production Release ===
@@ Line 81: / Line 91: @@
   composer require adodb/adodb-php dev-master
-==== Manual Installation ====
-Download and unpack into the directory of choice.
 ===== Support =====
@@ Line 94: / Line 102: @@
 ==== How To Ask For Help ===
-You can post an issue in the [[https://github.com/ADOdb/ADOdb/issues|Github issue tracker]].
+Start a thread in [[https://github.com/ADOdb/ADOdb/discussions|GitHub discussions]].
+If you found a bug in the code, wish to propose a new feature or request an enhancement, please create an issue in the [[https://github.com/ADOdb/ADOdb/issues|Github issue tracker]].
 To help with quick resolution:
@@ Line 104: / Line 114: @@
 You can also ask questions on
   * [[http://stackoverflow.com/questions/tagged/adodb-php|Stack Overflow]] using a tag of **adodb-php**
-  * [[https://gitter.im/ADOdb/ADOdb|gitter]], community adodb/adodb
+  * Chat with the ADOdb community on [[https://app.gitter.im/#/room/#ADOdb_ADOdb:gitter.im|Gitter]]
 ==== Why Don't You Support Earlier Versions? ====
-We have limited resources, and unfortunately can't afford to maintain the older versions in parallel with the current stable releases and the development track.
+We are a very small team with very limited resources, and unfortunately can't afford to maintain the older versions in parallel with the current stable releases and the development track.
+For the same reason, we decided to drop [[v5:php_compatibility_status|compatibility with old PHP versions]] as it was getting increasingly difficult to maintain it while adapting to the latest changes. This allows us to leverage new language features, make use of 3rd party libraries, and reduce maintenance effort at the same time.
-Version 5.20.0 was released in November 2015, you should be at least to that point, and we strongly recommend to apply the latest hotfix release..
+We strongly recommend that you **always run the [[https://github.com/ADOdb/ADOdb/releases/latest|latest stable release]]**, which is the only one that is actively maintained; this includes bug fixes and compatibility updates for newer PHP versions.
+Legacy version 5.21.0 was released in February 2021, and only receives **security and critical bug fixes**. If you are still running an older version, you should at the very least upgrade to that, and we actually strongly advise to apply the latest hotfix release ([[https://github.com/ADOdb/ADOdb/blob/v5.21.4/docs/changelog.md|5.21.4]]).
 ==== Our Community ====
@@ Line 131: / Line 144: @@
 ^ Date        ^ Description                                                                                                                                                                            ^
+| 04/11/2023  | ADOdb version 5.22.7 is available. [[https://github.com/ADOdb/ADOdb/blob/v5.22.7/docs/changelog.md|Full Changelog]]                                                      |
+| 11/06/2023  | ADOdb version 5.22.6 is available. [[https://github.com/ADOdb/ADOdb/blob/v5.22.6/docs/changelog.md|Full Changelog]]                                                      |
+| 03/04/2023  | ADOdb version 5.22.5 is available. [[https://github.com/ADOdb/ADOdb/blob/v5.22.5/docs/changelog.md|Full Changelog]]                                                      |
 | 28/10/2022  | ADOdb version 5.22.4 is available. [[https://github.com/ADOdb/ADOdb/blob/v5.22.4/docs/changelog.md|Full Changelog]]                                                      |
 | 06/09/2022  | ADOdb version 5.22.3 is available. [[https://github.com/ADOdb/ADOdb/blob/v5.22.3/docs/changelog.md|Full Changelog]]                                                      |
@@ Line 187: / Line 203: @@
 </WRAP>
 <WRAP>
-The ADOdb team would like to thank [[https://www.jetbrains.com/|JetBrains]] for their valued support to the project, in the form of free [[https://www.jetbrains.com/buy/opensource/?product=phpstorm|PHPStorm IDE]] licences.
+The ADOdb team would like to thank [[https://www.jetbrains.com/|JetBrains]] for their valued support to the project, in the form of free [[https://jb.gg/OpenSourceSupport|PHPStorm IDE]] licences.
 </WRAP>
 </WRAP>