From 169702e780079b03486a46f23a541f7e3efc2179 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Thu, 5 Sep 2024 14:59:02 -0400 Subject: [PATCH 01/18] DOCSP-41993 Compatibility Table --- source/compatibility.txt | 44 +++ .../mongodb-compatibility-table-php.rst | 280 ++++++++++++++++++ .../read/language-compatibility-table-php.rst | 212 +++++++++++++ 3 files changed, 536 insertions(+) create mode 100644 source/compatibility.txt create mode 100644 source/includes/mongodb-compatibility-table-php.rst create mode 100644 source/includes/read/language-compatibility-table-php.rst diff --git a/source/compatibility.txt b/source/compatibility.txt new file mode 100644 index 00000000..5df5720c --- /dev/null +++ b/source/compatibility.txt @@ -0,0 +1,44 @@ +.. _php-compatibility: + +============= +Compatibility +============= + +.. contents:: On this page + :local: + :backlinks: none + :depth: 2 + :class: singlecol + +.. facet:: + :name: genre + :values: reference + +.. meta:: + :keywords: backwards compatibility, versions, upgrade + +MongoDB Compatibility +~~~~~~~~~~~~~~~~~~~~~ + +The following compatibility table specifies the recommended version or versions +of the PHP driver for use with a specific version of MongoDB. + +The first column lists the driver version. + +.. sharedinclude:: dbx/lifecycle-schedule-callout.rst + +.. include:: /includes/mongodb-compatibility-table-php.rst + +Language Compatibility +~~~~~~~~~~~~~~~~~~~~~~ + +The following compatibility table specifies the recommended version or versions +of the PHP driver for use with a specific version of PHP. + +The first column lists the driver versions. + +.. include:: /includes/language-compatibility-table-php.rst + +.. sharedinclude:: dbx/about-driver-compatibility.rst + +.. sharedinclude:: dbx/help-links-php.rst diff --git a/source/includes/mongodb-compatibility-table-php.rst b/source/includes/mongodb-compatibility-table-php.rst new file mode 100644 index 00000000..710b506e --- /dev/null +++ b/source/includes/mongodb-compatibility-table-php.rst @@ -0,0 +1,280 @@ +.. sharedinclude:: dbx/compatibility-table-legend.rst + +.. list-table:: + :header-rows: 1 + :stub-columns: 1 + :class: compatibility-large + + * - PHP Driver Versions + - MongoDB 8.0 + - MongoDB 7.0 + - MongoDB 6.0 + - MongoDB 5.0 + - MongoDB 4.4 + - MongoDB 4.2 + - MongoDB 4.0 + - MongoDB 3.6 + - MongoDB 3.4 + - MongoDB 3.2 + - MongoDB 3.0 + - MongoDB 2.6 + + * - ext + lib 1.20 + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + - + + * - ext + lib 1.16 to 1.19 + - ⊛ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + + * - ext + lib 1.15 [#PHP1.15-version-parity]_ + - ⊛ + - ⊛ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + + * - ext 1.14 + lib 1.13 + - ⊛ + - ⊛ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + + * - ext 1.13 + lib 1.12 + - ⊛ + - ⊛ + - ⊛ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + + * - ext 1.12 + lib 1.11 + - ⊛ + - ⊛ + - ⊛ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + + * - ext 1.11 + lib 1.10 + - ⊛ + - ⊛ + - ⊛ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + + * - ext 1.10 + lib 1.9 + - ⊛ + - ⊛ + - ⊛ + - ✓ [#PHPC1.10-PHPLIB1.9-driver-support]_ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + + * - ext 1.9 + lib 1.8 + - ⊛ + - ⊛ + - ⊛ + - ⊛ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + + * - ext 1.8 + lib 1.7 + - ⊛ + - ⊛ + - ⊛ + - ⊛ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + + * - ext 1.7 + lib 1.6 + - ⊛ + - ⊛ + - ⊛ + - ⊛ + - ⊛ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + + * - ext 1.6 + lib 1.5 + - ⊛ + - ⊛ + - ⊛ + - ⊛ + - ⊛ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + + * - ext 1.5 + lib 1.4 + - ⊛ + - ⊛ + - ⊛ + - ⊛ + - ⊛ + - ⊛ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + + * - ext 1.4 + lib 1.3 + - + - + - + - + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + + * - ext 1.3 + lib 1.2 + - + - + - + - + - + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + + * - ext 1.2 + lib 1.1 + - + - + - + - + - + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + + * - ext 1.1 + lib 1.0 + - + - + - + - + - + - + - + - + - + - ✓ + - ✓ + - ✓ + + * - ext 1.0 + - + - + - + - + - + - + - + - + - + - + - ✓ + - ✓ + +.. [#PHP1.15-version-parity] Version 1.14 of the MongoDB PHP library has been + skipped to restore version parity between the library and extension. + +.. [#PHPC1.10-PHPLIB1.9-driver-support] The extension 1.10 + library 1.9 + driver does not support snapshot reads on secondaries. For more + information, see the + `MongoDB Server version 5.0 release notes `__. \ No newline at end of file diff --git a/source/includes/read/language-compatibility-table-php.rst b/source/includes/read/language-compatibility-table-php.rst new file mode 100644 index 00000000..ef4cea14 --- /dev/null +++ b/source/includes/read/language-compatibility-table-php.rst @@ -0,0 +1,212 @@ +.. list-table:: + :header-rows: 1 + :stub-columns: 1 + :class: compatibility-large + + * - PHP Driver Versions + - PHP 8.3 + - PHP 8.2 + - PHP 8.1 + - PHP 8.0 + - PHP 7.4 + - PHP 7.3 + - PHP 7.2 + - PHP 7.1 + - PHP 7.0 + - PHP 5.6 + - PHP 5.5 + + * - ext + lib 1.17 to 1.19 + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + - + - + + * - ext + lib 1.16 + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + + * - ext + lib 1.15 [#PHP1.15-version-parity]_ + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + + * - ext 1.14 + lib 1.13 + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + + * - ext 1.13 + lib 1.12 + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + + * - ext 1.12 + lib 1.11 + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + - + + * - ext 1.11 + lib 1.10 + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + + * - ext 1.10 + lib 1.9 + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + - + + * - ext 1.9 + lib 1.8 + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + + * - ext 1.8 + lib 1.7 + - + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + - + + * - ext 1.7 + lib 1.6 + - + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + + * - ext 1.6 + lib 1.5 + - + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - + + * - ext 1.5 + lib 1.4 + - + - + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + + * - ext 1.4 + lib 1.3 + - + - + - + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ + + * - ext 1.3 + lib 1.2 + - + - + - + - + - + - + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ \ No newline at end of file From c956ae9292dd1ab0feade72545b2e9eb10c02f68 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Thu, 5 Sep 2024 15:11:49 -0400 Subject: [PATCH 02/18] test webhook --- source/compatibility.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/source/compatibility.txt b/source/compatibility.txt index 5df5720c..5d1eed6d 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -42,3 +42,4 @@ The first column lists the driver versions. .. sharedinclude:: dbx/about-driver-compatibility.rst .. sharedinclude:: dbx/help-links-php.rst + From c20a191d0aec1f63e3b3aa06bceccfa7dca888dd Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Thu, 5 Sep 2024 15:42:15 -0400 Subject: [PATCH 03/18] toc and sharedincludes --- snooty.toml | 2 ++ source/index.txt | 1 + 2 files changed, 3 insertions(+) diff --git a/snooty.toml b/snooty.toml index a77d00d6..948c81e2 100644 --- a/snooty.toml +++ b/snooty.toml @@ -23,6 +23,8 @@ toc_landing_pages = [ [substitutions] php-library = "MongoDB PHP Library" +sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/" + [constants] php-library = "MongoDB PHP Library" diff --git a/source/index.txt b/source/index.txt index 38ff991f..ad34abc6 100644 --- a/source/index.txt +++ b/source/index.txt @@ -16,6 +16,7 @@ MongoDB PHP Library /upgrade /reference FAQ + /compatibility /whats-new The |php-library| provides a high-level abstraction around the lower-level From ea7b0e035521d52a9b4a72f196ea29d0ba4b6fe8 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Thu, 5 Sep 2024 15:44:23 -0400 Subject: [PATCH 04/18] lang table --- source/includes/{read => }/language-compatibility-table-php.rst | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename source/includes/{read => }/language-compatibility-table-php.rst (100%) diff --git a/source/includes/read/language-compatibility-table-php.rst b/source/includes/language-compatibility-table-php.rst similarity index 100% rename from source/includes/read/language-compatibility-table-php.rst rename to source/includes/language-compatibility-table-php.rst From 9dd5843d10c3b167112853a28afdc57f95ba15fc Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Thu, 5 Sep 2024 15:53:02 -0400 Subject: [PATCH 05/18] edits --- source/compatibility.txt | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/source/compatibility.txt b/source/compatibility.txt index 5d1eed6d..970ab370 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -29,6 +29,9 @@ The first column lists the driver version. .. include:: /includes/mongodb-compatibility-table-php.rst +For more information on how to read the compatibility tables, see our guide on +`MongoDB Compatibility Tables. `__. + Language Compatibility ~~~~~~~~~~~~~~~~~~~~~~ @@ -43,3 +46,14 @@ The first column lists the driver versions. .. sharedinclude:: dbx/help-links-php.rst +For more information on how to read the compatibility tables, see our guide on +`MongoDB Compatibility Tables. `__. + +How to Get Help +--------------- + +If you have questions about compatibility, visit the following resources for further guidance: + +- Ask questions on our :community-forum:`MongoDB Community Forums <>`. +- Visit our :technical-support:`Support Channels `. +- See `Issues & Help `__. \ No newline at end of file From f59251d1ab378768a5980dcf72ae713fd6bd94e9 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Thu, 5 Sep 2024 15:54:52 -0400 Subject: [PATCH 06/18] headings --- source/compatibility.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/compatibility.txt b/source/compatibility.txt index 970ab370..a14ecd6d 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -18,7 +18,7 @@ Compatibility :keywords: backwards compatibility, versions, upgrade MongoDB Compatibility -~~~~~~~~~~~~~~~~~~~~~ +--------------------- The following compatibility table specifies the recommended version or versions of the PHP driver for use with a specific version of MongoDB. @@ -33,7 +33,7 @@ For more information on how to read the compatibility tables, see our guide on `MongoDB Compatibility Tables. `__. Language Compatibility -~~~~~~~~~~~~~~~~~~~~~~ +---------------------- The following compatibility table specifies the recommended version or versions of the PHP driver for use with a specific version of PHP. From 3b0efec08eafb7ac7d17cec633fbea7d1c5dbd14 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Thu, 5 Sep 2024 16:06:20 -0400 Subject: [PATCH 07/18] retry on shared include --- snooty.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/snooty.toml b/snooty.toml index 948c81e2..78d56bb6 100644 --- a/snooty.toml +++ b/snooty.toml @@ -23,7 +23,7 @@ toc_landing_pages = [ [substitutions] php-library = "MongoDB PHP Library" -sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/" +sharedinclude_root = "https://github.com/10gen/docs-shared/tree/main" [constants] From 4253547ea0dd386563bf1783ac33bbf71491d263 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Thu, 5 Sep 2024 16:10:20 -0400 Subject: [PATCH 08/18] shared includes --- snooty.toml | 4 ++-- source/compatibility.txt | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/snooty.toml b/snooty.toml index 78d56bb6..a074aa74 100644 --- a/snooty.toml +++ b/snooty.toml @@ -20,11 +20,11 @@ toc_landing_pages = [ "/get-started", ] +sharedinclude_root = "https://raw.githubusercontent.com/10gen/docs-shared/main/" + [substitutions] php-library = "MongoDB PHP Library" -sharedinclude_root = "https://github.com/10gen/docs-shared/tree/main" - [constants] php-library = "MongoDB PHP Library" diff --git a/source/compatibility.txt b/source/compatibility.txt index a14ecd6d..07e827fd 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -30,7 +30,7 @@ The first column lists the driver version. .. include:: /includes/mongodb-compatibility-table-php.rst For more information on how to read the compatibility tables, see our guide on -`MongoDB Compatibility Tables. `__. +`MongoDB Compatibility Tables `__. Language Compatibility ---------------------- @@ -47,7 +47,7 @@ The first column lists the driver versions. .. sharedinclude:: dbx/help-links-php.rst For more information on how to read the compatibility tables, see our guide on -`MongoDB Compatibility Tables. `__. +`MongoDB Compatibility Tables `__. How to Get Help --------------- @@ -56,4 +56,4 @@ If you have questions about compatibility, visit the following resources for fur - Ask questions on our :community-forum:`MongoDB Community Forums <>`. - Visit our :technical-support:`Support Channels `. -- See `Issues & Help `__. \ No newline at end of file +- See `Issues & Help `__. From 7a3b381d74187601b7fcd2cb2ff2385a2793bd0b Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Thu, 5 Sep 2024 16:13:24 -0400 Subject: [PATCH 09/18] callout --- source/compatibility.txt | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/compatibility.txt b/source/compatibility.txt index 07e827fd..9887ec8c 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -40,6 +40,8 @@ of the PHP driver for use with a specific version of PHP. The first column lists the driver versions. +.. sharedinclude:: dbx/lifecycle-schedule-callout.rst + .. include:: /includes/language-compatibility-table-php.rst .. sharedinclude:: dbx/about-driver-compatibility.rst From c82667068d6aa95f3084632251bb7e49d962a3b6 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Thu, 5 Sep 2024 16:18:49 -0400 Subject: [PATCH 10/18] help links --- source/compatibility.txt | 10 +++++----- source/includes/language-compatibility-table-php.rst | 2 ++ 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/source/compatibility.txt b/source/compatibility.txt index 9887ec8c..79d11bb4 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -40,14 +40,10 @@ of the PHP driver for use with a specific version of PHP. The first column lists the driver versions. -.. sharedinclude:: dbx/lifecycle-schedule-callout.rst - .. include:: /includes/language-compatibility-table-php.rst .. sharedinclude:: dbx/about-driver-compatibility.rst -.. sharedinclude:: dbx/help-links-php.rst - For more information on how to read the compatibility tables, see our guide on `MongoDB Compatibility Tables `__. @@ -58,4 +54,8 @@ If you have questions about compatibility, visit the following resources for fur - Ask questions on our :community-forum:`MongoDB Community Forums <>`. - Visit our :technical-support:`Support Channels `. -- See `Issues & Help `__. +- File an issue or feature request in JIRA under one of the following: + + - `Extension `_ + + - `Library `_ \ No newline at end of file diff --git a/source/includes/language-compatibility-table-php.rst b/source/includes/language-compatibility-table-php.rst index ef4cea14..84e6a24e 100644 --- a/source/includes/language-compatibility-table-php.rst +++ b/source/includes/language-compatibility-table-php.rst @@ -1,3 +1,5 @@ +.. sharedinclude:: dbx/compatibility-table-legend.rst + .. list-table:: :header-rows: 1 :stub-columns: 1 From 5e0723d9a03d3a5445d0d61756c6cc6b5c48e9e0 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Fri, 6 Sep 2024 14:17:20 -0400 Subject: [PATCH 11/18] tech review --- .../language-compatibility-table-php.rst | 78 +++---------------- .../mongodb-compatibility-table-php.rst | 57 -------------- 2 files changed, 12 insertions(+), 123 deletions(-) diff --git a/source/includes/language-compatibility-table-php.rst b/source/includes/language-compatibility-table-php.rst index 84e6a24e..50319621 100644 --- a/source/includes/language-compatibility-table-php.rst +++ b/source/includes/language-compatibility-table-php.rst @@ -1,33 +1,34 @@ .. sharedinclude:: dbx/compatibility-table-legend.rst - + .. list-table:: :header-rows: 1 :stub-columns: 1 :class: compatibility-large * - PHP Driver Versions + - PHP 8.4 - PHP 8.3 - PHP 8.2 - PHP 8.1 - PHP 8.0 - PHP 7.4 - PHP 7.3 - - PHP 7.2 - - PHP 7.1 - - PHP 7.0 - - PHP 5.6 - - PHP 5.5 - * - ext + lib 1.17 to 1.19 + * - ext + lib 1.20 + - ✓ - ✓ - ✓ - ✓ - ✓ - ✓ - - - - - - - + + * - ext + lib 1.17 to 1.19 + - ✓ + - ✓ + - ✓ + - ✓ + - ✓ - - @@ -39,10 +40,7 @@ - ✓ - ✓ - ✓ - - - - - - - - + * - ext + lib 1.15 [#PHP1.15-version-parity]_ - @@ -52,10 +50,6 @@ - ✓ - ✓ - ✓ - - - - - - - - * - ext 1.14 + lib 1.13 - @@ -65,10 +59,6 @@ - ✓ - ✓ - ✓ - - - - - - - - * - ext 1.13 + lib 1.12 - @@ -78,10 +68,6 @@ - ✓ - ✓ - ✓ - - - - - - - - * - ext 1.12 + lib 1.11 - @@ -91,10 +77,6 @@ - ✓ - ✓ - ✓ - - - - - - - - * - ext 1.11 + lib 1.10 - @@ -104,10 +86,6 @@ - ✓ - ✓ - ✓ - - ✓ - - - - - - * - ext 1.10 + lib 1.9 - @@ -117,10 +95,6 @@ - ✓ - ✓ - ✓ - - ✓ - - - - - - * - ext 1.9 + lib 1.8 - @@ -130,10 +104,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - - - * - ext 1.8 + lib 1.7 - @@ -143,10 +113,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - - - * - ext 1.7 + lib 1.6 - @@ -156,10 +122,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.6 + lib 1.5 - @@ -169,10 +131,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.5 + lib 1.4 - @@ -182,10 +140,6 @@ - - ✓ - ✓ - - ✓ - - ✓ - - ✓ - - ✓ * - ext 1.4 + lib 1.3 - @@ -195,10 +149,6 @@ - - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ * - ext 1.3 + lib 1.2 - @@ -207,8 +157,4 @@ - - - - - ✓ - - ✓ - - ✓ - - ✓ - ✓ \ No newline at end of file diff --git a/source/includes/mongodb-compatibility-table-php.rst b/source/includes/mongodb-compatibility-table-php.rst index 710b506e..82a9c271 100644 --- a/source/includes/mongodb-compatibility-table-php.rst +++ b/source/includes/mongodb-compatibility-table-php.rst @@ -15,9 +15,6 @@ - MongoDB 4.0 - MongoDB 3.6 - MongoDB 3.4 - - MongoDB 3.2 - - MongoDB 3.0 - - MongoDB 2.6 * - ext + lib 1.20 - ✓ @@ -29,9 +26,6 @@ - ✓ - - - - - - - - * - ext + lib 1.16 to 1.19 - ⊛ @@ -43,9 +37,6 @@ - ✓ - ✓ - - - - - - - * - ext + lib 1.15 [#PHP1.15-version-parity]_ - ⊛ @@ -57,9 +48,6 @@ - ✓ - ✓ - - - - - - - * - ext 1.14 + lib 1.13 - ⊛ @@ -71,9 +59,6 @@ - ✓ - ✓ - - - - - - - * - ext 1.13 + lib 1.12 - ⊛ @@ -85,9 +70,6 @@ - ✓ - ✓ - - - - - - - * - ext 1.12 + lib 1.11 - ⊛ @@ -99,9 +81,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - * - ext 1.11 + lib 1.10 - ⊛ @@ -113,9 +92,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - * - ext 1.10 + lib 1.9 - ⊛ @@ -127,9 +103,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - * - ext 1.9 + lib 1.8 - ⊛ @@ -141,9 +114,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - * - ext 1.8 + lib 1.7 - ⊛ @@ -155,9 +125,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - * - ext 1.7 + lib 1.6 - ⊛ @@ -169,9 +136,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - * - ext 1.6 + lib 1.5 - ⊛ @@ -183,9 +147,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - * - ext 1.5 + lib 1.4 - ⊛ @@ -197,9 +158,6 @@ - ✓ - ✓ - ✓ - - ✓ - - ✓ - - * - ext 1.4 + lib 1.3 - @@ -211,9 +169,6 @@ - - ✓ - ✓ - - ✓ - - ✓ - - ✓ * - ext 1.3 + lib 1.2 - @@ -225,9 +180,6 @@ - - - ✓ - - ✓ - - ✓ - - ✓ * - ext 1.2 + lib 1.1 - @@ -239,9 +191,6 @@ - - - ✓ - - ✓ - - ✓ - - ✓ * - ext 1.1 + lib 1.0 - @@ -253,9 +202,6 @@ - - - - - ✓ - - ✓ - - ✓ * - ext 1.0 - @@ -267,9 +213,6 @@ - - - - - - - ✓ - - ✓ .. [#PHP1.15-version-parity] Version 1.14 of the MongoDB PHP library has been skipped to restore version parity between the library and extension. From 1524f1132aab81ab224fe32ecaf864c713b09719 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Tue, 17 Sep 2024 17:28:37 -0400 Subject: [PATCH 12/18] internal review --- snooty.toml | 6 +++++- source/compatibility.txt | 21 +++++++++---------- .../language-compatibility-table-php.rst | 2 -- .../mongodb-compatibility-table-php.rst | 2 +- 4 files changed, 16 insertions(+), 15 deletions(-) diff --git a/snooty.toml b/snooty.toml index a074aa74..5fdba324 100644 --- a/snooty.toml +++ b/snooty.toml @@ -1,7 +1,11 @@ name = "php-library" title = "PHP Library Manual" -intersphinx = ["https://www.mongodb.com/docs/manual/objects.inv"] +intersphinx = [ + "https://www.mongodb.com/docs/manual/objects.inv", + "https://www.mongodb.com/docs/drivers/objects.inv", + "https://www.mongodb.com/docs/atlas/objects.inv", +] toc_landing_pages = [ "/reference/class/MongoDBClient", diff --git a/source/compatibility.txt b/source/compatibility.txt index 79d11bb4..30324322 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -21,31 +21,31 @@ MongoDB Compatibility --------------------- The following compatibility table specifies the recommended version or versions -of the PHP driver for use with a specific version of MongoDB. +of the {+php-library+} and extension that you can use with a specific version of MongoDB. -The first column lists the driver version. +The first column lists the version of the library and extension. .. sharedinclude:: dbx/lifecycle-schedule-callout.rst .. include:: /includes/mongodb-compatibility-table-php.rst For more information on how to read the compatibility tables, see our guide on -`MongoDB Compatibility Tables `__. +`MongoDB Compatibility Tables `__. Language Compatibility ---------------------- The following compatibility table specifies the recommended version or versions -of the PHP driver for use with a specific version of PHP. +of the {+php-library+} and extension that you can use with a specific version of PHP. -The first column lists the driver versions. +The first column lists the version of the library and extension. .. include:: /includes/language-compatibility-table-php.rst .. sharedinclude:: dbx/about-driver-compatibility.rst For more information on how to read the compatibility tables, see our guide on -`MongoDB Compatibility Tables `__. +`MongoDB Compatibility Tables `__. How to Get Help --------------- @@ -54,8 +54,7 @@ If you have questions about compatibility, visit the following resources for fur - Ask questions on our :community-forum:`MongoDB Community Forums <>`. - Visit our :technical-support:`Support Channels `. -- File an issue or feature request in JIRA under one of the following: - - - `Extension `_ - - - `Library `_ \ No newline at end of file +- File an issue or feature request in our issue tracker, JIRA, under one of the + following projects:: + - `PHPC - Extension `_ + - `PHPLIB - Library `_ \ No newline at end of file diff --git a/source/includes/language-compatibility-table-php.rst b/source/includes/language-compatibility-table-php.rst index 50319621..c1d961f1 100644 --- a/source/includes/language-compatibility-table-php.rst +++ b/source/includes/language-compatibility-table-php.rst @@ -1,5 +1,3 @@ -.. sharedinclude:: dbx/compatibility-table-legend.rst - .. list-table:: :header-rows: 1 :stub-columns: 1 diff --git a/source/includes/mongodb-compatibility-table-php.rst b/source/includes/mongodb-compatibility-table-php.rst index 82a9c271..807b7979 100644 --- a/source/includes/mongodb-compatibility-table-php.rst +++ b/source/includes/mongodb-compatibility-table-php.rst @@ -214,7 +214,7 @@ - - -.. [#PHP1.15-version-parity] Version 1.14 of the MongoDB PHP library has been +.. [#PHP1.15-version-parity] Version 1.14 of the {+php-library+} has been skipped to restore version parity between the library and extension. .. [#PHPC1.10-PHPLIB1.9-driver-support] The extension 1.10 + library 1.9 From ba51cd64224408fa5fdbcb6f5d6e0a5d65c8b291 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Wed, 18 Sep 2024 13:26:19 -0400 Subject: [PATCH 13/18] test netlify --- source/compatibility.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/compatibility.txt b/source/compatibility.txt index 30324322..a3b324bc 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -47,7 +47,7 @@ The first column lists the version of the library and extension. For more information on how to read the compatibility tables, see our guide on `MongoDB Compatibility Tables `__. -How to Get Help +How To Get Help --------------- If you have questions about compatibility, visit the following resources for further guidance: From 13d165127402b8eac1693e5fdfeb5895299f305d Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Wed, 18 Sep 2024 13:39:19 -0400 Subject: [PATCH 14/18] spacing --- source/compatibility.txt | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/source/compatibility.txt b/source/compatibility.txt index a3b324bc..dce18d4e 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -47,7 +47,7 @@ The first column lists the version of the library and extension. For more information on how to read the compatibility tables, see our guide on `MongoDB Compatibility Tables `__. -How To Get Help +How to Get Help --------------- If you have questions about compatibility, visit the following resources for further guidance: @@ -55,6 +55,8 @@ If you have questions about compatibility, visit the following resources for fur - Ask questions on our :community-forum:`MongoDB Community Forums <>`. - Visit our :technical-support:`Support Channels `. - File an issue or feature request in our issue tracker, JIRA, under one of the - following projects:: + following projects: + - `PHPC - Extension `_ + - `PHPLIB - Library `_ \ No newline at end of file From f8c0b5e8b190e7a6261d9a622a782bc4fc6098b5 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Wed, 18 Sep 2024 14:57:27 -0400 Subject: [PATCH 15/18] try using out of repo ref and add back legend --- source/compatibility.txt | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/compatibility.txt b/source/compatibility.txt index dce18d4e..b162be2f 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -27,10 +27,12 @@ The first column lists the version of the library and extension. .. sharedinclude:: dbx/lifecycle-schedule-callout.rst +.. sharedinclude:: dbx/compatibility-table-legend.rst + .. include:: /includes/mongodb-compatibility-table-php.rst For more information on how to read the compatibility tables, see our guide on -`MongoDB Compatibility Tables `__. +:ref:`MongoDB Compatibility Tables. `. Language Compatibility ---------------------- From 321c3dd4b2bfce833168615016d37ed25ac3e924 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Wed, 18 Sep 2024 15:03:16 -0400 Subject: [PATCH 16/18] ou of repo ref --- source/compatibility.txt | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/source/compatibility.txt b/source/compatibility.txt index b162be2f..e00d461a 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -27,12 +27,10 @@ The first column lists the version of the library and extension. .. sharedinclude:: dbx/lifecycle-schedule-callout.rst -.. sharedinclude:: dbx/compatibility-table-legend.rst - .. include:: /includes/mongodb-compatibility-table-php.rst For more information on how to read the compatibility tables, see our guide on -:ref:`MongoDB Compatibility Tables. `. +:ref:`MongoDB Compatibility Tables `. Language Compatibility ---------------------- @@ -47,7 +45,7 @@ The first column lists the version of the library and extension. .. sharedinclude:: dbx/about-driver-compatibility.rst For more information on how to read the compatibility tables, see our guide on -`MongoDB Compatibility Tables `__. +:ref:`MongoDB Compatibility Tables `. How to Get Help --------------- @@ -61,4 +59,5 @@ If you have questions about compatibility, visit the following resources for fur - `PHPC - Extension `_ - - `PHPLIB - Library `_ \ No newline at end of file + - `PHPLIB - Library `_ + \ No newline at end of file From 26d4a5ee49527154b919564dc65c6a6dcca9b6f3 Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Wed, 18 Sep 2024 15:51:32 -0400 Subject: [PATCH 17/18] legend glitch --- source/compatibility.txt | 3 ++- source/includes/mongodb-compatibility-table-php.rst | 2 -- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/source/compatibility.txt b/source/compatibility.txt index e00d461a..b3362b5a 100644 --- a/source/compatibility.txt +++ b/source/compatibility.txt @@ -27,6 +27,8 @@ The first column lists the version of the library and extension. .. sharedinclude:: dbx/lifecycle-schedule-callout.rst +.. sharedinclude:: dbx/compatibility-table-legend.rst + .. include:: /includes/mongodb-compatibility-table-php.rst For more information on how to read the compatibility tables, see our guide on @@ -60,4 +62,3 @@ If you have questions about compatibility, visit the following resources for fur - `PHPC - Extension `_ - `PHPLIB - Library `_ - \ No newline at end of file diff --git a/source/includes/mongodb-compatibility-table-php.rst b/source/includes/mongodb-compatibility-table-php.rst index 807b7979..9900ded2 100644 --- a/source/includes/mongodb-compatibility-table-php.rst +++ b/source/includes/mongodb-compatibility-table-php.rst @@ -1,5 +1,3 @@ -.. sharedinclude:: dbx/compatibility-table-legend.rst - .. list-table:: :header-rows: 1 :stub-columns: 1 From ae53fbbdd2a9cc7a4dfe6715630ab2cdbd5364bc Mon Sep 17 00:00:00 2001 From: Lindsey Moore Date: Thu, 19 Sep 2024 15:43:41 -0400 Subject: [PATCH 18/18] remove older driver version past 1.15 --- .../language-compatibility-table-php.rst | 111 +---------- .../mongodb-compatibility-table-php.rst | 177 +----------------- 2 files changed, 3 insertions(+), 285 deletions(-) diff --git a/source/includes/language-compatibility-table-php.rst b/source/includes/language-compatibility-table-php.rst index c1d961f1..c50e52b3 100644 --- a/source/includes/language-compatibility-table-php.rst +++ b/source/includes/language-compatibility-table-php.rst @@ -39,120 +39,11 @@ - ✓ - ✓ - - * - ext + lib 1.15 [#PHP1.15-version-parity]_ + * - ext + lib 1.15 - - ✓ - ✓ - ✓ - ✓ - ✓ - - ✓ - - * - ext 1.14 + lib 1.13 - - - - - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.13 + lib 1.12 - - - - - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.12 + lib 1.11 - - - - - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.11 + lib 1.10 - - - - - - - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.10 + lib 1.9 - - - - - - - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.9 + lib 1.8 - - - - - - - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.8 + lib 1.7 - - - - - - - - - - ✓ - - ✓ - - ✓ - - * - ext 1.7 + lib 1.6 - - - - - - - - - - ✓ - - ✓ - - ✓ - - * - ext 1.6 + lib 1.5 - - - - - - - - - - ✓ - - ✓ - - ✓ - - * - ext 1.5 + lib 1.4 - - - - - - - - - - - - ✓ - - ✓ - - * - ext 1.4 + lib 1.3 - - - - - - - - - - - - - - ✓ - - * - ext 1.3 + lib 1.2 - - - - - - - - - - - - - ✓ \ No newline at end of file diff --git a/source/includes/mongodb-compatibility-table-php.rst b/source/includes/mongodb-compatibility-table-php.rst index 9900ded2..febec5a4 100644 --- a/source/includes/mongodb-compatibility-table-php.rst +++ b/source/includes/mongodb-compatibility-table-php.rst @@ -36,7 +36,7 @@ - ✓ - - * - ext + lib 1.15 [#PHP1.15-version-parity]_ + * - ext + lib 1.15 - ⊛ - ⊛ - ✓ @@ -45,177 +45,4 @@ - ✓ - ✓ - ✓ - - - - * - ext 1.14 + lib 1.13 - - ⊛ - - ⊛ - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - - - * - ext 1.13 + lib 1.12 - - ⊛ - - ⊛ - - ⊛ - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - - - * - ext 1.12 + lib 1.11 - - ⊛ - - ⊛ - - ⊛ - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.11 + lib 1.10 - - ⊛ - - ⊛ - - ⊛ - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.10 + lib 1.9 - - ⊛ - - ⊛ - - ⊛ - - ✓ [#PHPC1.10-PHPLIB1.9-driver-support]_ - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.9 + lib 1.8 - - ⊛ - - ⊛ - - ⊛ - - ⊛ - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.8 + lib 1.7 - - ⊛ - - ⊛ - - ⊛ - - ⊛ - - ✓ - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.7 + lib 1.6 - - ⊛ - - ⊛ - - ⊛ - - ⊛ - - ⊛ - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.6 + lib 1.5 - - ⊛ - - ⊛ - - ⊛ - - ⊛ - - ⊛ - - ✓ - - ✓ - - ✓ - - ✓ - - * - ext 1.5 + lib 1.4 - - ⊛ - - ⊛ - - ⊛ - - ⊛ - - ⊛ - - ⊛ - - ✓ - - ✓ - - ✓ - - * - ext 1.4 + lib 1.3 - - - - - - - - - - - - - - - - ✓ - - ✓ - - * - ext 1.3 + lib 1.2 - - - - - - - - - - - - - - - - - - ✓ - - * - ext 1.2 + lib 1.1 - - - - - - - - - - - - - - - - - - ✓ - - * - ext 1.1 + lib 1.0 - - - - - - - - - - - - - - - - - - - - * - ext 1.0 - - - - - - - - - - - - - - - - - - - -.. [#PHP1.15-version-parity] Version 1.14 of the {+php-library+} has been - skipped to restore version parity between the library and extension. - -.. [#PHPC1.10-PHPLIB1.9-driver-support] The extension 1.10 + library 1.9 - driver does not support snapshot reads on secondaries. For more - information, see the - `MongoDB Server version 5.0 release notes `__. \ No newline at end of file + - \ No newline at end of file