PHPLIB-1545: Deprecate CreateCollection flags option and related constants (mongodb#1477)

Author: jmikola

src/Operation/CreateCollection.php

@@ -45,7 +45,10 @@
  */
 class CreateCollection implements Executable
 {
+    /** @deprecated 1.21 */
     public const USE_POWER_OF_2_SIZES = 1;
+
+    /** @deprecated 1.21 */
     public const NO_PADDING = 2;
 
     /**
@@ -233,6 +236,10 @@ public function __construct(private string $databaseName, private string $collec
             trigger_error('The "autoIndexId" option is deprecated and will be removed in version 2.0', E_USER_DEPRECATED);
         }
 
+        if (isset($this->options['flags'])) {
+            trigger_error('The "flags" option is deprecated and will be removed in version 2.0', E_USER_DEPRECATED);
+        }
+
         if (isset($this->options['pipeline']) && ! is_pipeline($this->options['pipeline'], true /* allowEmpty */)) {
             throw new InvalidArgumentException('"pipeline" option is not a valid aggregation pipeline');
         }

tests/Operation/CreateCollectionTest.php

@@ -60,4 +60,11 @@ public function testAutoIndexIdOptionIsDeprecated(): void
             new CreateCollection($this->getDatabaseName(), $this->getCollectionName(), ['autoIndexId' => false]);
         });
     }
+
+    public function testFlagsOptionIsDeprecated(): void
+    {
+        $this->assertDeprecated(function (): void {
+            new CreateCollection($this->getDatabaseName(), $this->getCollectionName(), ['flags' => CreateCollection::USE_POWER_OF_2_SIZES]);
+        });
+    }
 }