]> git.mxchange.org Git - friendica.git/blobdiff - src/Database/DBA.php
Fix photo attachment display
[friendica.git] / src / Database / DBA.php
index 28eedec151cd41d378f876017da81db8d4a84d6e..ab856ef9d05da6fd2c1205fcf07e2029d8fdce02 100644 (file)
@@ -8,18 +8,26 @@ namespace Friendica\Database;
 
 use Friendica\Core\System;
 use Friendica\Util\DateTimeFormat;
+use mysqli;
+use mysqli_result;
+use mysqli_stmt;
+use PDO;
+use PDOException;
+use PDOStatement;
+
+require_once 'include/dba.php';
 
 /**
  * @class MySQL database class
  *
  * This class is for the low level database stuff that does driver specific things.
  */
-class dba
+class DBA
 {
        public static $connected = false;
 
        private static $server_info = '';
-       private static $db;
+       private static $connection;
        private static $driver;
        private static $error = false;
        private static $errorno = 0;
@@ -35,7 +43,7 @@ class dba
 
        public static function connect($serveraddr, $user, $pass, $db, $charset = null)
        {
-               if (!is_null(self::$db) && self::connected()) {
+               if (!is_null(self::$connection) && self::connected()) {
                        return true;
                }
 
@@ -46,6 +54,7 @@ class dba
                self::$db_name = $db;
                self::$db_charset = $charset;
 
+               $port = 0;
                $serveraddr = trim($serveraddr);
 
                $serverdata = explode(':', $serveraddr);
@@ -69,7 +78,7 @@ class dba
                        self::$driver = 'pdo';
                        $connect = "mysql:host=".$server.";dbname=".$db;
 
-                       if (isset($port)) {
+                       if ($port > 0) {
                                $connect .= ";port=".$port;
                        }
 
@@ -78,21 +87,28 @@ class dba
                        }
 
                        try {
-                               self::$db = @new PDO($connect, $user, $pass);
-                               self::$db->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
+                               self::$connection = @new PDO($connect, $user, $pass);
+                               self::$connection->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
                                self::$connected = true;
                        } catch (PDOException $e) {
+                               /// @TODO At least log exception, don't ignore it!
                        }
                }
 
-               if (!self::$connected && class_exists('mysqli')) {
+               if (!self::$connected && class_exists('\mysqli')) {
                        self::$driver = 'mysqli';
-                       self::$db = @new mysqli($server, $user, $pass, $db, $port);
+
+                       if ($port > 0) {
+                               self::$connection = @new mysqli($server, $user, $pass, $db, $port);
+                       } else {
+                               self::$connection = @new mysqli($server, $user, $pass, $db);
+                       }
+
                        if (!mysqli_connect_errno()) {
                                self::$connected = true;
 
                                if ($charset) {
-                                       self::$db->set_charset($charset);
+                                       self::$connection->set_charset($charset);
                                }
                        }
                }
@@ -100,7 +116,7 @@ class dba
                // No suitable SQL driver was found.
                if (!self::$connected) {
                        self::$driver = null;
-                       self::$db = null;
+                       self::$connection = null;
                }
 
                return self::$connected;
@@ -111,17 +127,17 @@ class dba
         */
        public static function disconnect()
        {
-               if (is_null(self::$db)) {
+               if (is_null(self::$connection)) {
                        return;
                }
 
                switch (self::$driver) {
                        case 'pdo':
-                               self::$db = null;
+                               self::$connection = null;
                                break;
                        case 'mysqli':
-                               self::$db->close();
-                               self::$db = null;
+                               self::$connection->close();
+                               self::$connection = null;
                                break;
                }
        }
@@ -140,9 +156,9 @@ class dba
         * Return the database object.
         * @return PDO|mysqli
         */
-       public static function get_db()
+       public static function getConnection()
        {
-               return self::$db;
+               return self::$connection;
        }
 
        /**
@@ -153,14 +169,14 @@ class dba
         *
         * @return string
         */
-       public static function server_info() {
+       public static function serverInfo() {
                if (self::$server_info == '') {
                        switch (self::$driver) {
                                case 'pdo':
-                                       self::$server_info = self::$db->getAttribute(PDO::ATTR_SERVER_VERSION);
+                                       self::$server_info = self::$connection->getAttribute(PDO::ATTR_SERVER_VERSION);
                                        break;
                                case 'mysqli':
-                                       self::$server_info = self::$db->server_info;
+                                       self::$server_info = self::$connection->server_info;
                                        break;
                        }
                }
@@ -172,9 +188,9 @@ class dba
         *
         * @return string
         */
-       public static function database_name() {
+       public static function databaseName() {
                $ret = self::p("SELECT DATABASE() AS `db`");
-               $data = self::inArray($ret);
+               $data = self::toArray($ret);
                return $data[0]['db'];
        }
 
@@ -201,7 +217,7 @@ class dba
                }
 
                $r = self::p("EXPLAIN ".$query);
-               if (!DBM::is_result($r)) {
+               if (!self::isResult($r)) {
                        return;
                }
 
@@ -236,31 +252,36 @@ class dba
        }
 
        public static function escape($str) {
-               switch (self::$driver) {
-                       case 'pdo':
-                               return substr(@self::$db->quote($str, PDO::PARAM_STR), 1, -1);
-                       case 'mysqli':
-                               return @self::$db->real_escape_string($str);
+               if (self::$connected) {
+                       switch (self::$driver) {
+                               case 'pdo':
+                                       return substr(@self::$connection->quote($str, PDO::PARAM_STR), 1, -1);
+
+                               case 'mysqli':
+                                       return @self::$connection->real_escape_string($str);
+                       }
+               } else {
+                       return str_replace("'", "\\'", $str);
                }
        }
 
        public static function connected() {
                $connected = false;
 
-               if (is_null(self::$db)) {
+               if (is_null(self::$connection)) {
                        return false;
                }
 
                switch (self::$driver) {
                        case 'pdo':
                                $r = self::p("SELECT 1");
-                               if (DBM::is_result($r)) {
-                                       $row = self::inArray($r);
+                               if (self::isResult($r)) {
+                                       $row = self::toArray($r);
                                        $connected = ($row[0]['1'] == '1');
                                }
                                break;
                        case 'mysqli':
-                               $connected = self::$db->ping();
+                               $connected = self::$connection->ping();
                                break;
                }
                return $connected;
@@ -277,8 +298,8 @@ class dba
         * @param string $sql An SQL string without the values
         * @return string The input SQL string modified if necessary.
         */
-       public static function any_value_fallback($sql) {
-               $server_info = self::server_info();
+       public static function anyValueFallback($sql) {
+               $server_info = self::serverInfo();
                if (version_compare($server_info, '5.7.5', '<') ||
                        (stripos($server_info, 'MariaDB') !== false)) {
                        $sql = str_ireplace('ANY_VALUE(', 'MIN(', $sql);
@@ -295,7 +316,7 @@ class dba
         * @param string $sql An SQL string without the values
         * @return string The input SQL string modified if necessary.
         */
-       public static function clean_query($sql) {
+       public static function cleanQuery($sql) {
                $search = ["\t", "\n", "\r", "  "];
                $replace = [' ', ' ', ' ', ' '];
                do {
@@ -353,7 +374,7 @@ class dba
         * @usage Example: $r = p("SELECT * FROM `item` WHERE `guid` = ?", $guid);
         *
         * Please only use it with complicated queries.
-        * For all regular queries please use dba::select or dba::exists
+        * For all regular queries please use DBA::select or DBA::exists
         *
         * @param string $sql SQL statement
         * @return bool|object statement object or result object
@@ -385,8 +406,8 @@ class dba
                        logger('Parameter mismatch. Query "'.$sql.'" - Parameters '.print_r($args, true), LOGGER_DEBUG);
                }
 
-               $sql = self::clean_query($sql);
-               $sql = self::any_value_fallback($sql);
+               $sql = self::cleanQuery($sql);
+               $sql = self::anyValueFallback($sql);
 
                $orig_sql = $sql;
 
@@ -414,8 +435,8 @@ class dba
                        case 'pdo':
                                // If there are no arguments we use "query"
                                if (count($args) == 0) {
-                                       if (!$retval = self::$db->query($sql)) {
-                                               $errorInfo = self::$db->errorInfo();
+                                       if (!$retval = self::$connection->query($sql)) {
+                                               $errorInfo = self::$connection->errorInfo();
                                                self::$error = $errorInfo[2];
                                                self::$errorno = $errorInfo[1];
                                                $retval = false;
@@ -425,8 +446,8 @@ class dba
                                        break;
                                }
 
-                               if (!$stmt = self::$db->prepare($sql)) {
-                                       $errorInfo = self::$db->errorInfo();
+                               if (!$stmt = self::$connection->prepare($sql)) {
+                                       $errorInfo = self::$connection->errorInfo();
                                        self::$error = $errorInfo[2];
                                        self::$errorno = $errorInfo[1];
                                        $retval = false;
@@ -460,22 +481,22 @@ class dba
 
                                // The fallback routine is called as well when there are no arguments
                                if (!$can_be_prepared || (count($args) == 0)) {
-                                       $retval = self::$db->query(self::replaceParameters($sql, $args));
-                                       if (self::$db->errno) {
-                                               self::$error = self::$db->error;
-                                               self::$errorno = self::$db->errno;
+                                       $retval = self::$connection->query(self::replaceParameters($sql, $args));
+                                       if (self::$connection->errno) {
+                                               self::$error = self::$connection->error;
+                                               self::$errorno = self::$connection->errno;
                                                $retval = false;
                                        } else {
                                                if (isset($retval->num_rows)) {
                                                        self::$affected_rows = $retval->num_rows;
                                                } else {
-                                                       self::$affected_rows = self::$db->affected_rows;
+                                                       self::$affected_rows = self::$connection->affected_rows;
                                                }
                                        }
                                        break;
                                }
 
-                               $stmt = self::$db->stmt_init();
+                               $stmt = self::$connection->stmt_init();
 
                                if (!$stmt->prepare($sql)) {
                                        self::$error = $stmt->error;
@@ -505,8 +526,8 @@ class dba
                                }
 
                                if (!$stmt->execute()) {
-                                       self::$error = self::$db->error;
-                                       self::$errorno = self::$db->errno;
+                                       self::$error = self::$connection->error;
+                                       self::$errorno = self::$connection->errno;
                                        $retval = false;
                                } else {
                                        $stmt->store_result();
@@ -571,7 +592,7 @@ class dba
        /**
         * @brief Executes a prepared statement like UPDATE or INSERT that doesn't return data
         *
-        * Please use dba::delete, dba::insert, dba::update, ... instead
+        * Please use DBA::delete, DBA::insert, DBA::update, ... instead
         *
         * @param string $sql SQL statement
         * @return boolean Was the query successfull? False is returned only if an error occurred
@@ -640,6 +661,10 @@ class dba
 
                $fields = [];
 
+               if (empty($condition)) {
+                       return DBStructure::existsTable($table);
+               }
+
                reset($condition);
                $first_key = key($condition);
                if (!is_int($first_key)) {
@@ -651,7 +676,7 @@ class dba
                if (is_bool($stmt)) {
                        $retval = $stmt;
                } else {
-                       $retval = (self::num_rows($stmt) > 0);
+                       $retval = (self::numRows($stmt) > 0);
                }
 
                self::close($stmt);
@@ -662,13 +687,13 @@ class dba
        /**
         * Fetches the first row
         *
-        * Please use dba::selectFirst or dba::exists whenever this is possible.
+        * Please use DBA::selectFirst or DBA::exists whenever this is possible.
         *
         * @brief Fetches the first row
         * @param string $sql SQL statement
         * @return array first row of query
         */
-       public static function fetch_first($sql) {
+       public static function fetchFirst($sql) {
                $params = self::getParam(func_get_args());
 
                $stmt = self::p($sql, $params);
@@ -689,7 +714,7 @@ class dba
         *
         * @return int Number of rows
         */
-       public static function affected_rows() {
+       public static function affectedRows() {
                return self::$affected_rows;
        }
 
@@ -717,7 +742,7 @@ class dba
         * @param PDOStatement|mysqli_result|mysqli_stmt Statement object
         * @return int Number of rows
         */
-       public static function num_rows($stmt) {
+       public static function numRows($stmt) {
                if (!is_object($stmt)) {
                        return 0;
                }
@@ -826,10 +851,10 @@ class dba
        public static function lastInsertId() {
                switch (self::$driver) {
                        case 'pdo':
-                               $id = self::$db->lastInsertId();
+                               $id = self::$connection->lastInsertId();
                                break;
                        case 'mysqli':
-                               $id = self::$db->insert_id;
+                               $id = self::$connection->insert_id;
                                break;
                }
                return $id;
@@ -848,22 +873,22 @@ class dba
                // See here: https://dev.mysql.com/doc/refman/5.7/en/lock-tables-and-transactions.html
                if (self::$driver == 'pdo') {
                        self::e("SET autocommit=0");
-                       self::$db->setAttribute(PDO::ATTR_EMULATE_PREPARES, true);
+                       self::$connection->setAttribute(PDO::ATTR_EMULATE_PREPARES, true);
                } else {
-                       self::$db->autocommit(false);
+                       self::$connection->autocommit(false);
                }
 
                $success = self::e("LOCK TABLES `".self::escape($table)."` WRITE");
 
                if (self::$driver == 'pdo') {
-                       self::$db->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
+                       self::$connection->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
                }
 
                if (!$success) {
                        if (self::$driver == 'pdo') {
                                self::e("SET autocommit=1");
                        } else {
-                               self::$db->autocommit(true);
+                               self::$connection->autocommit(true);
                        }
                } else {
                        self::$in_transaction = true;
@@ -881,16 +906,16 @@ class dba
                self::performCommit();
 
                if (self::$driver == 'pdo') {
-                       self::$db->setAttribute(PDO::ATTR_EMULATE_PREPARES, true);
+                       self::$connection->setAttribute(PDO::ATTR_EMULATE_PREPARES, true);
                }
 
                $success = self::e("UNLOCK TABLES");
 
                if (self::$driver == 'pdo') {
-                       self::$db->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
+                       self::$connection->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
                        self::e("SET autocommit=1");
                } else {
-                       self::$db->autocommit(true);
+                       self::$connection->autocommit(true);
                }
 
                self::$in_transaction = false;
@@ -909,15 +934,13 @@ class dba
 
                switch (self::$driver) {
                        case 'pdo':
-                               if (self::$db->inTransaction()) {
-                                       break;
-                               }
-                               if (!self::$db->beginTransaction()) {
+                               if (!self::$connection->inTransaction() && !self::$connection->beginTransaction()) {
                                        return false;
                                }
                                break;
+
                        case 'mysqli':
-                               if (!self::$db->begin_transaction()) {
+                               if (!self::$connection->begin_transaction()) {
                                        return false;
                                }
                                break;
@@ -931,13 +954,16 @@ class dba
        {
                switch (self::$driver) {
                        case 'pdo':
-                               if (!self::$db->inTransaction()) {
+                               if (!self::$connection->inTransaction()) {
                                        return true;
                                }
-                               return self::$db->commit();
+
+                               return self::$connection->commit();
+
                        case 'mysqli':
-                               return self::$db->commit();
+                               return self::$connection->commit();
                }
+
                return true;
        }
 
@@ -964,14 +990,15 @@ class dba
 
                switch (self::$driver) {
                        case 'pdo':
-                               if (!self::$db->inTransaction()) {
+                               if (!self::$connection->inTransaction()) {
                                        $ret = true;
                                        break;
                                }
-                               $ret = self::$db->rollBack();
+                               $ret = self::$connection->rollBack();
                                break;
+
                        case 'mysqli':
-                               $ret = self::$db->rollback();
+                               $ret = self::$connection->rollback();
                                break;
                }
                self::$in_transaction = false;
@@ -1035,7 +1062,12 @@ class dba
 
                $commands[$key] = ['table' => $table, 'conditions' => $conditions];
 
-               $cascade = defaults($options, 'cascade', true);
+               // Don't use "defaults" here, since it would set "false" to "true"
+               if (isset($options['cascade'])) {
+                       $cascade = $options['cascade'];
+               } else {
+                       $cascade = true;
+               }
 
                // To speed up the whole process we cache the table relations
                if ($cascade && count(self::$relation) == 0) {
@@ -1275,7 +1307,7 @@ class dba
         *
         * $params = array("order" => array("id", "received" => true), "limit" => 10);
         *
-        * $data = dba::select($table, $fields, $condition, $params);
+        * $data = DBA::select($table, $fields, $condition, $params);
         */
        public static function select($table, array $fields = [], array $condition = [], array $params = [])
        {
@@ -1317,7 +1349,7 @@ class dba
         * or:
         * $condition = ["`uid` = ? AND `network` IN (?, ?)", 1, 'dfrn', 'dspr'];
         *
-        * $count = dba::count($table, $condition);
+        * $count = DBA::count($table, $condition);
         */
        public static function count($table, array $condition = [])
        {
@@ -1329,7 +1361,7 @@ class dba
 
                $sql = "SELECT COUNT(*) AS `count` FROM `".$table."`".$condition_string;
 
-               $row = self::fetch_first($sql, $condition);
+               $row = self::fetchFirst($sql, $condition);
 
                return $row['count'];
        }
@@ -1371,7 +1403,7 @@ class dba
                                                /* Workaround for MySQL Bug #64791.
                                                 * Never mix data types inside any IN() condition.
                                                 * In case of mixed types, cast all as string.
-                                                * Logic needs to be consistent with dba::p() data types.
+                                                * Logic needs to be consistent with DBA::p() data types.
                                                 */
                                                $is_int = false;
                                                $is_alpha = false;
@@ -1431,7 +1463,7 @@ class dba
 
                $limit_string = '';
                if (isset($params['limit']) && is_int($params['limit'])) {
-                       $limit_string = " LIMIT " . $params['limit'];
+                       $limit_string = " LIMIT " . intval($params['limit']);
                }
 
                if (isset($params['limit']) && is_array($params['limit'])) {
@@ -1447,7 +1479,7 @@ class dba
         * @param object $stmt statement object
         * @return array Data array
         */
-       public static function inArray($stmt, $do_close = true) {
+       public static function toArray($stmt, $do_close = true) {
                if (is_bool($stmt)) {
                        return $stmt;
                }
@@ -1502,7 +1534,7 @@ class dba
                        case 'mysqli':
                                // MySQLi offers both a mysqli_stmt and a mysqli_result class.
                                // We should be careful not to assume the object type of $stmt
-                               // because dba::p() has been able to return both types.
+                               // because DBA::p() has been able to return both types.
                                if ($stmt instanceof mysqli_stmt) {
                                        $stmt->free_result();
                                        $ret = $stmt->close();
@@ -1519,4 +1551,101 @@ class dba
 
                return $ret;
        }
+
+       /**
+        * @brief Return a list of database processes
+        *
+        * @return array
+        *      'list' => List of processes, separated in their different states
+        *      'amount' => Number of concurrent database processes
+        */
+       public static function processlist()
+       {
+               $ret = self::p("SHOW PROCESSLIST");
+               $data = self::toArray($ret);
+
+               $s = [];
+
+               $processes = 0;
+               $states = [];
+               foreach ($data as $process) {
+                       $state = trim($process["State"]);
+
+                       // Filter out all non blocking processes
+                       if (!in_array($state, ["", "init", "statistics", "updating"])) {
+                               ++$states[$state];
+                               ++$processes;
+                       }
+               }
+
+               $statelist = "";
+               foreach ($states as $state => $usage) {
+                       if ($statelist != "") {
+                               $statelist .= ", ";
+                       }
+                       $statelist .= $state.": ".$usage;
+               }
+               return(["list" => $statelist, "amount" => $processes]);
+       }
+
+       /**
+        * Checks if $array is a filled array with at least one entry.
+        *
+        * @param mixed $array A filled array with at least one entry
+        *
+        * @return boolean Whether $array is a filled array or an object with rows
+        */
+       public static function isResult($array)
+       {
+               // It could be a return value from an update statement
+               if (is_bool($array)) {
+                       return $array;
+               }
+
+               if (is_object($array)) {
+                       return self::numRows($array) > 0;
+               }
+
+               return (is_array($array) && (count($array) > 0));
+       }
+
+       /**
+        * @brief Callback function for "esc_array"
+        *
+        * @param mixed   $value         Array value
+        * @param string  $key           Array key
+        * @param boolean $add_quotation add quotation marks for string values
+        * @return void
+        */
+       private static function escapeArrayCallback(&$value, $key, $add_quotation)
+       {
+               if (!$add_quotation) {
+                       if (is_bool($value)) {
+                               $value = ($value ? '1' : '0');
+                       } else {
+                               $value = self::escape($value);
+                       }
+                       return;
+               }
+
+               if (is_bool($value)) {
+                       $value = ($value ? 'true' : 'false');
+               } elseif (is_float($value) || is_integer($value)) {
+                       $value = (string) $value;
+               } else {
+                       $value = "'" . self::escape($value) . "'";
+               }
+       }
+
+       /**
+        * @brief Escapes a whole array
+        *
+        * @param mixed   $arr           Array with values to be escaped
+        * @param boolean $add_quotation add quotation marks for string values
+        * @return void
+        */
+       public static function escapeArray(&$arr, $add_quotation = false)
+       {
+               array_walk($arr, 'self::escapeArrayCallback', $add_quotation);
+       }
 }