Support passing authentication options to test framework

Author: alcaeus

CONTRIBUTING.md

@@ -37,6 +37,11 @@ this configuration by creating your own `phpunit.xml` file based on the
 `phpunit.xml.dist` file we provide. To run the tests in serverless mode, set the
 `MONGODB_IS_SERVERLESS` environment variable to `on`.
 
+To run tests against a cluster that requires authentication, either include the
+credentials in the connection string given in the `MONGODB_URI` environment
+variable, or set the `MONGODB_USERNAME` and `MONGODB_PASSWORD` environment
+variables accordingly.
+
 By default, the `simple-phpunit` binary chooses the correct PHPUnit version for
 the PHP version you are running. To run tests against a specific PHPUnit version,
 use the `SYMFONY_PHPUNIT_VERSION` environment variable:

tests/FunctionalTestCase.php

@@ -69,12 +69,20 @@ public function tearDown(): void
 
     public static function createTestClient(?string $uri = null, array $options = [], array $driverOptions = []): Client
     {
-        return new Client($uri ?? static::getUri(), $options, static::appendServerApiOption($driverOptions));
+        return new Client(
+            $uri ?? static::getUri(),
+            static::appendAuthenticationOptions($options),
+            static::appendServerApiOption($driverOptions)
+        );
     }
 
     public static function createTestManager(?string $uri = null, array $options = [], array $driverOptions = []): Manager
     {
-        return new Manager($uri ?? static::getUri(), $options, static::appendServerApiOption($driverOptions));
+        return new Manager(
+            $uri ?? static::getUri(),
+            static::appendAuthenticationOptions($options),
+            static::appendServerApiOption($driverOptions)
+        );
     }
 
     public static function getUri($allowMultipleMongoses = false): string
@@ -513,6 +521,26 @@ protected function skipIfTransactionsAreNotSupported(): void
         }
     }
 
+    private static function appendAuthenticationOptions(array $options): array
+    {
+        if (isset($options['username']) || isset($options['password'])) {
+            return $options;
+        }
+
+        $username = getenv('MONGODB_USERNAME') ?: null;
+        $password = getenv('MONGODB_PASSWORD') ?: null;
+
+        if ($username !== null) {
+            $options['username'] = $username;
+        }
+
+        if ($password !== null) {
+            $options['password'] = $password;
+        }
+
+        return $options;
+    }
+
     private static function appendServerApiOption(array $driverOptions): array
     {
         if (getenv('API_VERSION') && ! isset($driverOptions['serverApi'])) {