PHPLIB-596: Add tutorial for connecting to MongoDB (#979)

* PHPLIB-596: Add tutorial for connecting to MongoDB

* Fix formatting breaking TOC

Co-authored-by: Jeremy Mikola <[email protected]>

* Link connecting tutorial on tutorials page

Co-authored-by: Jeremy Mikola <[email protected]>

Author: alcaeus

docs/index.txt

@@ -27,6 +27,8 @@ following pages should help you get started:
 
 - :doc:`/tutorial/install-php-library`
 
+- :doc:`/tutorial/connecting`
+
 - :doc:`/tutorial/crud`
 
 - :doc:`/tutorial/commands`

docs/reference/method/MongoDBClient__construct.txt

@@ -49,12 +49,27 @@ initialized on demand, when the first operation is executed.
 Examples
 --------
 
+.. start-connecting-include
+
+Connecting to a Standalone server
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you do not specify a ``$uri`` value, the driver connects to a standalone
+:program:`mongod` on ``127.0.0.1`` via port ``27017``. To connect to a different
+server, pass the corresponding connection string as the first parameter when
+creating the :phpclass:`Client <MongoDB\\Client>` instance:
+
+.. code-block:: php
+
+   <?php
+
+   $client = new MongoDB\Client('mongodb://mongodb-deployment:27017');
+
 Connecting to a Replica Set
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you do not specify a ``$uri`` value, the driver connects to a standalone
-:program:`mongod` on ``127.0.0.1`` via port ``27017``. The following example
-demonstrates how to connect to a replica set with a custom read preference:
+The following example demonstrates how to connect to a replica set with a custom
+read preference:
 
 .. code-block:: php
 
@@ -106,6 +121,8 @@ which may be specified in the constructor's ``$driverOptions`` parameter. Those
 options are covered in the :php:`MongoDB\\Driver\\Manager::__construct()
 <mongodb-driver-manager.construct>` documentation.
 
+.. end-connecting-include
+
 Specifying a Custom Type Map
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

docs/tutorial.txt

@@ -5,6 +5,7 @@ Tutorials
 
 .. toctree::
 
+   /tutorial/connecting
    /tutorial/crud
    /tutorial/collation
    /tutorial/commands

docs/tutorial/connecting.txt

@@ -0,0 +1,25 @@
+=====================
+Connecting to MongoDB
+=====================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 2
+   :class: singlecol
+
+Creating a Client instance
+--------------------------------------------------------
+
+.. include:: /reference/method/MongoDBClient__construct.txt
+   :start-after: start-connecting-include
+   :end-before: end-connecting-include
+
+Specifying connection options
+-----------------------------
+
+Connection options can be passed via the ``$uri`` parameter, or through the
+``$options`` and ``$driverOptions`` parameters. The available options are
+documented in the :phpmethod:`MongoDB\\Client::__construct()` reference.