@@ -46,16 +46,16 @@ indicates that the library cannot connect to a MongoDB deployment:
4646
4747The following sections describe methods that might help resolve the issue.
4848
49- Check the Connection String
50- ~~~~~~~~~~~~~~~~~~~~~~~~~~~
49+ Check the Connection URI
50+ ~~~~~~~~~~~~~~~~~~~~~~~~
5151
52- Verify that the hostname and port number in the connection string are both
52+ Verify that the hostname and port number in the connection URI are both
5353accurate. In the sample error message, the hostname is ``127.0.0.1`` and the
54- port is ``27017``. The default port value for an instance of MongoDB Server is
54+ port is ``27017``. The default port value for a {+mdb-server+} deployment is
5555``27017``, but you can configure MongoDB to listen on another port.
5656
5757When connecting to a replica set, include all the replica set hosts in
58- your connection string . Separate each of the hosts in the connection
58+ your connection URI . Separate each of the hosts in the connection
5959string with a comma. This enables the library to establish a connection if
6060one of the hosts is unreachable.
6161
@@ -95,34 +95,34 @@ Check the Credentials Formatting
9595~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9696
9797One of the most common causes of authentication issues is invalid
98- credentials formatting in the MongoDB connection string .
98+ credentials formatting in the MongoDB connection URI .
9999
100100.. tip::
101101
102- To learn more information about using connection strings ,
102+ To learn more information about using connection URIs ,
103103 see :ref:`Connection URI <php-connection-uri>` in the
104104 Create a MongoDB Client guide.
105105
106- If your connection string contains a username and password, ensure that
106+ If your connection URI contains a username and password, ensure that
107107they are correctly formatted.
108108
109109.. note::
110110
111- If your username or password includes any of the following characters, you
112- must `percent-encode <https://tools.ietf.org/html/rfc3986#section-2.1>`__ it :
111+ You must `percent-encode <https://tools.ietf.org/html/rfc3986#section-2.1>`__
112+ the following characters if they appear in your username or password :
113113
114114 .. code-block:: none
115115 :copyable: false
116116
117117 : / ? # [ ] @
118118
119- Use your percent-encoded username and password in your connection string .
119+ Use your percent-encoded username and password in your connection URI .
120120
121121Verify the Authentication Mechanism
122122~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
123123
124124Ensure that your credentials and authentication mechanism are correct. You can
125- specify your authentication credentials in the options of your connection string .
125+ specify your authentication credentials in the options of your connection URI .
126126
127127If you use the ``$uriOptions`` parameter to specify an authentication mechanism,
128128ensure that you set the ``'authMechanism'`` option to the correct mechanism. The
@@ -155,7 +155,7 @@ the username must be defined in the authentication database.
155155
156156The default authentication database is the ``admin`` database.
157157To use a different database for authentication, specify the
158- ``authSource`` option in the connection string .
158+ ``authSource`` option in the connection URI .
159159
160160The following example instructs MongoDB to use the ``users`` database
161161as the authentication database:
@@ -198,9 +198,9 @@ in the Atlas documentation.
198198Check the Network Addresses
199199~~~~~~~~~~~~~~~~~~~~~~~~~~~
200200
201- Verify that the network addresses or hostnames in your connection string
201+ Verify that the network addresses or hostnames in your connection URI
202202are accurate.
203203
204204If your deployment is hosted on MongoDB Atlas, you can follow the
205205:atlas:`Connect to Your Cluster </tutorial/connect-to-your-cluster/>`
206- tutorial to find your Atlas connection string .
206+ tutorial to find your Atlas connection URI .
0 commit comments