Skip to content

DOCSP-44581: v2 release #234

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Apr 11, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions config/redirects
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
define: base https://www.mongodb.com/docs/php-library
define: prefix docs/php-library
raw: ${prefix}/ -> ${base}/current
define: versions v1.16 v1.17 v1.18 v1.19 v1.20 v1.21 master
define: versions v1.16 v1.17 v1.18 v1.19 v1.20 v1.21 v2.0 master

symlink: upcoming -> master
symlink: current -> v1.21
symlink: current -> v2.0

# general redirects
[v1.17-v1.19]: ${prefix}/${version}/tutorial/client-side-encryption/ -> ${base}/${version}/tutorial/encryption/
Expand Down
4 changes: 2 additions & 2 deletions snooty.toml
Original file line number Diff line number Diff line change
Expand Up @@ -38,8 +38,8 @@ php-library = "MongoDB PHP Library"

[constants]
php-library = "MongoDB PHP Library"
version = "1.21"
source-gh-branch = "v1.x"
version = "2.0"
source-gh-branch = "v2.x"
full-version = "{+version+}.0"
extension-short = "PHP extension"
mdb-server = "MongoDB Server"
Expand Down
2 changes: 1 addition & 1 deletion source/includes/language-compatibility-table-php.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
- PHP 7.3
- PHP 7.2

* - ext + lib 1.21
* - ext + lib 1.21 to 2.0
- ✓
- ✓
- ✓
Expand Down
14 changes: 13 additions & 1 deletion source/includes/mongodb-compatibility-table-php.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,17 @@
- MongoDB 4.0
- MongoDB 3.6

* - ext + lib 1.20 to 1.21
* - ext + lib 1.21 to 2.0
- ✓
- ✓
- ✓
- ✓
- ✓
- ✓
- ✓ [#deprecation-note]_
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the PHPLIB 2.0.0 release notes, MongoDB 4.2+ is reported:

MongoDB 4.2+ Required: Future versions of the library will require MongoDB 4.2 or later. MongoDB 4.0 support is deprecated.

That seems to contradict itself, as there doesn't appear to be anything in PHPLIB that drops support for MongoDB 4.0.

In the corresponding PHPC release notes, the deprecation of MongoDB 4.0 is only mentioned in 1.21.0 and there is nothing about that mentioned in the 2.0.0 notes. I think that was an oversight and the 2.0.0 notes should simply have repeated the notice about an upcoming deprecation for MongoDB 4.0.

I think the compatibility table in this PR is correct, but wanted to drop a comment here so @alcaeus or @GromNaN can correct the release notes.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Strictly speaking, announcing the deprecation in 1.21.0 covers us and the note in 2.0.0 is not strictly required. I've added the same note to the PHPC release notes nonetheless.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great, I'll leave the table as is then! Thanks for the info!

-

* - ext + lib 1.20
- ✓
- ✓
- ✓
Expand Down Expand Up @@ -42,3 +52,5 @@
- ✓
- ✓
- ✓

.. [#deprecation-note] Support for this MongoDB version is deprecated and will be removed in a future release.
3 changes: 3 additions & 0 deletions source/whats-new.txt
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,9 @@ and removals:
examples that use this construction, see the
:ref:`php-aggregation-builder-api` section of the Aggregation guide.

- Replaces ``Cursor`` type hints with ``CursorInterface`` for better
extensibility and compatibility.

- Removes deprecated fields in GridFS types.

- The library does not calculate the ``md5`` field when a file is
Expand Down
Loading