DOCSP-50185: Connection troubleshooting #272
Merged
+207
−3
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
✅ Deploy Preview for docs-php-library ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
mcmorisi
approved these changes
Jun 17, 2025
Comment on lines
54
to
55
| port is ``27017``. The default port value for an instance of MongoDB Server is | ||
| ``27017``, but you can configure MongoDB to listen on another port. |
There was a problem hiding this comment.
Suggested change
| port is ``27017``. The default port value for an instance of MongoDB Server is | |
| ``27017``, but you can configure MongoDB to listen on another port. | |
| port is ``27017``. The default port value for a {+mdb-server+} deployment is | |
| ``27017``, but you can configure MongoDB to listen on another port. |
Comment on lines
+83
to
+84
| The {+driver-short+} may be unable connect to a MongoDB deployment if | ||
| the authorization is not configured correctly. In these cases, the library |
There was a problem hiding this comment.
Suggested change
| The {+driver-short+} may be unable connect to a MongoDB deployment if | |
| the authorization is not configured correctly. In these cases, the library | |
| The {+driver-short+} may fail to connect to a MongoDB deployment if | |
| the authorization is not configured correctly. In these cases, the library |
There was a problem hiding this comment.
I'll keep as "unable" for style guide reasons
|
|
||
| The following sections describe methods that might help resolve the issue. | ||
|
|
||
| Check the Connection String |
There was a problem hiding this comment.
Thoughts about changing all occurrences of "connection string" to "connection URI"? Seems to be the wording we've been trending towards across our docs.
Comment on lines
111
to
112
| If your username or password includes any of the following characters, you | ||
| must `percent-encode <https://tools.ietf.org/html/rfc3986#section-2.1>`__ it: |
There was a problem hiding this comment.
Suggested change
| If your username or password includes any of the following characters, you | |
| must `percent-encode <https://tools.ietf.org/html/rfc3986#section-2.1>`__ it: | |
| You | |
| must `percent-encode <https://tools.ietf.org/html/rfc3986#section-2.1>`__ the following characters if they appear in your username or password: |
norareidy
requested review from
a team and
GromNaN
and removed request for
a team
GromNaN
approved these changes
Jun 24, 2025
| @@ -34,7 +34,7 @@ Set Connection Options | |||
| You can configure your connection by specifying options in the connection URI or by | |||
| passing them to the ``MongoDB\Client`` constructor. | |||
|
|
|||
| .. _php-connection-uri: | |||
| .. _php-connection-options-uri: | |||
There was a problem hiding this comment.
Why should this be changed? The previous slug matched the title better.
There was a problem hiding this comment.
This was a duplicate label - there's another php-connection-uri for this section of the Create a Client page, and it seemed like more of a general overview of URIs
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Pull Request Info
PR Reviewing Guidelines
JIRA - https://jira.mongodb.org/browse/DOCSP-50185
This PR uses the copy from the shared Connection Troubleshooting page but removes information about connection pooling, which the PHP library does not support.
Staging Links
Self-Review Checklist