sysPass/lib/SP/Storage/Database/DbWrapper.php

<?php
/**
 * sysPass
 *
 * @author    nuxsmin
 * @link      https://syspass.org
 * @copyright 2012-2018, Rubén Domínguez nuxsmin@$syspass.org
 *
 * This file is part of sysPass.
 *
 * sysPass is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * sysPass is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 *  along with sysPass.  If not, see <http://www.gnu.org/licenses/>.
 */

namespace SP\Storage\Database;

use SP\Core\Exceptions\ConstraintException;
use SP\Core\Exceptions\QueryException;
use SP\Core\Exceptions\SPException;

defined('APP_ROOT') || die();

/**
 * Esta clase es la encargada de realizar las operaciones con la BBDD de sysPass.
 */
class DbWrapper
{
    /**
     * @var int
     */
    public static $lastId;
    /**
     * @var bool Contar el número de filas totales
     */
    private static $fullRowCount = false;

    /**
     * @return int
     */
    public static function getLastId()
    {
        return self::$lastId;
    }

    /**
     * Devolver los resultados en array
     *
     * @param QueryData         $queryData
     * @param DatabaseInterface $db
     *
     * @return QueryResult
     * @throws ConstraintException
     * @throws QueryException
     */
    public static function getResultsArray(QueryData $queryData, DatabaseInterface $db = null)
    {
        return $db->doQuery($queryData);
    }

    /**
     * Obtener los resultados de una consulta.
     *
     * @param QueryData         $queryData QueryData Los datos de la consulta
     * @param DatabaseInterface $db
     *
     * @return QueryResult devuelve bool si hay un error. Devuelve array con el array de registros devueltos
     * @throws ConstraintException
     * @throws QueryException
     */
    public static function getResults(QueryData $queryData, DatabaseInterface $db = null)
    {
        return $db->doQuery($queryData);
    }

    /**
     * Realizar una consulta y devolver el resultado sin datos
     *
     * @param QueryData         $queryData Los datos para realizar la consulta
     * @param DatabaseInterface $db
     *
     * @return int
     * @throws QueryException
     * @throws ConstraintException
     */
    public static function getQuery(QueryData $queryData, DatabaseInterface $db)
    {
        return $db->doQuery($queryData)->getAffectedNumRows();
    }

    /**
     * Establecer si es necesario contar el número total de resultados devueltos
     */
    public static function setFullRowCount()
    {
        self::$fullRowCount = true;
    }

    /**
     * Iniciar una transacción
     *
     * @param DatabaseInterface $db
     *
     * @return bool
     * @throws SPException
     */
    public static function beginTransaction(DatabaseInterface $db)
    {
        $conn = $db->getDbHandler()->getConnection();

        return !$conn->inTransaction() && $conn->beginTransaction();
    }

    /**
     * Finalizar una transacción
     *
     * @param DatabaseInterface $db
     *
     * @return bool
     * @throws SPException
     */
    public static function endTransaction(DatabaseInterface $db)
    {
        $conn = $db->getDbHandler()->getConnection();

        return $conn->inTransaction() && $conn->commit();
    }

    /**
     * Rollback de una transacción
     *
     * @param DatabaseInterface $db
     *
     * @return bool
     * @throws SPException
     */
    public static function rollbackTransaction(DatabaseInterface $db)
    {
        $conn = $db->getDbHandler()->getConnection();

        return $conn->inTransaction() && $conn->rollBack();
    }

    /**
     * Restablecer los atributos estáticos
     */
    private static function resetVars()
    {
        self::$fullRowCount = false;
    }

    /**
     * Método para registar los eventos de BD en el log
     *
     * @param string     $query La consulta que genera el error
     * @param \Exception $e
     * @param string     $queryFunction
     */
    private static function logDBException($query, \Exception $e, $queryFunction)
    {
//        $caller = Util::traceLastCall($queryFunction);
//
//        $LogMessage = new LogMessage();
//        $LogMessage->setAction($caller);
//        $LogMessage->addDescription(__u('Error en la consulta'));
//        $LogMessage->addDescription(sprintf('%s (%s)', $e->getMessage(), $e->getCode()));
//        $LogMessage->addDetails('SQL', DBUtil::escape($query));

        debugLog(sprintf('%s (%s)', $e->getMessage(), $e->getCode()), true);
        debugLog($query);

        // Solo registrar eventos de ls BD si no son consultas del registro de eventos
//        if ($caller !== 'writeLog') {
//            $Log = new Log($LogMessage);
//            $Log->setLogLevel(Log::ERROR);
//            $Log->writeLog();
//        }
    }
}