Acceso a la base de datos

La clase DataBase nos permite operar directamente con la base de datos de FacturaScripts. 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 ya conecta automáticamente al iniciar y desconecta cuando ha terminado la ejecución. No es necesario ni aconsejable 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. Los controladores llamando a $this->dataBase.

Para el resto de clases es necesario usar el namespace:

use FacturaScripts\Core\Base\DataBase;

$dataBase = new DataBase();

Hacer un select

Puede ejecutar una consulta select y obtener los resultados llamando al 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 en array estará vacío.

Paginación

Para hacer un select con paginación podemos usar 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 obtenemos el listado de clientes, limitado a 100 elementos, pero emepezando a partir del elemento nº100, es decir, es como obtener la segunda página de resultados de la consulta. Con el $limit indicamos cuantos elementos devolver, y con el $offset indicamos a partir de qué posición hacerlo.

Insert, update o delete

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 3 pasos:

  • Iniciar transacción.
  • Hacer cambios.
  • Confirmar cambios o deshacer transacción.
/// iniciamos la transacción
$dataBase = new DataBase();
$dataBase->beginTransaction();

/// hacemos cambios
$dataBase->exec("UPDATE clientes SET ciudad = 'Alicante';");

/// decidimos qué hacer
if( ... ) {
   $dataBase->rollback(); /// deshacer
} else {
   $dataBase->commit(); /// confirmar
}

Las transacciones también afectan a los cambios realizados por modelos, es decir, que podemos usarlas incluso cuando operamos 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 dentro de transacciones

FacturaScripts no permite hacer transacciones dentro de otras transacciones. Lo que si que podemos hacer es comprobar previamente si ya estamos dentro de una transacción o la iniciamos nosotros:

/// comprobamos o iniciamos la transacción
$dataBase = new DataBase();
$newTransation = false === $dataBase->inTransaction() && $dataBase->beginTransaction();

/// hacemos cambios
...

/// decidimos qué hacer
if(false === $newTransation) {
  /// la transacción no la hemos iniciado nosotros, así que no hacemos nada
} if( ... ) {
   $dataBase->rollback(); /// deshacer
} else {
   $dataBase->commit(); /// confirmar
}

  Siguiente

Necesita identificarse para continuar con esta acción. Haga clic en iniciar sesión o cree una cuenta.

Iniciar sesión
neorazorx_1
neorazorx_1

España, 8 años, nivel 100

Fecha de creación 11-05-2018 00:00:00
Última actualización 04-02-2021
Contador de visitas 3917

Patrocinadores

FacturaScripts avanza más rápido gracias al apoyo financiero de los patrocinadores, que contribuyen a que podamos dedicar más tiempo al desarrollo, testeo y documentación. Usted también puede poner su granito de arena y convertirse en patrocinador ;-)

ORO
elurk_3992
ORO
mgmultigestion_11543
PLATA
prebac_1378
PLATA
yolandass_1347
BRONCE
ldardon_11876
BRONCE
necatorem_12616
BRONCE
omegatech.ventas_1859
Patrocinar

Amplíe sus conocimientos con los cursos oficiales

Curso básico de usuario

Con este curso aprenderá a gestionar el día a día de su negocio con FacturaScripts 2021: hacer facturas, albaranes, pedidos y presupuestos. Gestionar clientes, proveedores y tarifas. Y a realizar la regularización de impuestos (trimestre de IVA). ¿A quién va dirigido? A cualquier usuario que ya tenga FacturaScripts instalado en su PC o hosting y quiera aprender rápidamente el manejo diario del programa. ¿Qué incluye? 18 lecciones con 17 vídeos explicativos.

227 4,99 €
Curso básico de programación

Con este curso aprenderá cómo crear un plugin sencillo para FacturaScripts 2021: añadir nuevas páginas, tablas y columnas. Para entender este curso no se necesita mucha experiencia en programación, le enseñaremos los básico para modelar problemas sencillos. ¿A quién va dirigido? A cualquier persona con unos conocimientos muy básicos de programación. ¿Qué incluye? 18 lecciones con 14 vídeos explicativos.

237 8,99 €
Sesiones de programación 2021

Esta es una recopilación de vídeos y documentación de pequeños desarrollos sobre FacturaScripts 2021 y sus plugins. Perfecto para expandir tus conocimientos de programación. ¿A quién va dirigido? A personas que ya hayan superado el curso básico de programación y busquen ampliar sus conocimientos. ¿Qué incluye? 9 lecciones con 9 vídeos explicativos (más de 5 horas de vídeos) y el código fuente de los ejemplos. Novedades mensuales: Este curso se amplía cada mes con nuevas lecciones.

41 14,99 €

Copyright (c) 2013-2021 FacturaScripts