Skip to content

Documentation updates for ext-mongodb 1.21 - #4500

Merged
jmikola merged 3 commits into
php:masterfrom
jmikola:mongodb-1.21
Feb 27, 2025
Merged

Documentation updates for ext-mongodb 1.21#4500
jmikola merged 3 commits into
php:masterfrom
jmikola:mongodb-1.21

Conversation

@jmikola

Copy link
Copy Markdown
Member

@jmikola
jmikola merged commit 51ea49d into php:masterFeb 27, 2025
@jmikola
jmikola deleted the mongodb-1.21 branch February 27, 2025 15:24
<methodparam><type>string</type><parameter>db</parameter></methodparam>
<methodparam><type>MongoDB\Driver\Command</type><parameter>command</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>array</type><type>MongoDB\Driver\ReadPreference</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Maybe you should use the #[\Deprecated] attribute for parameter to indicate it is deprecated?

@TimWolla is this supported by the engine btw?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

is this supported by the engine btw?

Yes, it's used for all deprecations in PHP core to provide the message: php/php-src#14750

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Oh, I misread: No, it's not supported for parameters.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

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

FWIW, we explicitly raise a deprecation notice in the 1.x branch: https://github.com/mongodb/mongo-php-driver/blob/v1.x/src/phongo_util.c#L95

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

@jmikola@TimWolla@alcaeus@Girgias