Subversion Repositories oidplus

<?php

/*

 * OIDplus 2.0

 * Copyright 2019 Daniel Marschall, ViaThinkSoft

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *     http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */

if (!defined('IN_OIDPLUS')) die();

class OIDplusDatabasePluginMySQLi extends OIDplusDatabasePlugin {

        private $conn = null; // only with MySQLnd

        private $prepare_cache = array();

        private $last_error = null; // we need that because MySQL divides prepared statement errors and normal query errors, but we have only one "error()" method

        public static function getPluginInformation(): array {

                $out = array();

                $out['name'] = 'MySQLi';

                $out['author'] = 'ViaThinkSoft';

                $out['version'] = null;

                $out['descriptionHTML'] = null;

                return $out;

        }

        public static function id(): string {

                return "MySQL";

        }

        public function doQuery(string $sql, /*?array*/ $prepared_args=null): OIDplusQueryResult {

                $this->last_error = null;

                if (is_null($prepared_args)) {

                        $res = $this->conn->query($sql, MYSQLI_STORE_RESULT);

                        if ($res === false) {

                                $this->last_error = $this->conn->error;

                                throw new OIDplusSQLException($sql, $this->error());

                        } else {

                                return new OIDplusQueryResultMySQL($res);

                        }

                } else {

                        if (!is_array($prepared_args)) {

                                throw new OIDplusException("'prepared_args' must be either NULL or an ARRAY.");

                        }

                        foreach ($prepared_args as &$value) {

                                // MySQLi has problems converting "true/false" to the data type "tinyint(1)"

                                // It seems to be the same issue like in PDO reported 14 years ago at https://bugs.php.net/bug.php?id=57157

                                if (is_bool($value)) $value = $value ? '1' : '0';

                        }

                        if (isset($this->prepare_cache[$sql])) {

                                $ps = $this->prepare_cache[$sql];

                        } else {

                                $ps = $this->conn->prepare($sql);

                                if (!$ps) {

                                        $this->last_error = $this->conn->error;

                                        throw new OIDplusSQLException($sql, 'Cannot prepare statement: '.$this->error());

                                }

                                // Caching the prepared is very risky

                                // In PDO and ODBC we may not do it, because execute() will

                                // destroy the existing cursors.

                                // (test this with ./?goto=oid%3A1.3.6.1.4.1.37553.8.32488192274

                                // you will see that 2.999 is missing in the tree)

                                // But $ps->get_result() seems to "clone" the cursor,

                                // so that $ps->execute may be called a second time?!

                                // However, it only works with mysqlnd's get_result,

                                // not with OIDplusQueryResultMySQLNoNativeDriver

                                if (self::nativeDriverAvailable()) {

                                        $this->prepare_cache[$sql] = $ps;

                                }

                        }

                        self::bind_placeholder_vars($ps,$prepared_args);

                        if (!$ps->execute()) {

                                $this->last_error = mysqli_stmt_error($ps);

                                throw new OIDplusSQLException($sql, $this->error());

                        }

                        if (self::nativeDriverAvailable()) {

                                return new OIDplusQueryResultMySQL($ps->get_result());

                        } else {

                                return new OIDplusQueryResultMySQLNoNativeDriver($ps);

                        }

                }

        }

        public function insert_id(): int {

                return $this->conn->insert_id;

        }

        public function error(): string {

                $err = $this->last_error;

                if ($err == null) $err = '';

                return $err;

        }

        protected function doConnect()/*: void*/ {

                if (!function_exists('mysqli_connect')) throw new OIDplusException('PHP extension "MySQLi" not installed');

                // Try connecting to the database

                $host     = OIDplus::baseConfig()->getValue('MYSQL_HOST',     'localhost');

                $username = OIDplus::baseConfig()->getValue('MYSQL_USERNAME', 'root');

                $password = OIDplus::baseConfig()->getValue('MYSQL_PASSWORD', '');

                $database = OIDplus::baseConfig()->getValue('MYSQL_DATABASE', 'oidplus');

                list($hostname,$port) = explode(':', $host.':'.ini_get("mysqli.default_port"));

                $this->conn = @new mysqli($hostname, $username, $password, $database, $port);

                if (!empty($this->conn->connect_error) || ($this->conn->connect_errno != 0)) {

                        $message = $this->conn->connect_error;

                        throw new OIDplusConfigInitializationException('Connection to the database failed! '.$message);

                }

                $this->prepare_cache = array();

                $this->last_error = null;

                $this->query("SET NAMES 'utf8'");

                $this->slang = self::getHardcodedSlangById('mysql');

                if (is_null($this->slang)) {

                        throw new OIDplusConfigInitializationException("Slang plugin 'mysql' is missing");

                }

        }

        protected function doDisconnect()/*: void*/ {

                $this->prepare_cache = array();

                if (!is_null($this->conn)) {

                        $this->conn->close();

                        $this->conn = null;

                }

        }

        private $intransaction = false;

        public function transaction_begin()/*: void*/ {

                if ($this->intransaction) throw new OIDplusException("Nested transactions are not supported by this database plugin.");

                $this->conn->autocommit(false);

                $this->conn->begin_transaction();

                $this->intransaction = true;

        }

        public function transaction_commit()/*: void*/ {

                $this->conn->commit();

                $this->conn->autocommit(true);

                $this->intransaction = false;

        }

        public function transaction_rollback()/*: void*/ {

                $this->conn->rollback();

                $this->conn->autocommit(true);

                $this->intransaction = false;

        }

        public function sqlDate(): string {

                return 'now()';

        }

        public static function nativeDriverAvailable(): bool {

                return function_exists('mysqli_fetch_all') && (OIDplus::baseConfig()->getValue('MYSQL_FORCE_MYSQLND_SUPPLEMENT', false) === false);

        }

        private static function bind_placeholder_vars(&$stmt,$params): bool {

                // Credit to: Dave Morgan

                // Code taken from: http://www.devmorgan.com/blog/2009/03/27/dydl-part-3-dynamic-binding-with-mysqli-php/

                //                  https://stackoverflow.com/questions/17219214/how-to-bind-in-mysqli-dynamically

                if ($params != null) {

                        $types = '';                        //initial sting with types

                        foreach ($params as $param) {        //for each element, determine type and add

                                if (is_int($param)) {

                                        $types .= 'i';              //integer

                                } elseif (is_float($param)) {

                                        $types .= 'd';              //double

                                } elseif (is_string($param)) {

                                        $types .= 's';              //string

                                } else {

                                        $types .= 'b';              //blob and unknown

                                }

                        }

                        $bind_names = array();

                        $bind_names[] = $types;             //first param needed is the type string, e.g.: 'issss'

                        for ($i=0; $i<count($params);$i++) {    //go through incoming params and added em to array

                                $bind_name = 'bind' . $i;       //give them an arbitrary name

                                $$bind_name = $params[$i];      //add the parameter to the variable variable

                                $bind_names[] = &$$bind_name;   //now associate the variable as an element in an array

                        }

                        //error_log("better_mysqli has params ".print_r($bind_names, 1));

                        //call the function bind_param with dynamic params

                        call_user_func_array(array($stmt,'bind_param'),$bind_names);

                        return true;

                } else {

                        return false;

                }

        }

}

class OIDplusQueryResultMySQL extends OIDplusQueryResult {

        protected $no_resultset;

        protected $res;

        public function __construct($res) {

                $this->no_resultset = is_bool($res);

                if (!$this->no_resultset) {

                        $this->res = $res;

                }

        }

        public function __destruct() {

                if ($this->res) $this->res->close();

        }

        public function containsResultSet(): bool {

                return !$this->no_resultset;

        }

        public function num_rows(): int {

                if ($this->no_resultset) throw new OIDplusException("The query has returned no result set (i.e. it was not a SELECT query)");

                return $this->res->num_rows;

        }

        public function fetch_array()/*: ?array*/ {

                if ($this->no_resultset) throw new OIDplusException("The query has returned no result set (i.e. it was not a SELECT query)");

                return $this->res->fetch_array(MYSQLI_ASSOC);

        }

        public function fetch_object()/*: ?object*/ {

                if ($this->no_resultset) throw new OIDplusException("The query has returned no result set (i.e. it was not a SELECT query)");

                return $this->res->fetch_object("stdClass");

        }

}

class OIDplusQueryResultMySQLNoNativeDriver extends OIDplusQueryResult {

        // Based on https://www.php.net/manual/de/mysqli-stmt.get-result.php#113398

        protected $stmt;

        protected $nCols;

        protected $no_resultset;

        public function __construct($stmt) {

                $metadata = mysqli_stmt_result_metadata($stmt);

                $this->no_resultset = is_bool($metadata);

                if (!$this->no_resultset) {

                        $this->nCols = mysqli_num_fields($metadata);

                        $this->stmt = $stmt;

                        mysqli_free_result($metadata);

                }

        }

        public function containsResultSet(): bool {

                return !$this->no_resultset;

        }

        public function num_rows(): int {

                if ($this->no_resultset) throw new OIDplusException("The query has returned no result set (i.e. it was not a SELECT query)");

                $this->stmt->store_result();

                return $this->stmt->num_rows;

        }

        public function fetch_array()/*: ?array*/ {

                if ($this->no_resultset) throw new OIDplusException("The query has returned no result set (i.e. it was not a SELECT query)");

                // https://stackoverflow.com/questions/10752815/mysqli-get-result-alternative , modified

                $stmt = $this->stmt;

                $stmt->store_result();

                $resultkeys = array();

                $thisName = "";

                if ($stmt->num_rows==0) return null;

                for ($i = 0; $i < $stmt->num_rows; $i++) {

                        $metadata = $stmt->result_metadata();

                        while ($field = $metadata->fetch_field()) {

                                $thisName = $field->name;

                                $resultkeys[] = $thisName;

                        }

                }

                $ret = array();

                $args = array();

                for ($i=0; $i<$this->nCols; $i++) {

                        $ret[$i] = NULL;

                        $theValue = $resultkeys[$i];

                        $ret[$theValue] = NULL; // will be overwritten by mysqli_stmt_bind_result

                        $args[] = &$ret[$theValue];

                }

                if (!mysqli_stmt_bind_result($this->stmt, ...$args)) {

                        return null;

                }

                // This should advance the "$stmt" cursor.

                if (!mysqli_stmt_fetch($this->stmt)) {

                        return null;

                }

                // Return the array we built.

                return $ret;

        }

        public function fetch_object()/*: ?object*/ {

                if ($this->no_resultset) throw new OIDplusConfigInitializationException("The query has returned no result set (i.e. it was not a SELECT query)");

                $ary = $this->fetch_array();

                if (!$ary) return null;

                $obj = new stdClass;

                foreach ($ary as $name => $val) {

                        $obj->$name = $val;

                }

                return $obj;

        }

}