Merge branch 'v1.8'

* v1.8:
  Update tested driver versions
  PHPLIB-577: Add examples for aggregation methods (#797)
  Fixed missing backslash in documentation (#794)

Author: alcaeus

.evergreen/config.yml

@@ -439,7 +439,7 @@ axes:
         variables:
           DRIVER_VERSION: "1.8.1"
       - id: "latest-stable"
-        display_name: "1.8-stable"
+        display_name: "1.9-stable"
         variables:
           DRIVER_VERSION: "stable"
       - id: "1.8-dev"

.travis.yml

@@ -51,17 +51,13 @@ jobs:
     # Test against PHP 8
     - stage: Test
       php: "8.0snapshot"
-      env:
-        - DRIVER_VERSION="1.9.0RC1"
     - stage: Test
       php: "8.0snapshot"
       env:
-        - DRIVER_VERSION="1.9.0RC1"
         - DEPLOYMENT=REPLICASET
     - stage: Test
       php: "8.0snapshot"
       env:
-        - DRIVER_VERSION="1.9.0RC1"
         - DEPLOYMENT=SHARDED_CLUSTER_RS
 
 before_install:

docs/reference/method/MongoDBCollection-aggregate.txt

@@ -58,7 +58,25 @@ MongoDB server version and whether the ``useCursor`` option is specified. If
 ``result`` array from the command response document. In both cases, the return
 value will be :php:`Traversable <traversable>`.
 
-.. todo: add examples
+Examples
+--------
+
+The following aggregation example uses a collection called ``names`` and groups
+the ``first_name`` field together, counts the total number of results in each
+group, and sorts the results by name.
+
+.. code-block:: php
+
+   <?php
+
+   $collection = (new MongoDB\Client)->test->names;
+
+   $cursor = $collection->aggregate(
+       [
+           ['$group' => ['_id' => '$first_name', 'name_count' => ['$sum' => 1]]],
+           ['$sort' => ['_id' => 1]],
+       ]
+   );
 
 See Also
 --------

docs/reference/method/MongoDBDatabase-aggregate.txt

@@ -51,7 +51,25 @@ Errors/Exceptions
 
 .. _php-db-agg-method-behavior:
 
-.. todo: add examples
+Examples
+--------
+
+The following aggregation example lists all running commands using the
+``$currentOp`` aggregation pipeline stage, then filters this list to only show
+running command operations.
+
+.. code-block:: php
+
+   <?php
+
+   $database = (new MongoDB\Client)->admin;
+
+   $cursor = $database->aggregate(
+       [
+           ['$currentOp' => []],
+           ['$match' => ['op' => 'command'],
+       ]
+   );
 
 See Also
 --------

docs/tutorial/collation.txt

@@ -360,7 +360,7 @@ group, and sorts the results by German phonebook order.
 
    <?php
 
-   $collection = (new MongoDB\Client)->test->recipes;
+   $collection = (new MongoDB\Client)->test->names;
 
    $cursor = $collection->aggregate(
        [

docs/tutorial/custom-types.txt

@@ -23,7 +23,7 @@ to convert to BSON and store in the database. That data will later be used to
 reconstruct the object upon reading from the database.
 
 As an example we present the ``LocalDateTime`` class. This class wraps around
-the :php:`MongoDB\\BSON\UTCDateTime <class.mongodb-bson-utcdatetime>` data
+the :php:`MongoDB\\BSON\\UTCDateTime <class.mongodb-bson-utcdatetime>` data
 type and a time zone.
 
 .. code-block:: php