[3.x-dev] New methods to get bool and string session variables

src/DatabaseDriver.php

@@ -1893,4 +1893,34 @@ public function updateObject($table, &$object, $key, $nulls = false)
 
         return true;
     }
+
+    /**
+     * Get value of boolean session variable with the given name.
+     * Returns null if database doesn't support session variables or variable doesn't exist.
+     *
+     * @param   string  $name  The name of the session variable.
+     *
+     * @return  boolean|null
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function getSessionVarBool($name)
+    {
+        return null;
+    }
+
+    /**
+     * Get value of string session variable with the given name.
+     * Returns null if database doesn't support session variables or variable doesn't exist.
+     *
+     * @param   string  $name  The name of the session variable.
+     *
+     * @return  string|null
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function getSessionVarString($name)
+    {
+        return null;
+    }
 }

src/DatabaseInterface.php

@@ -616,4 +616,28 @@ public function unlockTables();
      * @throws  \RuntimeException
      */
     public function updateObject($table, &$object, $key, $nulls = false);
+
+    /**
+     * Get value of boolean session variable with the given name.
+     * Returns null if database doesn't support session variables or variable doesn't exist.
+     *
+     * @param   string  $name  The name of the session variable.
+     *
+     * @return  boolean|null
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function getSessionVarBool($name);
+
+    /**
+     * Get value of string session variable with the given name.
+     * Returns null if database doesn't support session variables or variable doesn't exist.
+     *
+     * @param   string  $name  The name of the session variable.
+     *
+     * @return  string|null
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function getSessionVarString($name);
 }

src/Mysql/MysqlDriver.php

@@ -804,4 +804,42 @@ public function transactionStart($asSavepoint = false)
             }
         }
     }
+
+    /**
+     * Get value of boolean session variable with the given name.
+     * Returns null if database doesn't support session variables or variable doesn't exist.
+     *
+     * @param   string  $name  The name of the session variable.
+     *
+     * @return  boolean|null
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function getSessionVarBool($name)
+    {
+        $this->connect();
+
+        $result = $this->setQuery('SELECT @@' . $name . ';')->loadResult();
+
+        return $result === null ? null : (bool) $result;
+    }
+
+    /**
+     * Get value of string session variable with the given name.
+     * Returns null if database doesn't support session variables or variable doesn't exist.
+     *
+     * @param   string  $name  The name of the session variable.
+     *
+     * @return  string|null
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function getSessionVarString($name)
+    {
+        $this->connect();
+
+        $result = $this->setQuery('SELECT @@' . $name . ';')->loadResult();
+
+        return $result === null ? null : (string) $result;
+    }
 }

src/Mysqli/MysqliDriver.php

@@ -1082,4 +1082,42 @@ public function getNullDate()
 
         return $this->nullDate;
     }
+
+    /**
+     * Get value of boolean session variable with the given name.
+     * Returns null if database doesn't support session variables or variable doesn't exist.
+     *
+     * @param   string  $name  The name of the session variable.
+     *
+     * @return  boolean|null
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function getSessionVarBool($name)
+    {
+        $this->connect();
+
+        $result = $this->setQuery('SELECT @@' . $name . ';')->loadResult();
+
+        return $result === null ? null : (bool) $result;
+    }
+
+    /**
+     * Get value of string session variable with the given name.
+     * Returns null if database doesn't support session variables or variable doesn't exist.
+     *
+     * @param   string  $name  The name of the session variable.
+     *
+     * @return  string|null
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function getSessionVarString($name)
+    {
+        $this->connect();
+
+        $result = $this->setQuery('SELECT @@' . $name . ';')->loadResult();
+
+        return $result === null ? null : (string) $result;
+    }
 }

src/Pgsql/PgsqlDriver.php

@@ -1063,4 +1063,42 @@ public function decodeBinary($data)
 
         return $data;
     }
+
+    /**
+     * Get value of boolean session variable with the given name.
+     * Returns null if database doesn't support session variables or variable doesn't exist.
+     *
+     * @param   string  $name  The name of the session variable.
+     *
+     * @return  boolean|null
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function getSessionVarBool($name)
+    {
+        $this->connect();
+
+        $result = $this->setQuery('SELECT current_setting(\'' . $name . '\', true);')->loadResult();
+
+        return $result === null ? null : (bool) $result;
+    }
+
+    /**
+     * Get value of string session variable with the given name.
+     * Returns null if database doesn't support session variables or variable doesn't exist.
+     *
+     * @param   string  $name  The name of the session variable.
+     *
+     * @return  string|null
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function getSessionVarString($name)
+    {
+        $this->connect();
+
+        $result = $this->setQuery('SELECT current_setting(\'' . $name . '\', true);')->loadResult();
+
+        return $result === null ? null : (string) $result;
+    }
 }