ADD Instance connection param

Author: francerz

README.md

@@ -53,6 +53,7 @@ Using $_ENV global variable
 ```php
 $_ENV['DATABASE_SCHOOL_DRIVER'] = 'driver';
 $_ENV['DATABASE_SCHOOL_HOST'] = 'host';
+$_ENV['DATABASE_SCHOOL_INST'] = 'instanceName';
 $_ENV['DATABASE_SCHOOL_PORT'] = 'port';
 $_ENV['DATABASE_SCHOOL_USER'] = 'user';
 $_ENV['DATABASE_SCHOOL_PSWD'] = 'password';

src/ConnectParams.php

@@ -16,6 +16,7 @@ class ConnectParams
     private $port;
     private $database;
     private $encoding;
+    private $instance;
 
     public function __construct(
         DriverInterface $driver,
@@ -24,7 +25,8 @@ public function __construct(
         ?string $password = null,
         ?string $database = null,
         ?int $port = null,
-        ?string $encoding = null
+        ?string $encoding = null,
+        ?string $instance = null
     ) {
         $this->driver = $driver;
         $this->host = $host;
@@ -33,6 +35,7 @@ public function __construct(
         $this->database = $database;
         $this->port = $port;
         $this->encoding = $encoding;
+        $this->instance = $instance;
     }
 
     public static function fromEnv(string $alias, ?array $env = null)
@@ -48,19 +51,21 @@ public static function fromEnv(string $alias, ?array $env = null)
         $encdKey = "DATABASE_{$alias}_ENCD";
         $pswdKey = "DATABASE_{$alias}_PSWD";
         $pwflKey = "DATABASE_{$alias}_PSWD_FILE";
+        $instKey = "DATABASE_{$alias}_INST";
 
         $host = $env[$hostKey] ?? $driver->getDefaultHost();
         $port = $env[$portKey] ?? $driver->getDefaultPort();
         $user = $env[$userKey] ?? $driver->getDefaultUser();
         $name = $env[$nameKey] ?? $alias;
         $encd = $env[$encdKey] ?? null;
+        $inst = $env[$instKey] ?? null;
 
         $pswd = $env[$pswdKey] ?? $driver->getDefaultPswd();
         if (!empty($env[$pwflKey]) && file_exists($env[$pwflKey])) {
             $pswd = file_get_contents($env[$pwflKey]);
         }
 
-        return new ConnectParams($driver, $host, $user, $pswd, $name, $port, $encd);
+        return new ConnectParams($driver, $host, $user, $pswd, $name, $port, $encd, $inst);
     }
 
     /**
@@ -159,4 +164,14 @@ public function getEncoding(): ?string
     {
         return $this->encoding;
     }
+
+    public function setInstance(?string $instance)
+    {
+        $this->instance = $instance;
+    }
+
+    public function getInstance(): ?string
+    {
+        return $this->instance;
+    }
 }