. */ use Illuminate\Database\Capsule\Manager as Capsule; /** * Classe per gestire la connessione al database. * * @since 2.3 */ class Database extends Util\Singleton { /** @var Capsule Gestore di connessione Laravel */ protected $capsule; /** @var string Nome del database */ protected $database_name; /** @var bool Stato di connessione del database */ protected $is_connected; /** @var bool Stato di installazione del database */ protected $is_installed; /** @var string Versione corrente di MySQL */ protected $mysql_version; /** * Costruisce la nuova connessione al database. * Ispirato dal framework open-source Medoo. * * @param string|array $server * @param string $username * @param string $password * @param string $database_name * @param string $charset * * @since 2.3 * * @return Database */ protected function __construct($server, $username, $password, $database_name, $charset = null) { if (is_array($server)) { $host = $server['host']; $port = !empty($server['port']) ? $server['port'] : null; } else { $temp = explode(':', $server); $host = $temp[0]; $port = !empty($temp[1]) ? $temp[1] : null; } // Possibilità di specificare una porta per il servizio MySQL diversa dalla standard 3306 $port = !empty(App::getConfig()['port']) ? App::getConfig()['port'] : $port; $this->database_name = $database_name; if (!empty($host) && !empty($database_name)) { try { // Istanziamento di Eloquent $this->capsule = new Capsule(); $this->capsule->addConnection([ 'driver' => 'mysql', 'host' => $host, 'database' => $database_name, 'username' => $username, 'password' => $password, 'charset' => 'utf8mb4', 'collation' => 'utf8mb4_general_ci', 'prefix' => '', 'port' => $port, 'options' => App::getConfig()['db_options'], ]); $this->is_connected = !empty($this->getPDO()); // Impostazione del charset della comunicazione if (empty($charset) && version_compare($this->getMySQLVersion(), '5.5.3') >= 0) { $this->getPDO()->exec("SET NAMES 'utf8mb4'"); } // Fix per problemi di compatibilità delle password MySQL 4.1+ (da versione precedente) // $this->getPDO()->exec('SET SESSION old_passwords = 0'); // $this->getPDO()->exec('SET PASSWORD = PASSWORD('.$this->prepare($this->password).')'); // Reset della modalità di esecuzione MySQL per la sessione corrente $this->getPDO()->exec("SET sql_mode = ''"); $this->capsule->setAsGlobal(); $this->capsule->bootEloquent(); } catch (PDOException $e) { if ($e->getCode() == 1049 || $e->getCode() == 1044) { $e = new PDOException(($e->getCode() == 1049) ? tr('Database non esistente!') : tr('Credenziali di accesso invalide!')); } throw $e; } } } /** * Restituisce la connessione attiva al database, creandola nel caso non esista. * * @since 2.3 * * @return Database */ public static function getConnection($new = false, $data = []) { $class = get_called_class(); if (empty(parent::$instance[$class]) || !parent::$instance[$class]->isConnected() || $new) { $config = App::getConfig(); // Sostituzione degli eventuali valori aggiuntivi $config = array_merge($config, $data); parent::$instance[$class] = new self($config['db_host'], $config['db_username'], $config['db_password'], $config['db_name']); } return parent::$instance[$class]; } public static function getInstance() { return self::getConnection(); } /** * Restituisce l'oggetto PDO artefice della connessione. * * @since 2.3 * * @return \DebugBar\DataCollector\PDO\TraceablePDO|PDO */ public function getPDO() { return $this->capsule->getConnection()->getPDO(); } public function getCapsule() { return $this->capsule; } /** * Controlla se la connessione è valida e andata a buon fine. * * @since 2.3 * * @return bool */ public function isConnected() { return $this->is_connected; } /** * Controlla se il database necessario al progetto esiste. * * @since 2.3 * * @return bool */ public function isInstalled() { if (empty($this->is_installed)) { $this->is_installed = $this->tableExists('zz_modules'); } return $this->is_installed; } /** * Restituisce la versione del DBMS MySQL in utilizzo. * * @since 2.3 * * @return string */ public function getMySQLVersion() { if (empty($this->mysql_version) && $this->isConnected()) { $ver = $this->fetchArray('SELECT VERSION()'); if (!empty($ver[0]['VERSION()'])) { $this->mysql_version = explode('-', $ver[0]['VERSION()'])[0]; } } return $this->mysql_version; } /** * Restituisce il tipo di DBMS. * * @return string */ public function getType() { $ver = $this->fetchArray('SELECT VERSION()'); if (preg_match('/MariaDB/', $ver[0]['VERSION()'])) { return 'MariaDB'; } else { return 'MySQL'; } } /** * Controlla il tipo se il DBMS è MySQL. * * @return bool */ public function isMySQL() { $ver = $this->fetchOne('SELECT VERSION()')['VERSION()']; if (preg_match('/MariaDB/', $ver)) { return false; } else { return true; } } /** * Restituisce il nome del database a cui si è connessi. * * @since 2.3 * * @return string */ public function getDatabaseName() { return $this->database_name; } /** * Esegue la query indicata, restituendo l'identificativo della nuova entità se si tratta di una query di inserimento. * * @since 2.0 * * @param string $query Query da eseguire * @param array $parameters * * @return int */ public function query($query, $parameters = []) { $statement = $this->getPDO()->prepare($query); $statement->execute($parameters); $id = $this->lastInsertedID(); if ($id == 0) { return 1; } else { return $id; } } /** * Restituisce un'array strutturato in base ai nomi degli attributi della selezione. * * @param string $query Query da eseguire * @param array $parameters * @param bool $numeric * * @throws Exception * * @return array */ public function fetchArray($query, $parameters = [], $numeric = false) { try { $mode = empty($numeric) ? PDO::FETCH_ASSOC : PDO::FETCH_NUM; $statement = $this->getPDO()->prepare($query); $statement->execute($parameters); $result = $statement->fetchAll($mode); return $result; } catch (PDOException $e) { } } /** * Restituisce un'array strutturato in base agli indici degli attributi della selezione. * * @since 2.0 * @deprecated 2.3 * * @param string $query Query da eseguire * * @return array */ public function fetchRows($query) { return $this->fetchArray($query, [], true); } /** * Restituisce il primo elemento della selezione, strutturato in base ai nomi degli attributi. * * @since 2.0 * @deprecated 2.3 * * @param string $query Query da eseguire * * @return array */ public function fetchRow($query) { return $this->fetchOne($query); } /** * Restituisce il primo elemento della selezione, strutturato in base ai nomi degli attributi. * Attenzione: aggiunge il LIMIT relativo a fine della query. * * @since 2.4 * * @param string $query Query da eseguire * * @return array */ public function fetchOne($query, $parameters = []) { if (!string_contains($query, 'LIMIT')) { $query .= ' LIMIT 1'; } $result = $this->fetchArray($query, $parameters); if (isset($result[0])) { return $result[0]; } return $result; } /** * Restituisce il numero dei risultati della selezione. * * @since 2.0 * * @param string $query Query da eseguire * * @return int */ public function fetchNum($query, $parameters = []) { $result = $this->fetchArray('SELECT COUNT(*) as `tot` FROM ('.$query.') AS `count`', $parameters); if (!empty($result)) { return $result[0]['tot']; } return 0; } public function tableExists($table) { if ($this->isConnected()) { return $this->capsule->schema()->hasTable($table); } return null; } /** * Restituisce l'identificativo dell'ultimo elemento inserito. * * @since 2.0 * @deprecated 2.3 * * @return int */ public function last_inserted_id() { return $this->lastInsertedID(); } /** * Restituisce l'identificativo dell'ultimo elemento inserito. * * @since 2.3 * * @return int */ public function lastInsertedID() { try { return $this->getPDO()->lastInsertId(); } catch (PDOException $e) { throw new PDOException(tr("Impossibile ottenere l'ultimo identificativo creato")); } } /** * Prepara il parametro inserito per l'inserimento in una query SQL. * Attenzione: protezione di base contro SQL Injection. * * @param string $parameter * * @since 2.3 */ public function prepare($parameter) { return $this->getPDO()->quote((string) $parameter); } /** * Costruisce la query per l'INSERT definito dagli argomenti. * * @since 2.3 * * @param string $table * @param array $array * * @return string|array */ public function insert($table, $array) { if (!is_string($table) || !is_array($array)) { throw new UnexpectedValueException(); } if (!isset($array[0]) || !is_array($array[0])) { $array = [$array]; } return Capsule::table($table)->insert($array); } /** * Costruisce la query per l'UPDATE definito dagli argomenti. * * @since 2.3 * * @param string $table * @param array $array * @param array $conditions * * @return string|array */ public function update($table, $array, $conditions) { if (!is_string($table) || !is_array($array) || !is_array($conditions)) { throw new UnexpectedValueException(); } return Capsule::table($table)->where($conditions)->update($array); } /** * Costruisce la query per il SELECT definito dagli argomenti. * * @since 2.3 * * @param string $table * @param array $array * @param array $conditions * @param array $order * @param string|array $limit * @param bool $return * * @return string|array */ public function select($table, $array = [], $joins = [], $conditions = [], $order = [], $limit = null, $return = false, $group = [], $whereraw = []) { if ( !is_string($table) || (!empty($order) && !is_string($order) && !is_array($order)) || (!empty($limit) && !is_string($limit) && !is_integer($limit) && !is_array($limit)) ) { throw new UnexpectedValueException(); } // Valori da ottenere $select = []; foreach ((array) $array as $key => $value) { $select[] = $value.(is_numeric($key) ? '' : ' AS '.$key); } $select = !empty($select) ? $select : ['*']; $statement = Capsule::table($table); foreach ($joins as $join) { $statement = $statement->leftJoin($join[0], $join[1], $join[2]); } foreach ($whereraw as $w) { $statement->whereRaw($w); } $statement->where($conditions); foreach ($select as $s) { $statement->selectRaw($s); } // Impostazioni di ordinamento if (!empty($order)) { foreach ((array) $order as $key => $value) { $order = is_numeric($key) ? 'ASC' : strtoupper($value); $field = is_numeric($key) ? $value : $key; if ($order == 'ASC') { $statement = $statement->orderBy($field); } else { $statement = $statement->orderBy($field, 'DESC'); } } } // Gruppo if (!empty($group)) { $statement = $statement->groupBy($group); } // Eventuali limiti if (!empty($limit)) { $offset = is_array($limit) ? $limit[0] : null; $count = is_array($limit) ? $limit[1] : $limit; if ($offset) { $statement = $statement->offset($offset); } $statement = $statement->limit($count); } if (!empty($return)) { return $statement->toSql(); } else { $result = $statement->get()->toArray(); return json_decode(json_encode($result), true); } } /** * Costruisce la query per il SELECT definito dagli argomenti (LIMIT 1). * * @since 2.4.1 * * @param string $table * @param array $array * @param array $conditions * @param array $order * @param bool $return * * @return string|array */ public function selectOne($table, $array = [], $conditions = [], $order = [], $return = false) { $limit = 1; $result = $this->select($table, $array, [], $conditions, $order, $limit, $return); if (!is_string($result) && isset($result[0])) { return $result[0]; } return $result; } /** * Costruisce la query per l'DELETE definito dagli argomenti. * * @since 2.4.1 * * @param string $table * @param array $conditions * * @return string|array */ public function delete($table, $conditions) { if (!is_string($table) || !is_array($conditions)) { throw new UnexpectedValueException(); } // Costruzione della query return Capsule::table($table)->where($conditions)->delete(); } /** * Sincronizza i valori indicati associati alle condizioni, rimuovendo le combinazioni aggiuntive e inserendo quelle non ancora presenti. * * @since 2.3 * * @param string $table * @param array $conditions Condizioni di sincronizzazione * @param array $list Valori da sincronizzare */ public function sync($table, $conditions, $list) { if ( !is_string($table) || !is_array($conditions) || !is_array($list) ) { throw new UnexpectedValueException(); } $field = key($list); $sync = array_unique((array) current($list)); if (!empty($field)) { $results = array_column($this->select($table, $field, [], $conditions), $field); $detachs = array_unique(array_diff($results, $sync)); $this->detach($table, $conditions, [$field => $detachs]); $this->attach($table, $conditions, $list); } } /** * Inserisce le le combinazioni tra i valori indicati e le condizioni. * * @since 2.3 * * @param string $table * @param array $conditions Condizioni * @param array $list Valori da aggiungere */ public function attach($table, $conditions, $list) { if ( !is_string($table) || !is_array($conditions) || !is_array($list) ) { throw new UnexpectedValueException(); } $field = key($list); $sync = array_unique((array) current($list)); $inserts = []; if (!empty($field)) { $results = array_column($this->select($table, $field, [], $conditions), $field); $inserts = array_unique(array_diff($sync, $results)); foreach ($inserts as $insert) { $this->insert($table, array_merge($conditions, [$field => $insert])); } } return count($inserts); } /** * Rimuove le le combinazioni tra i valori indicati e le condizioni. * * @since 2.3 * * @param string $table * @param array $conditions Condizioni * @param array $list Valori da rimuovere */ public function detach($table, $conditions, $list) { if ( !is_string($table) || !is_array($conditions) || !is_array($list) ) { throw new UnexpectedValueException(); } $field = key($list); $sync = array_unique((array) current($list)); if (!empty($field) && !empty($sync)) { foreach ($sync as $element) { $conditions[$field] = $element; $this->delete($table, $conditions); } } } public function beginTransaction() { Capsule::beginTransaction(); } public function commitTransaction() { Capsule::commit(); } public function rollbackTransaction() { Capsule::rollBack(); } /** * Get a new raw query expression. * * @return Illuminate\Database\Query\Expression */ public function raw($value) { return $this->getCapsule()->getConnection()->raw($value); } /** * Begin a fluent query against a database table. * * @param string $table * * @return Illuminate\Database\Query\Builder */ public function table($table) { return $this->getCapsule()->getConnection()->table($table); } /** * Esegue le query interne ad un file ".sql". * * @since 2.0 * * @param string $filename Percorso per raggiungere il file delle query */ public function multiQuery($filename, $start = 0) { $queries = readSQLFile($filename, ';'); $end = count($queries); for ($i = $start; $i < $end; ++$i) { $this->query($queries[$i]); } return true; } }