Merge pull request #4

.travis.yml

@@ -7,12 +7,29 @@ php:
   - 5.6
 
 env:
-  - MONGODB_VERSION=alpha
+  global:
+    - KEY_SERVER="hkp://keyserver.ubuntu.com:80"
+    - MONGO_REPO_URI="http://repo.mongodb.com/apt/ubuntu"
+    - MONGO_REPO_TYPE="precise/mongodb-enterprise/"
+    - SOURCES_LOC="/etc/apt/sources.list.d/mongodb.list"
+  matrix:
+    - DRIVER_VERSION=alpha SERVER_VERSION=2.4
+    - DRIVER_VERSION=alpha SERVER_VERSION=2.6
+    - DRIVER_VERSION=alpha SERVER_VERSION=3.0
 
-services: mongodb
+before_install:
+  - sudo apt-key adv --keyserver ${KEY_SERVER} --recv 7F0CEB10
+  - echo "deb ${MONGO_REPO_URI} ${MONGO_REPO_TYPE}${SERVER_VERSION} multiverse" | sudo tee ${SOURCES_LOC}
+  - sudo apt-get update -qq
+
+install:
+  - if dpkg --compare-versions ${SERVER_VERSION} le "2.4"; then export SERVER_PACKAGE=mongodb-10gen-enterprise; else export SERVER_PACKAGE=mongodb-enterprise; fi
+  - sudo apt-get install ${SERVER_PACKAGE}
 
 before_script:
-  - mongo --eval 'tojson(db.runCommand({buildInfo:1}))'
-  - pecl install -f mongodb-${MONGODB_VERSION}
+  - if dpkg --compare-versions ${SERVER_VERSION} le "2.4"; then export SERVER_SERVICE=mongodb; else export SERVER_SERVICE=mongod; fi
+  - if ! nc -z localhost 27017; then sudo service ${SERVER_SERVICE} start; fi
+  - mongod --version
+  - pecl install -f mongodb-${DRIVER_VERSION}
   - php --ri mongodb
   - composer install --dev --no-interaction --prefer-source

phpunit.xml.dist

@@ -16,7 +16,7 @@
 
     <php>
         <ini name="error_reporting" value="-1"/>
-        <env name="MONGODB_URI" value="mongodb://127.0.0.1:27017"/>
+        <env name="MONGODB_URI" value="mongodb://127.0.0.1:27017/?serverSelectionTimeoutMS=100"/>
         <env name="MONGODB_DATABASE" value="phplib_test"/>
     </php>
 

src/FeatureDetection.php

@@ -14,6 +14,7 @@ class FeatureDetection
     const API_LISTCOLLECTIONS_CMD = 3;
     const API_LISTINDEXES_CMD = 3;
     const API_CREATEINDEXES_CMD = 2;
+    const API_AGGREGATE_CURSOR = 2;
 
     /**
      * Return whether the server supports a particular feature.

src/InsertManyResult.php

@@ -16,7 +16,7 @@ class InsertManyResult
      * Constructor.
      *
      * @param WriteResult $writeResult
-     * @param array       $insertedIds
+     * @param mixed[]     $insertedIds
      */
     public function __construct(WriteResult $writeResult, array $insertedIds = array())
     {
@@ -41,10 +41,11 @@ class InsertManyResult
      * Return the map of inserted IDs that were generated by the driver.
      *
      * The index of each ID in the map corresponds to the document's position
-     * in bulk operation. If an inserted document already had an ID (e.g. it was
-     * generated by the application), it will not be present in this map.
+     * in bulk operation. If the document already an ID prior to insertion (i.e.
+     * the driver did not need to generate an ID), this will contain its "_id".
+     * Any driver-generated ID will be an MongoDB\Driver\ObjectID instance.
      *
-     * @return array
+     * @return mixed[]
      */
     public function getInsertedIds()
     {

src/InsertOneResult.php

@@ -2,7 +2,6 @@
 
 namespace MongoDB;
 
-use BSON\ObjectId;
 use MongoDB\Driver\WriteResult;
 
 /**
@@ -17,9 +16,9 @@ class InsertOneResult
      * Constructor.
      *
      * @param WriteResult $writeResult
-     * @param ObjectId    $insertedId
+     * @param mixed       $insertedId
      */
-    public function __construct(WriteResult $writeResult, ObjectId $insertedId = null)
+    public function __construct(WriteResult $writeResult, $insertedId)
     {
         $this->writeResult = $writeResult;
         $this->insertedId = $insertedId;
@@ -41,10 +40,11 @@ class InsertOneResult
     /**
      * Return the inserted ID that was generated by the driver.
      *
-     * If the inserted document already had an ID (e.g. it was generated by the
-     * application), this will be null.
+     * If the document already an ID prior to insertion (i.e. the driver did not
+     * need to generate an ID), this will contain its "_id". Any
+     * driver-generated ID will be an MongoDB\Driver\ObjectID instance.
      *
-     * @return ObjectId|null
+     * @return mixed
      */
     public function getInsertedId()
     {

tests/Collection/CollectionFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection;
+
+use MongoDB\Tests\FixtureGenerator;
+
+/**
+ * Functional tests for the Collection class.
+ */
+class CollectionFunctionalTest extends FunctionalTestCase
+{
+    public function testDrop()
+    {
+        $writeResult = $this->collection->insertOne(array('x' => 1));
+        $this->assertEquals(1, $writeResult->getInsertedCount());
+
+        $commandResult = $this->collection->drop();
+        $this->assertCommandSucceeded($commandResult);
+        $this->assertCollectionCount($this->getNamespace(), 0);
+    }
+
+    function testInsertAndRetrieve()
+    {
+        $generator = new FixtureGenerator();
+
+        for ($i = 0; $i < 10; $i++) {
+            $user = $generator->createUser();
+            $result = $this->collection->insertOne($user);
+            $this->assertInstanceOf('MongoDB\InsertOneResult', $result);
+            $this->assertInstanceOf('BSON\ObjectId', $result->getInsertedId());
+            $this->assertEquals(24, strlen($result->getInsertedId()));
+
+            $user["_id"] = $result->getInsertedId();
+            $document = $this->collection->findOne(array("_id" => $result->getInsertedId()));
+            $this->assertEquals($document, $user, "The inserted and returned objects are the same");
+        }
+
+        $this->assertEquals(10, $i);
+
+        $query = array("firstName" => "Ransom");
+        $count = $this->collection->count($query);
+        $this->assertEquals(1, $count);
+        $cursor = $this->collection->find($query);
+        $this->assertInstanceOf('MongoDB\Driver\Cursor', $cursor);
+
+        foreach($cursor as $n => $person) {
+            $this->assertInternalType("array", $person);
+        }
+        $this->assertEquals(0, $n);
+    }
+}

tests/Collection/CrudSpec/AggregateFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+use MongoDB\Collection;
+use MongoDB\FeatureDetection;
+use MongoDB\Driver\ReadPreference;
+
+/**
+ * CRUD spec functional tests for aggregate().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class AggregateFunctionalTest extends FunctionalTestCase
+{
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(3);
+    }
+
+    public function testAggregateWithMultipleStages()
+    {
+        $cursor = $this->collection->aggregate(
+            array(
+                array('$sort' => array('x' => 1)),
+                array('$match' => array('_id' => array('$gt' => 1))),
+            ),
+            array('batchSize' => 2)
+        );
+
+        $expected = array(
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        // Use iterator_to_array() here since aggregate() may return an ArrayIterator
+        $this->assertSame($expected, iterator_to_array($cursor));
+    }
+
+    public function testAggregateWithOut()
+    {
+        $server = $this->manager->selectServer(new ReadPreference(ReadPreference::RP_PRIMARY));
+
+        if ( ! FeatureDetection::isSupported($server, FeatureDetection::API_AGGREGATE_CURSOR)) {
+            $this->markTestSkipped('$out aggregation pipeline operator is not supported');
+        }
+
+        $outputCollection = new Collection($this->manager, $this->getNamespace() . '_output');
+        $this->dropCollectionIfItExists($outputCollection);
+
+        $this->collection->aggregate(
+            array(
+                array('$sort' => array('x' => 1)),
+                array('$match' => array('_id' => array('$gt' => 1))),
+                array('$out' => $outputCollection->getCollectionName()),
+            )
+        );
+
+        $expected = array(
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $outputCollection->find()->toArray());
+
+        // Manually clean up our output collection
+        $this->dropCollectionIfItExists($outputCollection);
+    }
+}

tests/Collection/CrudSpec/CountFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+/**
+ * CRUD spec functional tests for count().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class CountFunctionalTest extends FunctionalTestCase
+{
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(3);
+    }
+
+    public function testCountWithoutFilter()
+    {
+        $this->assertSame(3, $this->collection->count());
+    }
+
+    public function testCountWithFilter()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+
+        $this->assertSame(2, $this->collection->count($filter));
+    }
+
+    public function testCountWithSkipAndLimit()
+    {
+        $filter = array();
+        $options = array('skip' => 1, 'limit' => 3);
+
+        $this->assertSame(2, $this->collection->count($filter, $options));
+    }
+}

tests/Collection/CrudSpec/DeleteManyFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+/**
+ * CRUD spec functional tests for deleteMany().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class DeleteManyFunctionalTest extends FunctionalTestCase
+{
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(3);
+    }
+
+    public function testDeleteManyWhenManyDocumentsMatch()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+
+        $result = $this->collection->deleteMany($filter);
+        $this->assertSame(2, $result->getDeletedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testDeleteManyWhenNoDocumentsMatch()
+    {
+        $filter = array('_id' => 4);
+
+        $result = $this->collection->deleteMany($filter);
+        $this->assertSame(0, $result->getDeletedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+}

tests/Collection/CrudSpec/DeleteOneFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+/**
+ * CRUD spec functional tests for deleteOne().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class DeleteOneFunctionalTest extends FunctionalTestCase
+{
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(3);
+    }
+
+    public function testDeleteOneWhenManyDocumentsMatch()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+
+        $result = $this->collection->deleteOne($filter);
+        $this->assertSame(1, $result->getDeletedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testDeleteOneWhenOneDocumentMatches()
+    {
+        $filter = array('_id' => 2);
+
+        $result = $this->collection->deleteOne($filter);
+        $this->assertSame(1, $result->getDeletedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testDeleteOneWhenNoDocumentsMatch()
+    {
+        $filter = array('_id' => 4);
+
+        $result = $this->collection->deleteOne($filter);
+        $this->assertSame(0, $result->getDeletedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+}

tests/Collection/CrudSpec/DistinctFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+/**
+ * CRUD spec functional tests for distinct().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class DistinctFunctionalTest extends FunctionalTestCase
+{
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(3);
+    }
+
+    public function testDistinctWithoutFilter()
+    {
+        $this->assertSame(array(11, 22, 33), $this->collection->distinct('x'));
+    }
+
+    public function testDistinctWithFilter()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+
+        $this->assertSame(array(22, 33), $this->collection->distinct('x', $filter));
+    }
+}

tests/Collection/CrudSpec/FindFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+/**
+ * CRUD spec functional tests for find().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class FindFunctionalTest extends FunctionalTestCase
+{
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(5);
+    }
+
+    public function testFindWithFilter()
+    {
+        $filter = array('_id' => 1);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+        );
+
+        $this->assertSame($expected, $this->collection->find($filter)->toArray());
+    }
+
+    public function testFindWithFilterSortSkipAndLimit()
+    {
+        $filter = array('_id' => array('$gt' => 2));
+        $options = array(
+            'sort' => array('_id' => 1),
+            'skip' => 2,
+            'limit' => 2,
+        );
+
+        $expected = array(
+            array('_id' => 5, 'x' => 55),
+        );
+
+        $this->assertSame($expected, $this->collection->find($filter, $options)->toArray());
+    }
+
+    public function testFindWithLimitSortAndBatchSize()
+    {
+        $filter = array();
+        $options = array(
+            'sort' => array('_id' => 1),
+            'limit' => 4,
+            'batchSize' => 2,
+        );
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+            array('_id' => 4, 'x' => 44),
+        );
+
+        $this->assertSame($expected, $this->collection->find($filter, $options)->toArray());
+    }
+}

tests/Collection/CrudSpec/FindOneAndDeleteFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+/**
+ * CRUD spec functional tests for findOneAndDelete().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class FindOneAndDeleteFunctionalTest extends FunctionalTestCase
+{
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(3);
+    }
+
+    public function testFindOneAndDeleteWhenManyDocumentsMatch()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+        );
+
+        $document = $this->collection->findOneAndDelete($filter, $options);
+        $this->assertSame(array('x' => 22), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndDeleteWhenOneDocumentMatches()
+    {
+        $filter = array('_id' => 2);
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+        );
+
+        $document = $this->collection->findOneAndDelete($filter, $options);
+        $this->assertSame(array('x' => 22), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndDeleteWhenNoDocumentsMatch()
+    {
+        $filter = array('_id' => 4);
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+        );
+
+        $document = $this->collection->findOneAndDelete($filter, $options);
+        $this->assertNull($document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+}

tests/Collection/CrudSpec/FindOneAndReplaceFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+use MongoDB\Collection;
+
+/**
+ * CRUD spec functional tests for findOneAndReplace().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class FindOneAndReplaceFunctionalTest extends FunctionalTestCase
+{
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(3);
+    }
+
+    public function testFindOneAndReplaceWhenManyDocumentsMatchReturningDocumentBeforeModification()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+        $replacement = array('x' => 32);
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+        );
+
+        $document = $this->collection->findOneAndReplace($filter, $replacement, $options);
+        $this->assertSame(array('x' => 22), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 32),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndReplaceWhenManyDocumentsMatchReturningDocumentAfterModification()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+        $replacement = array('x' => 32);
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+            'returnDocument' => Collection::FIND_ONE_AND_RETURN_AFTER,
+        );
+
+        $document = $this->collection->findOneAndReplace($filter, $replacement, $options);
+        $this->assertSame(array('x' => 32), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 32),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndReplaceWhenOneDocumentMatchesReturningDocumentBeforeModification()
+    {
+        $filter = array('_id' => 2);
+        $replacement = array('x' => 32);
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+        );
+
+        $document = $this->collection->findOneAndReplace($filter, $replacement, $options);
+        $this->assertSame(array('x' => 22), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 32),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndReplaceWhenOneDocumentMatchesReturningDocumentAfterModification()
+    {
+        $filter = array('_id' => 2);
+        $replacement = array('x' => 32);
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+            'returnDocument' => Collection::FIND_ONE_AND_RETURN_AFTER,
+        );
+
+        $document = $this->collection->findOneAndReplace($filter, $replacement, $options);
+        $this->assertSame(array('x' => 32), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 32),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndReplaceWhenNoDocumentsMatchReturningDocumentBeforeModification()
+    {
+        $filter = array('_id' => 4);
+        $replacement = array('x' => 44);
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+        );
+
+        $document = $this->collection->findOneAndReplace($filter, $replacement, $options);
+        $this->assertNull($document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndReplaceWithUpsertWhenNoDocumentsMatchReturningDocumentBeforeModification()
+    {
+        $filter = array('_id' => 4);
+        // Server 2.4 and earlier requires any custom ID to also be in the replacement document
+        $replacement = array('_id' => 4, 'x' => 44);
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+            'upsert' => true,
+        );
+
+        $document = $this->collection->findOneAndReplace($filter, $replacement, $options);
+        $this->assertNull($document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+            array('_id' => 4, 'x' => 44),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndReplaceWhenNoDocumentsMatchReturningDocumentAfterModification()
+    {
+        $filter = array('_id' => 4);
+        $replacement = array('x' => 44);
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+            'returnDocument' => Collection::FIND_ONE_AND_RETURN_AFTER,
+        );
+
+        $document = $this->collection->findOneAndReplace($filter, $replacement, $options);
+        $this->assertNull($document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndReplaceWithUpsertWhenNoDocumentsMatchReturningDocumentAfterModification()
+    {
+        $filter = array('_id' => 4);
+        // Server 2.4 and earlier requires any custom ID to also be in the replacement document
+        $replacement = array('_id' => 4, 'x' => 44);
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+            'returnDocument' => Collection::FIND_ONE_AND_RETURN_AFTER,
+            'upsert' => true,
+        );
+
+        $document = $this->collection->findOneAndReplace($filter, $replacement, $options);
+        $this->assertSame(array('x' => 44), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+            array('_id' => 4, 'x' => 44),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+}

tests/Collection/CrudSpec/FindOneAndUpdateFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+use MongoDB\Collection;
+
+/**
+ * CRUD spec functional tests for findOneAndUpdate().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class FindOneAndUpdateFunctionalTest extends FunctionalTestCase
+{
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(3);
+    }
+
+    public function testFindOneAndUpdateWhenManyDocumentsMatchReturningDocumentBeforeModification()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+        $update = array('$inc' => array('x' => 1));
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+        );
+
+        $document = $this->collection->findOneAndUpdate($filter, $update, $options);
+        $this->assertSame(array('x' => 22), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 23),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndUpdateWhenManyDocumentsMatchReturningDocumentAfterModification()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+        $update = array('$inc' => array('x' => 1));
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+            'returnDocument' => Collection::FIND_ONE_AND_RETURN_AFTER,
+        );
+
+        $document = $this->collection->findOneAndUpdate($filter, $update, $options);
+        $this->assertSame(array('x' => 23), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 23),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndUpdateWhenOneDocumentMatchesReturningDocumentBeforeModification()
+    {
+        $filter = array('_id' => 2);
+        $update = array('$inc' => array('x' => 1));
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+        );
+
+        $document = $this->collection->findOneAndUpdate($filter, $update, $options);
+        $this->assertSame(array('x' => 22), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 23),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndUpdateWhenOneDocumentMatchesReturningDocumentAfterModification()
+    {
+        $filter = array('_id' => 2);
+        $update = array('$inc' => array('x' => 1));
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+            'returnDocument' => Collection::FIND_ONE_AND_RETURN_AFTER,
+        );
+
+        $document = $this->collection->findOneAndUpdate($filter, $update, $options);
+        $this->assertSame(array('x' => 23), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 23),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndUpdateWhenNoDocumentsMatchReturningDocumentBeforeModification()
+    {
+        $filter = array('_id' => 4);
+        $update = array('$inc' => array('x' => 1));
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+        );
+
+        $document = $this->collection->findOneAndUpdate($filter, $update, $options);
+        $this->assertNull($document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndUpdateWithUpsertWhenNoDocumentsMatchReturningDocumentBeforeModification()
+    {
+        $filter = array('_id' => 4);
+        $update = array('$inc' => array('x' => 1));
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+            'upsert' => true,
+        );
+
+        $document = $this->collection->findOneAndUpdate($filter, $update, $options);
+        $this->assertNull($document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+            array('_id' => 4, 'x' => 1),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndUpdateWhenNoDocumentsMatchReturningDocumentAfterModification()
+    {
+        $filter = array('_id' => 4);
+        $update = array('$inc' => array('x' => 1));
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+            'returnDocument' => Collection::FIND_ONE_AND_RETURN_AFTER,
+        );
+
+        $document = $this->collection->findOneAndUpdate($filter, $update, $options);
+        $this->assertNull($document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testFindOneAndUpdateWithUpsertWhenNoDocumentsMatchReturningDocumentAfterModification()
+    {
+        $filter = array('_id' => 4);
+        $update = array('$inc' => array('x' => 1));
+        $options = array(
+            'projection' => array('x' => 1, '_id' => 0),
+            'sort' => array('x' => 1),
+            'returnDocument' => Collection::FIND_ONE_AND_RETURN_AFTER,
+            'upsert' => true,
+        );
+
+        $document = $this->collection->findOneAndUpdate($filter, $update, $options);
+        $this->assertSame(array('x' => 1), $document);
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+            array('_id' => 4, 'x' => 1),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+}

tests/Collection/CrudSpec/FunctionalTestCase.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+use MongoDB\Driver\BulkWrite;
+use MongoDB\Tests\Collection\FunctionalTestCase as BaseFunctionalTestCase;
+
+/**
+ * Base class for Collection CRUD spec functional tests.
+ */
+abstract class FunctionalTestCase extends BaseFunctionalTestCase
+{
+    /**
+     * Create data fixtures.
+     *
+     * @param integer $n
+     */
+    protected function createFixtures($n)
+    {
+        $bulkWrite = new BulkWrite(true);
+
+        for ($i = 1; $i <= $n; $i++) {
+            $bulkWrite->insert(array(
+                '_id' => $i,
+                'x' => (integer) ($i . $i),
+            ));
+        }
+
+        $result = $this->manager->executeBulkWrite($this->getNamespace(), $bulkWrite);
+
+        $this->assertEquals($n, $result->getInsertedCount());
+    }
+}

tests/Collection/CrudSpec/InsertManyFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+/**
+ * CRUD spec functional tests for insertMany().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class InsertManyFunctionalTest extends FunctionalTestCase
+{
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(1);
+    }
+
+    public function testInsertManyWithNonexistentDocuments()
+    {
+        $documents = array(
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $result = $this->collection->insertMany($documents);
+        $this->assertSame(2, $result->getInsertedCount());
+        $this->assertSame(array(2, 3), $result->getInsertedIds());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+}

tests/Collection/CrudSpec/InsertOneFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+/**
+ * CRUD spec functional tests for insertOne().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class InsertOneFunctionalTest extends FunctionalTestCase
+{
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(1);
+    }
+
+    public function testInsertOneWithANonexistentDocument()
+    {
+        $document = array('_id' => 2, 'x' => 22);
+
+        $result = $this->collection->insertOne($document);
+        $this->assertSame(1, $result->getInsertedCount());
+        $this->assertSame(2, $result->getInsertedId());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+}

tests/Collection/CrudSpec/ReplaceOneFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+/**
+ * CRUD spec functional tests for replaceOne().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class ReplaceOneFunctionalTest extends FunctionalTestCase
+{
+    private $omitModifiedCount;
+
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(3);
+
+        $this->omitModifiedCount = version_compare($this->getServerVersion(), '2.6.0', '<');
+    }
+
+    public function testReplaceOneWhenManyDocumentsMatch()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+        $replacement = array('x' => 111);
+
+        $result = $this->collection->replaceOne($filter, $replacement);
+        $this->assertSame(1, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(1, $result->getModifiedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 111),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testReplaceOneWhenOneDocumentMatches()
+    {
+        $filter = array('_id' => 1);
+        $replacement = array('x' => 111);
+
+        $result = $this->collection->replaceOne($filter, $replacement);
+        $this->assertSame(1, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(1, $result->getModifiedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 111),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testReplaceOneWhenNoDocumentsMatch()
+    {
+        $filter = array('_id' => 4);
+        $replacement = array('x' => 111);
+
+        $result = $this->collection->replaceOne($filter, $replacement);
+        $this->assertSame(0, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(0, $result->getModifiedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testReplaceOneWithUpsertWhenNoDocumentsMatchWithAnIdSpecified()
+    {
+        $filter = array('_id' => 4);
+        $replacement = array('_id' => 4, 'x' => 1);
+        $options = array('upsert' => true);
+
+        $result = $this->collection->replaceOne($filter, $replacement, $options);
+        $this->assertSame(0, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(0, $result->getModifiedCount());
+        $this->assertSame(4, $result->getUpsertedId());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+            array('_id' => 4, 'x' => 1),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testReplaceOneWithUpsertWhenNoDocumentsMatchWithoutAnIdSpecified()
+    {
+        $filter = array('_id' => 4);
+        // Server 2.4 and earlier requires any custom ID to also be in the replacement document
+        $replacement = array('_id' => 4, 'x' => 1);
+        $options = array('upsert' => true);
+
+        $result = $this->collection->replaceOne($filter, $replacement, $options);
+        $this->assertSame(0, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(0, $result->getModifiedCount());
+        $this->assertSame(4, $result->getUpsertedId());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+            array('_id' => 4, 'x' => 1),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+}

tests/Collection/CrudSpec/UpdateManyFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+/**
+ * CRUD spec functional tests for updateMany().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class UpdateManyFunctionalTest extends FunctionalTestCase
+{
+    private $omitModifiedCount;
+
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(3);
+
+        $this->omitModifiedCount = version_compare($this->getServerVersion(), '2.6.0', '<');
+    }
+
+    public function testUpdateManyWhenManyDocumentsMatch()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+        $update = array('$inc' => array('x' => 1));
+
+        $result = $this->collection->updateMany($filter, $update);
+        $this->assertSame(2, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(2, $result->getModifiedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 23),
+            array('_id' => 3, 'x' => 34),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testUpdateManyWhenOneDocumentMatches()
+    {
+        $filter = array('_id' => 1);
+        $update = array('$inc' => array('x' => 1));
+
+        $result = $this->collection->updateMany($filter, $update);
+        $this->assertSame(1, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(1, $result->getModifiedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 12),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testUpdateManyWhenNoDocumentsMatch()
+    {
+        $filter = array('_id' => 4);
+        $update = array('$inc' => array('x' => 1));
+
+        $result = $this->collection->updateMany($filter, $update);
+        $this->assertSame(0, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(0, $result->getModifiedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testUpdateManyWithUpsertWhenNoDocumentsMatch()
+    {
+        $filter = array('_id' => 4);
+        $update = array('$inc' => array('x' => 1));
+        $options = array('upsert' => true);
+
+        $result = $this->collection->updateMany($filter, $update, $options);
+        $this->assertSame(0, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(0, $result->getModifiedCount());
+        $this->assertSame(4, $result->getUpsertedId());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+            array('_id' => 4, 'x' => 1),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+}

tests/Collection/CrudSpec/UpdateOneFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Collection\CrudSpec;
+
+/**
+ * CRUD spec functional tests for updateOne().
+ *
+ * @see https://github.com/mongodb/specifications/tree/master/source/crud/tests
+ */
+class UpdateOneFunctionalTest extends FunctionalTestCase
+{
+    private $omitModifiedCount;
+
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->createFixtures(3);
+
+        $this->omitModifiedCount = version_compare($this->getServerVersion(), '2.6.0', '<');
+    }
+
+    public function testUpdateOneWhenManyDocumentsMatch()
+    {
+        $filter = array('_id' => array('$gt' => 1));
+        $update = array('$inc' => array('x' => 1));
+
+        $result = $this->collection->updateOne($filter, $update);
+        $this->assertSame(1, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(1, $result->getModifiedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 23),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testUpdateOneWhenOneDocumentMatches()
+    {
+        $filter = array('_id' => 1);
+        $update = array('$inc' => array('x' => 1));
+
+        $result = $this->collection->updateOne($filter, $update);
+        $this->assertSame(1, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(1, $result->getModifiedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 12),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testUpdateOneWhenNoDocumentsMatch()
+    {
+        $filter = array('_id' => 4);
+        $update = array('$inc' => array('x' => 1));
+
+        $result = $this->collection->updateOne($filter, $update);
+        $this->assertSame(0, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(0, $result->getModifiedCount());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+
+    public function testUpdateOneWithUpsertWhenNoDocumentsMatch()
+    {
+        $filter = array('_id' => 4);
+        $update = array('$inc' => array('x' => 1));
+        $options = array('upsert' => true);
+
+        $result = $this->collection->updateOne($filter, $update, $options);
+        $this->assertSame(0, $result->getMatchedCount());
+        $this->omitModifiedCount or $this->assertSame(0, $result->getModifiedCount());
+        $this->assertSame(4, $result->getUpsertedId());
+
+        $expected = array(
+            array('_id' => 1, 'x' => 11),
+            array('_id' => 2, 'x' => 22),
+            array('_id' => 3, 'x' => 33),
+            array('_id' => 4, 'x' => 1),
+        );
+
+        $this->assertSame($expected, $this->collection->find()->toArray());
+    }
+}

tests/Collection/FunctionalTestCase.php

+<?php
+
+namespace MongoDB\Tests\Collection;
+
+use MongoDB\Collection;
+use MongoDB\Database;
+use MongoDB\Tests\FunctionalTestCase as BaseFunctionalTestCase;
+
+/**
+ * Base class for Collection functional tests.
+ */
+abstract class FunctionalTestCase extends BaseFunctionalTestCase
+{
+    protected $collection;
+
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->collection = new Collection($this->manager, $this->getNamespace());
+        $this->dropCollectionIfItExists($this->collection);
+    }
+
+    public function tearDown()
+    {
+        if ($this->hasFailed()) {
+            return;
+        }
+
+        $this->dropCollectionIfItExists($this->collection);
+    }
+
+    /**
+     * Drop the collection if it exists.
+     *
+     * @param Collection $collection
+     */
+    protected function dropCollectionIfItExists(Collection $collection)
+    {
+        $database = new Database($this->manager, $collection->getDatabaseName());
+        $collections = $database->listCollections(array('filter' => array('name' => $collection->getCollectionName())));
+
+        if (iterator_count($collections) > 0) {
+            $this->assertCommandSucceeded($collection->drop());
+        }
+    }
+}

tests/CollectionFunctionalTest.php → tests/Collection/IndexManagementFunctionalTest.php

 <?php
 
-namespace MongoDB\Tests;
+namespace MongoDB\Tests\Collection;
 
-use MongoDB\Collection;
-use MongoDB\Driver\Manager;
 use MongoDB\Model\IndexInfo;
 use InvalidArgumentException;
 
-class CollectionFunctionalTest extends FunctionalTestCase
+/**
+ * Functional tests for index management methods.
+ *
+ * @see https://github.com/mongodb/specifications/blob/master/source/index-management.rst
+ */
+class IndexManagementFunctionalTest extends FunctionalTestCase
 {
-    private $collection;
-
-    public function setUp()
-    {
-        parent::setUp();
-
-        $this->collection = new Collection($this->manager, $this->getNamespace());
-        $this->collection->deleteMany(array());
-    }
-
-    public function testDrop()
-    {
-        $writeResult = $this->collection->insertOne(array('x' => 1));
-        $this->assertEquals(1, $writeResult->getInsertedCount());
-
-        $commandResult = $this->collection->drop();
-        $this->assertCommandSucceeded($commandResult);
-        $this->assertCollectionCount($this->getNamespace(), 0);
-    }
-
-    function testInsertAndRetrieve()
-    {
-        $generator = new FixtureGenerator();
-
-        for ($i = 0; $i < 10; $i++) {
-            $user = $generator->createUser();
-            $result = $this->collection->insertOne($user);
-            $this->assertInstanceOf('MongoDB\InsertOneResult', $result);
-            $this->assertInstanceOf('BSON\ObjectId', $result->getInsertedId());
-            $this->assertEquals(24, strlen($result->getInsertedId()));
-
-            $user["_id"] = $result->getInsertedId();
-            $document = $this->collection->findOne(array("_id" => $result->getInsertedId()));
-            $this->assertEquals($document, $user, "The inserted and returned objects are the same");
-        }
-
-        $this->assertEquals(10, $i);
-
-        $query = array("firstName" => "Ransom");
-        $count = $this->collection->count($query);
-        $this->assertEquals(1, $count);
-        $cursor = $this->collection->find($query);
-        $this->assertInstanceOf('MongoDB\Driver\Cursor', $cursor);
-
-        foreach($cursor as $n => $person) {
-            $this->assertInternalType("array", $person);
-        }
-        $this->assertEquals(0, $n);
-    }
-
     public function testCreateIndex()
     {
         $that = $this;

tests/DatabaseFunctionalTest.php → tests/Database/CollectionManagementFunctionalTest.php

 <?php
 
-namespace MongoDB\Tests;
+namespace MongoDB\Tests\Database;
 
-use MongoDB\Client;
-use MongoDB\Database;
 use MongoDB\Model\CollectionInfo;
 use InvalidArgumentException;
 
 /**
- * Functional tests for the Database class.
+ * Functional tests for collection management methods.
  */
-class DatabaseFunctionalTest extends FunctionalTestCase
+class CollectionManagementFunctionalTest extends FunctionalTestCase
 {
-    private $database;
-
-    public function setUp()
-    {
-        parent::setUp();
-
-        $this->database = new Database($this->manager, $this->getDatabaseName());
-        $this->database->drop();
-    }
-
     public function testCreateCollection()
     {
         $that = $this;
@@ -49,16 +37,6 @@ class DatabaseFunctionalTest extends FunctionalTestCase
         });
     }
 
-    public function testDrop()
-    {
-        $writeResult = $this->manager->executeInsert($this->getNamespace(), array('x' => 1));
-        $this->assertEquals(1, $writeResult->getInsertedCount());
-
-        $commandResult = $this->database->drop();
-        $this->assertCommandSucceeded($commandResult);
-        $this->assertCollectionCount($this->getNamespace(), 0);
-    }
-
     public function testDropCollection()
     {
         $writeResult = $this->manager->executeInsert($this->getNamespace(), array('x' => 1));

tests/Database/DatabaseFunctionalTest.php

+<?php
+
+namespace MongoDB\Tests\Database;
+
+/**
+ * Functional tests for the Database class.
+ */
+class DatabaseFunctionalTest extends FunctionalTestCase
+{
+    public function testDrop()
+    {
+        $writeResult = $this->manager->executeInsert($this->getNamespace(), array('x' => 1));
+        $this->assertEquals(1, $writeResult->getInsertedCount());
+
+        $commandResult = $this->database->drop();
+        $this->assertCommandSucceeded($commandResult);
+        $this->assertCollectionCount($this->getNamespace(), 0);
+    }
+}

tests/Database/FunctionalTestCase.php

+<?php
+
+namespace MongoDB\Tests\Database;
+
+use MongoDB\Database;
+use MongoDB\Tests\FunctionalTestCase as BaseFunctionalTestCase;
+
+/**
+ * Base class for Database functional tests.
+ */
+abstract class FunctionalTestCase extends BaseFunctionalTestCase
+{
+    protected $database;
+
+    public function setUp()
+    {
+        parent::setUp();
+
+        $this->database = new Database($this->manager, $this->getDatabaseName());
+        $this->database->drop();
+    }
+}

tests/FunctionalTestCase.php

@@ -3,8 +3,9 @@
 namespace MongoDB\Tests;
 
 use MongoDB\Driver\Command;
-use MongoDB\Driver\Manager;
 use MongoDB\Driver\Cursor;
+use MongoDB\Driver\Manager;
+use MongoDB\Driver\ReadPreference;
 
 abstract class FunctionalTestCase extends TestCase
 {
@@ -15,7 +16,7 @@ abstract class FunctionalTestCase extends TestCase
         $this->manager = new Manager($this->getUri());
     }
 
-    public function assertCollectionCount($namespace, $count)
+    protected function assertCollectionCount($namespace, $count)
     {
         list($databaseName, $collectionName) = explode('.', $namespace, 2);
 
@@ -26,10 +27,23 @@ abstract class FunctionalTestCase extends TestCase
         $this->assertEquals($count, $document['n']);
     }
 
-    public function assertCommandSucceeded(Cursor $cursor)
+    protected function assertCommandSucceeded(Cursor $cursor)
     {
         $document = current($cursor->toArray());
         $this->assertArrayHasKey('ok', $document);
         $this->assertEquals(1, $document['ok']);
     }
+
+    protected function getServerVersion(ReadPreference $readPreference = null)
+    {
+        $cursor = $this->manager->executeCommand(
+            $this->getDatabaseName(),
+            new Command(array('buildInfo' => 1)),
+            $readPreference ?: new ReadPreference(ReadPreference::RP_PRIMARY)
+        );
+
+        $document = current($cursor->toArray());
+
+        return $document['version'];
+    }
 }

tests/TestCase.php

@@ -11,11 +11,11 @@ abstract class TestCase extends \PHPUnit_Framework_TestCase
      *
      * @return string
      */
-    public function getCollectionName()
+    protected function getCollectionName()
     {
          $class = new ReflectionClass($this);
 
-         return sprintf('%s.%s', $class->getShortName(), $this->getName(false));
+         return sprintf('%s.%s', $class->getShortName(), hash('crc32b', $this->getName()));
     }
 
     /**
@@ -23,7 +23,7 @@ abstract class TestCase extends \PHPUnit_Framework_TestCase
      *
      * @return string
      */
-    public function getDatabaseName()
+    protected function getDatabaseName()
     {
         return getenv('MONGODB_DATABASE') ?: 'phplib_test';
     }
@@ -33,7 +33,7 @@ abstract class TestCase extends \PHPUnit_Framework_TestCase
      *
      * @return string
      */
-    public function getNamespace()
+    protected function getNamespace()
     {
          return sprintf('%s.%s', $this->getDatabaseName(), $this->getCollectionName());
     }
@@ -43,7 +43,7 @@ abstract class TestCase extends \PHPUnit_Framework_TestCase
      *
      * @return string
      */
-    public function getUri()
+    protected function getUri()
     {
         return getenv('MONGODB_URI') ?: 'mongodb://127.0.0.1:27017';
     }