-
Notifications
You must be signed in to change notification settings - Fork 265
PHPLIB-340: Deprecate maxScan query option #532
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
Conversation
jmikola
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I deprecated another option this morning in #533, so comments here are framed with that in mind.
| description: | | ||
| Maximum number of documents or index keys to scan when executing the query. | ||
| .. versionadded:: 1.2 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Removing these options would technically be a BC break. We should actually note that they're deprecated in the documentation with .. deprecated:: 1.4.
| * on new documents to satisfy a query, if cursorType is TAILABLE_AWAIT. | ||
| * | ||
| * * maxScan (integer): Maximum number of documents or index keys to scan | ||
| * when executing the query. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We can add a sentence or paragraph here that says "Deprecated since 1.4."
| * * max (document): The exclusive upper bound for a specific index. | ||
| * | ||
| * * maxScan (integer): Maximum number of documents or index keys to scan | ||
| * when executing the query. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This can be synced with the Find.php text once you add a note there.
|
|
||
| foreach ($this->getInvalidIntegerValues() as $value) { | ||
| $options[][] = ['maxScan' => $value]; | ||
| } |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This can stay and we can add a deprecation notice test as I'm doing with https://github.com/mongodb/mongo-php-library/pull/533/files#diff-aa6398bbbe577c2105dfa55f4afcf30b (once that's merged).
https://jira.mongodb.org/browse/PHPLIB-340