DbQuery

La clase DbQuery de FacturaScripts nos permite hacer una gran variedad de consultas a la base de datos, de forma muy sencilla:

Seleccionar una tabla

Debemos llamar al método table() de la clase DbQuery para poder hacer consultas sobre esa tabla. Si por ejemplo queremos obtener todos los registros de la tabla de familias, podemos ejecutar esto:

use FacturaScripts\Core\DbQuery;

$familias = DbQuery::table('familias')->get();

Con la función get obtenemos todos los registros y todas las columnas. Si solamente queremos algunas columnas, podemos indicarlo con el método select():

$descripciones_familias = DbQuery::table('familias')->select('descripcion')->get();

Filtrar los resultados

Podemos aplicar filtros a la consulta, por ejemplo obtener todos los productos de la familia 123.

// con whereEq aplicamos un filtro de columna = valor
$productos = DbQuery::table('productos')->whereEq('codfamilia', '123')->get();

// pero podemos hacer lo mismo con un array Where
$productos = DbQuery::table('productos')->where([Where:eq('codfamilia', '123')])->get();

// o con un filtro dinámico
$productos = DbQuery::table('productos')->whereCodfamilia('123')->get();

La clase soporta filtros directos como whereBetween(), whereEq(), whereGt(), whereGte(), whereIn(), whereLike(), whereLt(), whereLte(), whereNotEq(), whereNotIn(), whereNotNull(), whereNull(). Pero también podemos usar un array Where para filtros más complejos.

Y para mayor comodidad, podemos aplicar filtros dinámicos usando where + el nombre de la columna:

// where codfamilia = '123'
$productos = DbQuery::table('productos')->whereCodfamilia('123')->get();

// where codimpuesto = 'IVA21'
$productos = DbQuery::table('productos')->whereCodimpuesto('IVA21')->get();

Ordenar los resultados

Para ordenar los resultados podemos usar las funciones orderBy() y orderMulti():

// obtenemos los productos ordenados por precio y stock
$productos = DbQuery::table('productos')
                    ->orderBy('precio', 'ASC')
                    ->orderBy('stockfis', 'ASC')
                    ->get();

// lo mismo, pero con orderMulti()
$productos = DbQuery::table('productos')
                    ->orderMulti(['precio' => 'ASC', 'stockfis' => 'ASC'])
                    ->get();

Las llamadas a orderBy() y orderMulti() van añadiendo esos parámetros a la consulta, es decir, no reemplazan el orden previo. Si queremos limpiar o quitar el orden previo, debemos usar la función reorder().

Obtener el primer resultado

Para obtener solamente el primer resultado de la consulta debemos llamar la método first():

$primera = DbQuery::table('familias')->first();

Obtener el número de registros

Podemos usar el método count() para obtener el número de registros de la tabla:

$count = DbQuery::table('familias')->count();

Pero a veces lo que queremos es el número de valores distintos de una columna. Por ejemplo, si queremos saber a cuantos países distintos hemos vendido material, necesitamos el número de valores distintos de la columna codpais de la tabla facturascli. Y esto podemos obtenerlo de varias formas:

// opción 1
$numero = DbQuery::table('facturascli')->count('codpais');

// opción 2
$numero = DbQuery::table('facturascli')->selectRaw('DISTINCT codpais')->count();

// opción 3
$data = DbQuery::table('facturascli')->selectRaw('COUNT(DISTINCT codpais) as c')->first();
$numero = $data['c'];

Obtener el máximo, mínimo, media, suma...

Podemos obtener los resultados aplicando además alguna operación sobre ellos como obtener el valor máximo, el mínimo, la media o la suma:

// el máximo precio de los productos
$max = DbQuery::table('productos')->max('precio');

// el mínimo precio de los productos
$min = DbQuery::table('productos')->min('precio');

// el precio medio de los productos
$avg = DbQuery::table('productos')->avg('precio');

// la suma de todos los precios de los productos
$sum = DbQuery::table('productos')->sum('precio');

Podemos aplicar filtros a los resultados, pero debe ser antes de llamar a la función:

// el máximo precio de los producto de la familia 123
$max = DbQuery::table('productos')->whereEq('codfamilia', '123')->max('precio');

Insertar registros a la tabla

Podemos añadir registros a una tabla llamando al método insert():

// creamos el producto 777
DbQuery::table('productos')->insert([
    'referencia' => '777',
    'descripcion' => 'Producto 777',
    'precio' => 7.77
]);

El método insert() permite incluso que le pasemos una lista de múltiples registros para insertarlos todos a la vez:

// creamos los productos 888 y 999
DbQuery::table('productos')->insert([
    ['referencia' => '888', 'descripcion' => 'Producto 888', 'precio' => 8.88],
    ['referencia' => '999', 'descripcion' => 'Producto 999', 'precio' => 9.99],
]);

Actualizar registros de la tabla

Podemos actualiza un registro combinando los métodos whereEq() y update():

// actualizamos el precio y stock del producto 777
DbQuery::table('productos')
    ->whereEq('referencia', '777')
    ->update([
        'precio' => 8,
        'stockfis => 11,
    ]);

Si no aplicamos ningún filtro where, los cambios se aplicarán sobre toda la tabla. Por ejemplo, si queremos marcar todos los productos como públicos, podemos hacer esto:

// marcamos todos los productos como públicos
DbQuery::table('productos')
    ->update([
        'publico' => true,
    ]);

Eliminar registros de la tabla

Si combinamos los métodos whereEq() y delete() podemos eliminar un registro concreto de una tabla:

// eliminamos el producto 777
DbQuery::table('productos')
    ->whereEq('referencia', '777')
    ->delete();

Pero también podemos eliminar todos los registros de una tabla si no aplicamos el filtro where:

// eliminamos todos los productos
DbQuery::table('productos')->delete();