Skip to content

Commit bf43a6c

Browse files
committed
test
1 parent 9767bfd commit bf43a6c

File tree

1 file changed

+41
-36
lines changed

1 file changed

+41
-36
lines changed

source/connect/connection-options.txt

Lines changed: 41 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -95,12 +95,12 @@ Replica Set Options
9595

9696
* - :manual:`directConnection </reference/connection-string/#mongodb-urioption-urioption.directConnection>`
9797
- {+bool-data-type+}
98-
- | **MongoDB\Client**: ``$uriOptions = [ 'directConnection' => true ];``
98+
- | **MongoDB\\Client**: ``$uriOptions = [ 'directConnection' => true ];``
9999
| **Connection URI**: ``directConnection=true``
100100

101101
* - :manual:`replicaSet </reference/connection-string/#mongodb-urioption-urioption.replicaSet>`
102102
- {+string-data-type+}
103-
- | **MongoDB\Client**: ``$uriOptions = [ 'replicaSet' => 'replicaSetName' ];``
103+
- | **MongoDB\\Client**: ``$uriOptions = [ 'replicaSet' => 'replicaSetName' ];``
104104
| **Connection URI**: ``replicaSet=replicaSetName``
105105

106106
Connection Options
@@ -124,12 +124,12 @@ Timeout Options
124124

125125
* - :manual:`connectTimeoutMS </reference/connection-string/#mongodb-urioption-urioption.connecttimeoutms>`
126126
- {+int-data-type+}
127-
- | **MongoDB\Client**: ``$uriOptions = [ 'connectTimeoutMS' => 20000 ];``
127+
- | **MongoDB\\Client**: ``$uriOptions = [ 'connectTimeoutMS' => 20000 ];``
128128
| **Connection URI**: ``connectTimeoutMS=20000``
129129

130130
* - :manual:`socketTimeoutMS </reference/connection-string/#mongodb-urioption-urioption.sockettimeoutms>`
131131
- {+int-data-type+}
132-
- | **MongoDB\Client**: ``$uriOptions = [ 'socketTimeoutMS' => 400000 ];``
132+
- | **MongoDB\\Client**: ``$uriOptions = [ 'socketTimeoutMS' => 400000 ];``
133133
| **Connection URI**: ``socketTimeoutMS=400000``
134134

135135
.. _php-compression-options:
@@ -147,12 +147,12 @@ Compression Options
147147

148148
* - :manual:`compressors </reference/connection-string/#mongodb-urioption-urioption.compressors>`
149149
- {+string-data-type+}
150-
- | **MongoDB\Client**: ``$uriOptions = [ 'compressors' => 'snappy,zstd,zlib' ];``
150+
- | **MongoDB\\Client**: ``$uriOptions = [ 'compressors' => 'snappy,zstd,zlib' ];``
151151
| **Connection URI**: ``compressors=snappy,zstd,zlib``
152152

153153
* - :manual:`zlibCompressionLevel </reference/connection-string/#mongodb-urioption-urioption.zlibcompressionlevel>`
154154
- {+int-data-type+}
155-
- | **MongoDB\Client**: ``$uriOptions = [ 'zlibCompressionLevel' => 3 ];``
155+
- | **MongoDB\\Client**: ``$uriOptions = [ 'zlibCompressionLevel' => 3 ];``
156156
| **Connection URI**: ``zlibCompressionLevel=3``
157157

158158
Connection Pool Options
@@ -168,12 +168,12 @@ Connection Pool Options
168168

169169
* - :manual:`maxPoolSize </reference/connection-string/#mongodb-urioption-urioption.maxpoolsize>`
170170
- {+int-data-type+}
171-
- | **MongoDB\Client**: N/A
171+
- | **MongoDB\\Client**: N/A
172172
| **Connection URI**: ``maxPoolSize=75``
173173

174174
* - :manual:`waitQueueTimeoutMS </reference/connection-string/#mongodb-urioption-urioption.waitqueuetimeoutms>`
175175
- {+int-data-type+}
176-
- | **MongoDB\Client**: N/A
176+
- | **MongoDB\\Client**: N/A
177177
| **Connection URI**: ``waitQueueTimeoutMS=10000``
178178

179179
Write Concern Options
@@ -189,17 +189,17 @@ Write Concern Options
189189

190190
* - :manual:`w </reference/connection-string/#mongodb-urioption-urioption.w>`
191191
- {+string-data-type+}
192-
- | **MongoDB\Client**: ``$uriOptions = [ 'w' => 'majority' ];``
192+
- | **MongoDB\\Client**: ``$uriOptions = [ 'w' => 'majority' ];``
193193
| **Connection URI**: ``w=majority``
194194

195195
* - :manual:`wTimeoutMS </reference/connection-string/#mongodb-urioption-urioption.wtimeoutms>`
196196
- {+int-data-type+}
197-
- | **MongoDB\Client**: ``$uriOptions = [ 'wTimeoutMS' => 10000 ];``
197+
- | **MongoDB\\Client**: ``$uriOptions = [ 'wTimeoutMS' => 10000 ];``
198198
| **Connection URI**: ``wTimeoutMS=10000``
199199

200200
* - :manual:`journal </reference/connection-string/#mongodb-urioption-urioption.journal>`
201201
- {+bool-data-type+}
202-
- | **MongoDB\Client**: ``$uriOptions = [ 'journal' => true ];``
202+
- | **MongoDB\\Client**: ``$uriOptions = [ 'journal' => true ];``
203203
| **Connection URI**: ``journal=true``
204204

205205
Read Concern Options
@@ -215,7 +215,7 @@ Read Concern Options
215215

216216
* - :manual:`readConcernLevel </reference/connection-string/#mongodb-urioption-urioption.readconcernlevel>`
217217
- {+string-data-type+}
218-
- | **MongoDB\Client**: ``$uriOptions = [ 'readConcernLevel' => 'majority' ];``
218+
- | **MongoDB\\Client**: ``$uriOptions = [ 'readConcernLevel' => 'majority' ];``
219219
| **Connection URI**: ``readConcernLevel=majority``
220220

221221
Read Preference Options
@@ -230,26 +230,31 @@ Read Preference Options
230230
- Syntax
231231

232232
* - :manual:`readPreference </reference/connection-string/#mongodb-urioption-urioption.readpreference>`
233-
- `MongoDB\\Driver\\ReadPreference <https://www.php.net/manual/en/class.mongodb-driver-readpreference.php>`__
234-
- **MongoDB\Client**:
235-
236-
.. code-block::
237-
238-
$uriOptions = [
239-
'readPreference' => MongoDB\Driver\ReadPreference.RP_SECONDARY_PREFERRED
240-
];
233+
- ``int`` or ``string``
234+
- **MongoDB\\Client**: ``$uriOptions = [ 'readPreference' => 'secondaryPreferred' ];``
241235

242236
**Connection URI**: ``readPreference=secondaryPreferred``
237+
238+
For a complete list of the available values for this option, see the
239+
`MongoDB\\Driver\\ReadPreference <https://www.php.net/manual/en/class.mongodb-driver-readpreference.php>`__
240+
API documentation.
243241

244242
* - :manual:`maxStalenessSeconds </reference/connection-string/#mongodb-urioption-urioption.maxstalenessseconds>`
245243
- {+int-data-type+}
246-
- | **MongoDB\Client**: ``$uriOptions = [ 'maxStalenessSeconds' => 30 ];``
244+
- | **MongoDB\\Client**: ``$uriOptions = [ 'maxStalenessSeconds' => 30 ];``
247245
| **Connection URI**: ``maxStalenessSeconds=30``
248246

249247
* - :manual:`readPreferenceTags </reference/connection-string/#mongodb-urioption-urioption.readpreferencetags>`
250248
- ``array``
251-
- | **MongoDB\Client**: ``$uriOptions = [ 'readPreferenceTags' => [[ 'region' => 'east' ], [ 'region' => 'west']];``
252-
| **Connection URI**: ``readPreferenceTags=region:east,region:west``
249+
- **MongoDB\\Client**:
250+
251+
.. code-block::
252+
253+
$uriOptions = [
254+
'readPreferenceTags' => [[ 'region' => 'east' ], [ 'region' => 'west']]
255+
];
256+
257+
**Connection URI**: ``readPreferenceTags=region:east,region:west``
253258

254259
Authentication Options
255260
~~~~~~~~~~~~~~~~~~~~~~
@@ -265,17 +270,17 @@ Authentication Options
265270

266271
* - :manual:`authMechanism </reference/connection-string/#mongodb-urioption-urioption.authmechanism>`
267272
- {+string-data-type+}
268-
- | **MongoDB\Client**: ``$uriOptions = [ 'authMechanism' => 'MONGODB-X509' ];``
273+
- | **MongoDB\\Client**: ``$uriOptions = [ 'authMechanism' => 'MONGODB-X509' ];``
269274
| **Connection URI**: ``authMechanism=MONGODB-X509``
270275

271276
* - :manual:`authMechanismProperties </reference/connection-string/#mongodb-urioption-urioption.authmechanismproperties>`
272277
- {+string-data-type+}
273-
- | **MongoDB\Client**: ``$uriOptions = [ 'authMechanism' => 'MONGODB-AWS', 'authMechanismProperties' => 'AWS_SESSION_TOKEN:12345' ];``
278+
- | **MongoDB\\Client**: ``$uriOptions = [ 'authMechanism' => 'MONGODB-AWS', 'authMechanismProperties' => 'AWS_SESSION_TOKEN:12345' ];``
274279
| **Connection URI**: ``authMechanism=MONGODB-AWS&authMechanismProperties=AWS_SESSION_TOKEN:12345``
275280

276281
* - :manual:`authSource </reference/connection-string/#mongodb-urioption-urioption.authsource>`
277282
- {+string-data-type+}
278-
- | **MongoDB\Client**: ``$uriOptions = [ 'authSource' => 'admin' ];``
283+
- | **MongoDB\\Client**: ``$uriOptions = [ 'authSource' => 'admin' ];``
279284
| **Connection URI**: ``authSource=admin``
280285

281286
Server Selection and Discovery Options
@@ -292,27 +297,27 @@ Server Selection and Discovery Options
292297

293298
* - :manual:`localThresholdMS </reference/connection-string/#mongodb-urioption-urioption.localthresholdms>`
294299
- {+int-data-type+}
295-
- | **MongoDB\Client**: ``$uriOptions = [ 'localThresholdMS' => 20 ];``
300+
- | **MongoDB\\Client**: ``$uriOptions = [ 'localThresholdMS' => 20 ];``
296301
| **Connection URI**: ``localThresholdMS=20``
297302

298303
* - :manual:`serverSelectionTimeoutMS </reference/connection-string/#mongodb-urioption-urioption.serverselectiontimeoutms>`
299304
- {+int-data-type+}
300-
- | **MongoDB\Client**: ``$uriOptions = [ 'serverSelectionTimeoutMS' => 40000 ];``
305+
- | **MongoDB\\Client**: ``$uriOptions = [ 'serverSelectionTimeoutMS' => 40000 ];``
301306
| **Connection URI**: ``serverSelectionTimeoutMS=40000``
302307

303308
* - :manual:`serverSelectionTryOnce </reference/connection-string/#mongodb-urioption-urioption.serverselectiontryonce>`
304309
- {+bool-data-type+}
305-
- | **MongoDB\Client**: ``$uriOptions = [ 'serverSelectionTryOnce' => false ];``
310+
- | **MongoDB\\Client**: ``$uriOptions = [ 'serverSelectionTryOnce' => false ];``
306311
| **Connection URI**: ``serverSelectionTryOnce=false``
307312

308313
* - :manual:`heartbeatFrequencyMS </reference/connection-string/#mongodb-urioption-urioption.heartbeatfrequencyms>`
309314
- {+int-data-type+}
310-
- | **MongoDB\Client**: ``$uriOptions = [ 'heartbeatFrequencyMS' => 50000 ];``
315+
- | **MongoDB\\Client**: ``$uriOptions = [ 'heartbeatFrequencyMS' => 50000 ];``
311316
| **Connection URI**: ``heartbeatFrequencyMS=50000``
312317

313318
* - :manual:`socketCheckIntervalMS </reference/connection-string/#mongodb-urioption-urioption.socketcheckintervalms>`
314319
- {+int-data-type+}
315-
- | **MongoDB\Client**: ``$uriOptions = [ 'socketCheckIntervalMS' => 4000 ];``
320+
- | **MongoDB\\Client**: ``$uriOptions = [ 'socketCheckIntervalMS' => 4000 ];``
316321
| **Connection URI**: ``socketCheckIntervalMS=4000``
317322

318323
Miscellaneous Configuration
@@ -328,27 +333,27 @@ Miscellaneous Configuration
328333

329334
* - :manual:`appName </reference/connection-string/#mongodb-urioption-urioption.appname>`
330335
- {+string-data-type+}
331-
- | **MongoDB\Client**: ``$uriOptions = [ 'appName' => 'myApp' ];``
336+
- | **MongoDB\\Client**: ``$uriOptions = [ 'appName' => 'myApp' ];``
332337
| **Connection URI**: ``appName=myApp``
333338

334339
* - :manual:`retryReads </reference/connection-string/#mongodb-urioption-urioption.retryreads>`
335340
- {+bool-data-type+}
336-
- | **MongoDB\Client**: ``$uriOptions = [ 'retryReads' => false ];``
341+
- | **MongoDB\\Client**: ``$uriOptions = [ 'retryReads' => false ];``
337342
| **Connection URI**: ``retryReads=false``
338343

339344
* - :manual:`retryWrites </reference/connection-string/#mongodb-urioption-urioption.retrywrites>`
340345
- {+bool-data-type+}
341-
- | **MongoDB\Client**: ``$uriOptions = [ 'retryWrites' => false ];``
346+
- | **MongoDB\\Client**: ``$uriOptions = [ 'retryWrites' => false ];``
342347
| **Connection URI**: ``retryWrites=false``
343348

344349
* - :manual:`loadBalanced </reference/connection-string/#mongodb-urioption-urioption.loadbalanced>`
345350
- {+bool-data-type+}
346-
- | **MongoDB\Client**: ``$uriOptions = [ 'loadBalanced' => true ];``
351+
- | **MongoDB\\Client**: ``$uriOptions = [ 'loadBalanced' => true ];``
347352
| **Connection URI**: ``loadBalanced=false``
348353

349354
* - :manual:`srvMaxHosts </reference/connection-string/#mongodb-urioption-urioption.srvmaxhosts>`
350355
- {+int-data-type+}
351-
- | **MongoDB\Client**: ``$uriOptions = [ 'srvMaxHosts' => 5 ];``
356+
- | **MongoDB\\Client**: ``$uriOptions = [ 'srvMaxHosts' => 5 ];``
352357
| **Connection URI**: ``srvMaxHosts=5``
353358

354359
API Documentation

0 commit comments

Comments
 (0)