Acceso a la Base de Datos
La clase DataBase nos permite operar directamente con la base de datos de FacturaScripts. Se conecta automáticamente al iniciar FacturaScripts y mantiene una única instancia durante toda la ejecución.
Limitaciones
No es posible conectar a otra base de datos que no sea la de FacturaScripts.
Conexión y Desconexión
FacturaScripts establece la conexión automáticamente al iniciar y la desconecta al finalizar la ejecución. No es necesario ni recomendable llamar manualmente a los métodos connect() o close().
Acceso desde Modelos y Controladores
Los modelos pueden acceder a la base de datos directamente llamando a self::$dataBase, mientras que los controladores lo hacen mediante $this->dataBase.
Para el resto de las clases, es necesario utilizar el namespace:
use FacturaScripts\Core\Base\DataBase;
$dataBase = new DataBase();Realizar un SELECT
Para ejecutar una consulta SELECT y obtener los resultados, se puede utilizar el método select().
$dataBase = new DataBase();
$data = $dataBase->select('SELECT DISTINCT ciudad FROM clientes;');
var_dump($data);Este método devuelve un array con los resultados. Si no hay resultados, el array estará vacío.
Paginación
Para realizar un SELECT con paginación, se puede utilizar el método selectLimit().
$dataBase = new DataBase();
$limit = 100;
$offset = 100;
$data = $dataBase->selectLimit('SELECT * FROM clientes', $limit, $offset);
var_dump($data);En esta consulta, se obtiene el listado de clientes, limitado a 100 elementos, comenzando desde el elemento número 100, es decir, es como obtener la segunda página de resultados de la consulta. Con $limit indicamos cuántos elementos devolver, y con $offset indicamos desde qué posición hacerlo.
Insertar, Actualizar o Eliminar
Para ejecutar consultas de tipo INSERT, UPDATE o DELETE, utilice el método exec().
$dataBase = new DataBase();
$dataBase->exec("UPDATE clientes SET ciudad = 'Alicante';");Este método devuelve TRUE si la consulta se ejecuta correctamente, o FALSE en caso contrario.
Transacciones
Las transacciones permiten deshacer cambios en la base de datos. Una transacción consta de tres pasos:
- Iniciar la transacción.
- Realizar cambios.
- Confirmar cambios o deshacer la transacción.
// Iniciamos la transacción
$dataBase = new DataBase();
$dataBase->beginTransaction();
// Realizamos cambios
$dataBase->exec("UPDATE clientes SET ciudad = 'Alicante';");
// Decidimos qué hacer
if( ... ) {
$dataBase->rollback(); // Deshacer
} else {
$dataBase->commit(); // Confirmar
}Las transacciones también se aplican a los cambios realizados por modelos, es decir, que podemos utilizarlas incluso al operar con modelos:
// Iniciamos la transacción
$dataBase = new DataBase();
$dataBase->beginTransaction();
// Creamos 100 productos
$total = 0;
for($num = 1; $num <= 100; $num++) {
$newProduct = new Producto();
$newProduct->descripcion = 'Producto ' . $num;
$newProduct->referencia = 'producto' . $num;
if(false === $newProduct->save()) {
break;
}
$total++;
}
// Si hemos creado menos de 100 productos, deshacemos los cambios (los productos desaparecen)
if($total < 100) {
$dataBase->rollback(); // Deshacer
} else {
$dataBase->commit(); // Confirmar
}Transacciones Anidadas
FacturaScripts no permite hacer transacciones dentro de otras transacciones. Sin embargo, podemos comprobar si ya estamos dentro de una transacción o iniciar una nueva:
// Comprobamos o iniciamos la transacción
$dataBase = new DataBase();
$newTransaction = false === $dataBase->inTransaction() && $dataBase->beginTransaction();
// Realizamos cambios
...
// Decidimos qué hacer
if(false === $newTransaction) {
// La transacción no la hemos iniciado nosotros, así que no hacemos nada
} if( ... ) {
$dataBase->rollback(); // Deshacer
} else {
$dataBase->commit(); // Confirmar
}