[3.x] DB users (#382)

* Initial draft

* Apply fixes from StyleCI

* Use CI on master branch too

* Pass correct argument to queued DB creators/deleters

* Apply fixes from StyleCI

* Remove new interface from MySQLDBManager

* Make phpunit run

* Apply fixes from StyleCI

* Fix static property

* Default databaseName

* Use database transactions for creating users & granting permissions

* Apply fixes from StyleCI

* Get old tests to pass

* Apply fixes from StyleCI

* Add tests for PermissionControlledMySQLDatabaseManager

* Apply fixes from StyleCI

* Write test for extra config, fix bug with extra config

* Apply fixes from StyleCI

src/Contracts/ManagesDatabaseUsers.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Stancl\Tenancy\Contracts;
+
+use Stancl\Tenancy\DatabaseConfig;
+
+interface ManagesDatabaseUsers extends TenantDatabaseManager
+{
+    public function createUser(DatabaseConfig $databaseConfig): bool;
+
+    public function deleteUser(DatabaseConfig $databaseConfig): bool;
+
+    public function userExists(string $username): bool;
+}

src/Contracts/ModifiesDatabaseNameForConnection.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Stancl\Tenancy\Contracts;
+
+/**
+ * Used by sqlite to wrap database name in database_path().
+ */
+interface ModifiesDatabaseNameForConnection
+{
+    public function getDatabaseNameForConnection(string $original): string;
+}

src/Contracts/TenantDatabaseManager.php

@@ -4,23 +4,26 @@ declare(strict_types=1);
 
 namespace Stancl\Tenancy\Contracts;
 
+use Stancl\Tenancy\Tenant;
+
 interface TenantDatabaseManager
 {
     /**
-     * Create a database.
+     * Return the config key that separates databases (e.g. 'database' or 'schema').
      *
-     * @param  string $name Name of the database.
-     * @return bool
+     * @return string
      */
-    public function createDatabase(string $name): bool;
+    public function getSeparator(): string;
+
+    /**
+     * Create a database.
+     */
+    public function createDatabase(Tenant $tenant): bool;
 
     /**
      * Delete a database.
-     *
-     * @param  string $name Name of the database.
-     * @return bool
      */
-    public function deleteDatabase(string $name): bool;
+    public function deleteDatabase(Tenant $tenant): bool;
 
     /**
      * Does a database exist.