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();

Siguiente Pregunta al chatbot

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

Iniciar sesión
PRO
neorazorx_1
neorazorx_1

España, 12 años, nivel 100

Acceso a la base de datos

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
aliksi_1525
ORO
manel_11440
ORO
alexis_8932
ORO
soporte.fs_10883
ORO
oguimera_10015
ORO
plarramendi_322
ORO
finansierra_1770
ORO
ivan_16222
PLATA
rexmaris_12857
PLATA
acaselles_13670
PLATA
jmedina_jwq
PLATA
josepsitja_5023
PLATA
electricidadarnaez_17524
PLATA
misterweb.es_20576
PLATA
listasyboletines_jum
PLATA
venan_k0n
PLATA
zapasoft_1521
PLATA
v.delgado_14821
PLATA
estrategicos_11919
PLATA
darwinfe22_k2i
PLATA
ventas_k3n
PLATA
damien.mathe_13423
PLATA
euskopca_3976
PLATA
appzaragoza_20607
PLATA
carlespont_17495
PLATA
somosinfo_9150
PLATA
espcruzer_13537
BRONCE
reprosturias_20117
BRONCE
11isma_3844
BRONCE
joseluis_23311
BRONCE
alafa.ig_20338
BRONCE
astroradio_9097
BRONCE
magusinformatica_jv4
BRONCE
as-conectas_12070
BRONCE
carlos_23007
BRONCE
antoni.royo_10023
BRONCE
indeconsl_22897
BRONCE
victornc83_9559
BRONCE
fnusmas_5683
BRONCE
ggomez_1388
BRONCE
robertovega1977_jyj
BRONCE
portaltecnologic_12373
BRONCE
programacion_j0v
BRONCE
jmrosarioalonzo_8065
BRONCE
segun2_3065
BRONCE
keepvid24_22052
BRONCE
atimicroson_10546
BRONCE
lfm1278_k6q
PRO
neorazorx_1
PRO
mariano_6807
PRO
carlosmorenogil_16533
PRO
yopli2000_5
PRO
tecnico_jmb
PRO
theprimerate_iip
PRO
blascolanuza_3135
PRO
nathoo_9261
PRO
contacto_8989
PRO
pyasolutions.iberica_19442
PRO
abelcobreros_k3o
PRO
portlanspersonal_12372
PRO
andre_922
PRO
jelou_12077
PRO
gardiesa_1025
PRO
ajcarrillo_2487
PRO
webmaster_k50
PRO
ing.enmanuelc_k4o
PRO
tonomolla6_13281
PRO
giulianosalvan2002_k5p
PRO
lopzapdm_k69
PRO
solarinfinity.jm_18232
PRO
miche41846_k6f
PRO
asier_19731
PRO
victor.pozo_k71
PRO
milton.otavo_11326
PRO
icaweb_22294
PRO
smartcuines_1378
PRO
oscar_k7k
PRO
blowup_k7x
PRO
leo_6608
PRO
sesp.soluciones_20703
PRO
talleresagriauto_12874
PRO
diar_jmg
PRO
pacohm1_2231
PRO
desegnia_2822
PRO
bovedainversion_k8h
PRO
danlopipex_k86
PRO
jorgepinto_20641
PRO
ramon_21184
PRO
kazac.en_12880
PRO
ctrujillo_k9j
PRO
ads.davidsoriano_20064
PRO
creatica_jw2
PRO
rotuloscampano_k9o
PRO
mbartulos_jv8
PRO
luis_9223
PRO
jose_k9x
PRO
vicentem.tic_jjm
PRO
rgbringas_23257
PRO
igor_k9t
PRO
airmanconsulting_12477
PRO
sysadmin_kaa
PRO
equip.progres_18193
PRO
pablo_22810
PRO
acustic_k8d
PRO
gestioncanariasparquets_jrd
PRO
juanmiguel.ortizarandia_k1n
PRO
juliarosell_kas
PRO
morribdm_jz7
PRO
danielherceurzaiz_k0h
PRO
rriveroreina_kb7
PRO
programarilliure_13417
PRO
creativasylaboriosas2013_16937
PRO
ruizrodrii06_kbo
PRO
boxit_kc2
PRO
webmaster_kc0
PRO
webmaster_kc4
PRO
obracivilcordobesa_kce
PRO
javier.nunez_kdd
PRO
villanueva_kc5
PRO
angel.suarez_2568
Patrocinar

Amplíe sus conocimientos con los cursos oficiales

Curso básico de PHP

¡Aprende a programar en PHP de manera fácil y divertida con nuestro curso básico! En este curso, te enseñaremos los conceptos fundamentales de la programación en PHP, incluyendo la sintaxis básica, el manejo de variables, estructuras de control de flujo y mucho más. Al terminar estarás listo para comenzar con el curso de creación de plugins para FacturaScripts.

36 9,99 €
Curso básico de programación

Con este curso aprenderá cómo crear un plugin sencillo para FacturaScripts: 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 o que ya han completado el curso de PHP. ¿Qué incluye? 18 lecciones con 14 vídeos explicativos.

364 9,99 €
Sesiones de programación

Esta es una recopilación de vídeos y documentación de pequeños desarrollos sobre FacturaScripts 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? 22 lecciones con 22 vídeos explicativos (más de 11 horas de vídeos) y el código fuente de los ejemplos.

142 19,99 €
Cookies
Usamos cookies en nuestro sitio web para brindarte la experiencia más relevante recordando tus preferencias y visitas repetidas. Al hacer clic en "Aceptar", aceptas el uso de TODAS las cookies necesarias.
Copyright (c) 2013-2025 FacturaScripts
0.52778s

Soporte