[1.7.0] Add DB storage driver

README.md

@@ -366,7 +366,35 @@ Note that deleting a tenant doesn't delete his database. You can do this manuall
 
 ## Storage driver
 
-Currently, only Redis is supported, but you're free to code your own storage driver which follows the `Stancl\Tenancy\Interfaces\StorageDriver` interface. Just point the `tenancy.storage_driver` setting at your driver.
+### Database
+
+The database storage driver lets you store information about tenants in a relational database like MySQL, PostgreSQL and SQLite.
+
+To use this storage driver, publish the `create_tenants_table` migration:
+
+```
+php artisan vendor:publish --provider='Stancl\Tenancy\TenancyServiceProvider' --tag=migrations
+```
+
+By default, the table contains only `uuid`, `domain` and `data` columns.
+
+The `data` column is used to store information about a tenant, such as their selected plan, in JSON form. This package does not store anything in the column by default.
+
+You can store specific keys in your own columns. This is useful if you want to use RDBMS features like indexes.
+
+If you don't need any custom columns, you can skip the next section and run:
+
+```
+php artisan migrate
+```
+
+#### Adding your own columns
+
+To add your own columns, TODO.
+
+### Redis
+
+Using Redis as your storage driver is recommended due to its low overhead compared to a relational database like MySQL.
 
 **Note that you need to configure persistence on your Redis instance** if you don't want to lose all information about tenants.
 

src/config/tenancy.php → assets/config.php

@@ -1,13 +1,25 @@
 <?php
 
 return [
-    'storage_driver' => 'Stancl\Tenancy\StorageDrivers\RedisStorageDriver',
+    'storage_driver' => 'Stancl\Tenancy\StorageDrivers\DatabaseStorageDriver',
+    'storage' => [
+        'db' => [ // Stancl\Tenancy\StorageDrivers\DatabaseStorageDriver
+            'data_column' => 'data',
+            'custom_columns' => [
+                // 'plan',
+            ],
+            'connection' => 'central',
+        ],
+        'redis' => [ // Stancl\Tenancy\StorageDrivers\RedisStorageDriver
+            'connection' => 'tenancy',
+        ],
+    ],
     'tenant_route_namespace' => 'App\Http\Controllers',
     'exempt_domains' => [
         // 'localhost',
     ],
     'database' => [
-        'based_on' => 'mysql',
+        'based_on' => 'sqlite',
         'prefix' => 'tenant',
         'suffix' => '',
     ],

assets/migrations/2019_08_08_000000_create_tenants_table.php

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
+
+class CreateTenantsTable extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('tenants', function (Blueprint $table) {
+            $table->string('uuid', 36)->primary(); // don't change this
+            $table->string('domain', 255)->index(); // don't change this
+
+            // your indexed columns go here
+
+            $table->json('data')->default('{}');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::drop('tenants');
+    }
+}

src/Interfaces/StorageDriver.php

@@ -6,6 +6,7 @@ interface StorageDriver
 {
     public function identifyTenant(string $domain): array;
 
+    /** @return array[] */
     public function getAllTenants(array $uuids = []): array;
 
     public function getTenantById(string $uuid, array $fields = []): array;

src/StorageDrivers/DatabaseStorageDriver.php

@@ -0,0 +1,84 @@
+<?php
+
+namespace Stancl\Tenancy\StorageDrivers;
+
+use Stancl\Tenancy\Tenant;
+use Stancl\Tenancy\Interfaces\StorageDriver;
+
+class DatabaseStorageDriver implements StorageDriver
+{
+    public $useJson = false;
+
+    // todo use an instance of tenant model?
+    // todo write tests verifying that data is decoded and added to the array
+
+    public function identifyTenant(string $domain): array
+    {
+        $id = $this->getTenantIdByDomain($domain);
+        if (! $id) {
+            throw new \Exception("Tenant could not be identified on domain {$domain}");
+        }
+
+        return $this->getTenantById($id);
+    }
+
+    /**
+     * Get information about the tenant based on his uuid.
+     *
+     * @param string $uuid
+     * @param array $fields
+     * @return array
+     */
+    public function getTenantById(string $uuid, array $fields = []): array
+    {
+        if ($fields) {
+            return Tenant::decodeData(Tenant::find($uuid)->only($fields));
+        } else {
+            return Tenant::find($uuid)->decoded();
+        }
+    }
+
+    public function getTenantIdByDomain(string $domain): ?string
+    {
+        return Tenant::where('domain', $domain)->first()->uuid ?? null;
+    }
+
+    public function createTenant(string $domain, string $uuid): array
+    {
+        return Tenant::create(['uuid' => $uuid, 'domain' => $domain])->toArray();
+    }
+
+    public function deleteTenant(string $id): bool
+    {
+        return Tenant::find($id)->delete();
+    }
+
+    public function getAllTenants(array $uuids = []): array
+    {
+        return Tenant::getAllTenants($uuids)->toArray();
+    }
+
+    public function get(string $uuid, string $key)
+    {
+        return Tenant::find($uuid)->get($key);
+    }
+
+    public function getMany(string $uuid, array $keys): array
+    {
+        return Tenant::find($uuid)->getMany($keys);
+    }
+
+    public function put(string $uuid, string $key, $value)
+    {
+        return Tenant::find($uuid)->put($key, $value);
+    }
+
+    public function putMany(string $uuid, array $values): array
+    {
+        foreach ($values as $key => $value) {
+            Tenant::find($uuid)->put($key, $value);
+        }
+
+        return $values;
+    }
+}

src/StorageDrivers/RedisStorageDriver.php

@@ -11,7 +11,7 @@ class RedisStorageDriver implements StorageDriver
 
     public function __construct()
     {
-        $this->redis = Redis::connection('tenancy');
+        $this->redis = Redis::connection(config('tenancy.redis.connection', 'tenancy'));
     }
 
     public function identifyTenant(string $domain): array
@@ -33,8 +33,6 @@ public function identifyTenant(string $domain): array
      */
     public function getTenantById(string $uuid, array $fields = []): array
     {
-        $fields = (array) $fields;
-
         if (! $fields) {
             return $this->redis->hgetall("tenants:$uuid");
         }

src/TenancyServiceProvider.php

@@ -33,9 +33,13 @@ public function boot()
         ]);
 
         $this->publishes([
-            __DIR__ . '/config/tenancy.php' => config_path('tenancy.php'),
+            __DIR__ . '/../assets/config.php' => config_path('tenancy.php'),
         ], 'config');
 
+        $this->publishes([
+            __DIR__ . '/../assets/migrations/' => database_path('migrations'),
+        ], 'migrations');
+
         $this->loadRoutesFrom(__DIR__ . '/routes.php');
 
         Route::middlewareGroup('tenancy', [
@@ -52,7 +56,7 @@ public function boot()
      */
     public function register()
     {
-        $this->mergeConfigFrom(__DIR__ . '/config/tenancy.php', 'tenancy');
+        $this->mergeConfigFrom(__DIR__ . '/../assets/config.php', 'tenancy');
 
         $this->app->bind(StorageDriver::class, $this->app['config']['tenancy.storage_driver']);
         $this->app->bind(ServerConfigManager::class, $this->app['config']['tenancy.server.manager']);

src/Tenant.php

@@ -0,0 +1,102 @@
+<?php
+
+namespace Stancl\Tenancy;
+
+use Illuminate\Database\Eloquent\Model;
+
+class Tenant extends Model
+{
+    protected $guarded = [];
+    protected $primaryKey = 'uuid';
+    public $incrementing = false;
+    public $timestamps = false;
+
+    /**
+     * Decoded data from the data column.
+     *
+     * @var object
+     */
+    private $dataObject;
+
+    public static function dataColumn()
+    {
+        return config('tenancy.storage.db.data_column', 'data');
+    }
+
+    public static function customColumns()
+    {
+        return config('tenancy.storage.db.custom_columns', []);
+    }
+
+    public function getConnectionName()
+    {
+        return config('tenancy.storage.db.connection', 'central');
+    }
+
+    public static function getAllTenants(array $uuids)
+    {
+        $tenants = $uuids ? static::findMany($uuids) : static::all();
+
+        return $tenants->map([__CLASS__, 'decodeData'])->toBase();
+    }
+
+    public function decoded()
+    {
+        return static::decodeData($this);
+    }
+
+    /**
+     * Return a tenant array with data decoded into separate keys.
+     *
+     * @param Tenant|array $tenant
+     * @return array
+     */
+    public static function decodeData($tenant)
+    {
+        $tenant = $tenant instanceof self ? (array) $tenant->attributes : $tenant;
+        $decoded = json_decode($tenant[$dataColumn = static::dataColumn()], true);
+
+        foreach ($decoded as $key => $value) {
+            $tenant[$key] = $value;
+        }
+
+        // If $tenant[$dataColumn] has been overriden by a value, don't delete the key.
+        if (! array_key_exists($dataColumn, $decoded)) {
+            unset($tenant[$dataColumn]);
+        }
+
+        return $tenant;
+    }
+
+    public function getFromData(string $key)
+    {
+        $this->dataArray = $this->dataArray ?? json_decode($this->{$this->dataColumn()}, true);
+
+        return $this->dataArray[$key] ?? null;
+    }
+
+    public function get(string $key)
+    {
+        return $this->$key ?? $this->getFromData($key) ?? null;
+    }
+
+    /** @todo In v2, this should return an associative array. */
+    public function getMany(array $keys): array
+    {
+        return array_map([$this, 'get'], $keys);
+    }
+
+    public function put(string $key, $value)
+    {
+        if (array_key_exists($key, $this->customColumns())) {
+            $this->update([$key => $value]);
+        } else {
+            $obj = json_decode($this->{$this->dataColumn()});
+            $obj->$key = $value;
+
+            $this->update([$this->dataColumn() => json_encode($obj)]);
+        }
+
+        return $value;
+    }
+}