PHPLIB-363: Remove support for server versions < 3.0

Since ext-mongodb 1.5.0 drops support for server 2.6, we can remove wire version checks and legacy code for servers before 3.0 (i.e. wire version 3).

Author: jmikola

docs/includes/apiargs-MongoDBDatabase-method-listCollections-option.yaml

@@ -6,10 +6,6 @@ description: |
 
   You can specify a query expression for collection fields (e.g. ``name``,
   ``options``).
-
-  For server versions < 3.0, the filter can only be used to match the ``name``
-  field with a string value. More complex filters will result in an exception at
-  execution time if used.
 interface: phpmethod
 operation: ~
 optional: true

src/Model/CollectionInfoLegacyIterator.php

@@ -38,7 +38,6 @@ class Explain implements Executable
     const VERBOSITY_EXEC_STATS = 'executionStats';
     const VERBOSITY_QUERY = 'queryPlanner';
 
-    private static $wireVersionForExplain = 2;
     private static $wireVersionForDistinct = 4;
     private static $wireVersionForFindAndModify = 4;
 
@@ -90,10 +89,6 @@ public function __construct($databaseName, Explainable $explainable, array $opti
 
     public function execute(Server $server)
     {
-        if (! \MongoDB\server_supports_feature($server, self::$wireVersionForExplain)) {
-            throw UnsupportedException::explainNotSupported();
-        }
-
         if ($this->explainable instanceof Distinct && ! \MongoDB\server_supports_feature($server, self::$wireVersionForDistinct)) {
             throw UnsupportedException::explainNotSupported();
         }

src/Operation/Explain.php

@@ -37,8 +37,6 @@
  */
 class ListCollections implements Executable
 {
-    private static $wireVersionForCommand = 3;
-
     private $databaseName;
     private $options;
 
@@ -49,10 +47,6 @@ class ListCollections implements Executable
      *
      *  * filter (document): Query by which to filter collections.
      *
-     *    For server versions < 3.0, the filter can only be used to match the
-     *    "name" field with a string value. More complex filters will result in
-     *    an exception at execution time if used.
-     *
      *  * maxTimeMS (integer): The maximum amount of time to allow the query to
      *    run.
      *
@@ -88,14 +82,11 @@ public function __construct($databaseName, array $options = [])
      * @see Executable::execute()
      * @param Server $server
      * @return CollectionInfoIterator
-     * @throws InvalidArgumentException if filter.name is not a string for legacy execution
      * @throws DriverRuntimeException for other driver errors (e.g. connection errors)
      */
     public function execute(Server $server)
     {
-        return \MongoDB\server_supports_feature($server, self::$wireVersionForCommand)
-            ? $this->executeCommand($server)
-            : $this->executeLegacy($server);
+        return $this->executeCommand($server);
     }
 
     /**
@@ -143,35 +134,4 @@ private function executeCommand(Server $server)
 
         return new CollectionInfoCommandIterator(new CachingIterator($cursor));
     }
-
-    /**
-     * Returns information for all collections in this database by querying the
-     * "system.namespaces" collection (MongoDB <3.0).
-     *
-     * @param Server $server
-     * @return CollectionInfoLegacyIterator
-     * @throws InvalidArgumentException if filter.name is not a string
-     * @throws DriverRuntimeException for other driver errors (e.g. connection errors)
-     */
-    private function executeLegacy(Server $server)
-    {
-        $filter = empty($this->options['filter']) ? [] : (array) $this->options['filter'];
-
-        if (array_key_exists('name', $filter)) {
-            if ( ! is_string($filter['name'])) {
-                throw InvalidArgumentException::invalidType('filter name for MongoDB <3.0', $filter['name'], 'string');
-            }
-
-            $filter['name'] = $this->databaseName . '.' . $filter['name'];
-        }
-
-        $options = isset($this->options['maxTimeMS'])
-            ? ['modifiers' => ['$maxTimeMS' => $this->options['maxTimeMS']]]
-            : [];
-
-        $cursor = $server->executeQuery($this->databaseName . '.system.namespaces', new Query($filter, $options));
-        $cursor->setTypeMap(['root' => 'array', 'document' => 'array']);
-
-        return new CollectionInfoLegacyIterator(new CachingIterator($cursor));
-    }
 }

src/Operation/ListCollections.php

@@ -39,7 +39,6 @@ class ListIndexes implements Executable
 {
     private static $errorCodeDatabaseNotFound = 60;
     private static $errorCodeNamespaceNotFound = 26;
-    private static $wireVersionForCommand = 3;
 
     private $databaseName;
     private $collectionName;
@@ -87,9 +86,7 @@ public function __construct($databaseName, $collectionName, array $options = [])
      */
     public function execute(Server $server)
     {
-        return \MongoDB\server_supports_feature($server, self::$wireVersionForCommand)
-            ? $this->executeCommand($server)
-            : $this->executeLegacy($server);
+        return $this->executeCommand($server);
     }
 
     /**
@@ -146,26 +143,4 @@ private function executeCommand(Server $server)
 
         return new IndexInfoIteratorIterator(new CachingIterator($cursor));
     }
-
-    /**
-     * Returns information for all indexes for this collection by querying the
-     * "system.indexes" collection (MongoDB <3.0).
-     *
-     * @param Server $server
-     * @return IndexInfoIteratorIterator
-     * @throws DriverRuntimeException for other driver errors (e.g. connection errors)
-     */
-    private function executeLegacy(Server $server)
-    {
-        $filter = ['ns' => $this->databaseName . '.' . $this->collectionName];
-
-        $options = isset($this->options['maxTimeMS'])
-            ? ['modifiers' => ['$maxTimeMS' => $this->options['maxTimeMS']]]
-            : [];
-
-        $cursor = $server->executeQuery($this->databaseName . '.system.indexes', new Query($filter, $options));
-        $cursor->setTypeMap(['root' => 'array', 'document' => 'array']);
-
-        return new IndexInfoIteratorIterator(new CachingIterator($cursor));
-    }
 }

src/Operation/ListIndexes.php

@@ -155,10 +155,6 @@ public function testDropIndexShouldNotAllowWildcardCharacter()
 
     public function testExplain()
     {
-        if (version_compare($this->getServerVersion(), '3.0.0', '<')) {
-            $this->markTestSkipped('Explain command is not supported');
-        }
-
         $this->createFixtures(3);
 
         $operation = new Count($this->getDatabaseName(), $this->getCollectionName(), ['x' => ['$gte' => 1]], []);

tests/Collection/CollectionFunctionalTest.php

@@ -25,14 +25,6 @@
 
 class ExplainFunctionalTest extends FunctionalTestCase
 {
-    public function setUp()
-    {
-        parent::setUp();
-        if (version_compare($this->getServerVersion(), '3.0.0', '<')) {
-            $this->markTestSkipped('Explain command is not supported');
-        }
-    }
-
     /**
      * @dataProvider provideVerbosityInformation
      */