Class: DB_SQL
Source Location: /c_db.inc
Class DB_SQL
Class Overview
|
Interfaccia per la trasformazione da dati-pagina a query e clausole per le condizioni where
Located in /c_db.inc [line 389]
Author(s):
API Tags:
|
Properties
|
Methods
|
Property Summary
| static string |
$sql |
Nome della classe sql - serve per le chiamate parametriche a metodi della stessa classe quando viene estesa |
Method Summary
| static
string
|
begins_like() |
Genera un confronto di inizio simile (LIKE) |
| static
string
|
between() |
Genera una condizione BETWEEN |
| static
string
|
cond() |
Genera una condizione facente parte di una clausola WHERE, con un operatore binario qualunque. Se il valore da confrontare a' NULL, gli operatori = e != sono tradotti in IS e IS NOT, altrimenti viene sollevata un'eccezione |
| static
string
|
cond_tp() |
Versione contratta della op_tp, in cui la condizione viene passata gia' calcolata, senza usare la terna $operatore($campo_filtro, $valore) |
| static
string
|
c_and() |
Genera una condizione AND unendo tutte le sotto-clausole passate come argomento (usa func_get_args) |
| static
string
|
c_not() |
Nega la condizione passata |
| static
string
|
c_or() |
Genera una condizione OR unendo tutte le sotto-clausole passate come argomento (usa func_get_args) |
| static
mixed
|
db_2_ascii() |
Questa serve nel caso in cui i dati debbano arrivare a video ma non in HTML vengono restituite totalmente in chiaro. Vedere GESTORE::valore_ascii |
| static
mixed
|
db_2_fwk() |
Questa serve nel caso in cui i dati non debbano arrivare a video, ma debbano subire manipolazioni intermedie; vengono restituite totalmente in chiaro. Vedere GESTORE::valore_fwk |
| static
mixed
|
db_2_utente() |
Prende un valore in formato database e lo trasforma nel formato utente (quello visualizzato a video). I formati conosciuti sono: d (data), h (ora), r (timestamp), b (booleano), i (intero), f (float), s (stringa uppercase), t (stringa), e (codifica reversibile), c (codifica hash irreversibile) |
| static
string
|
diff() |
Genera un confronto di differenza (!=) |
| static
string
|
ends_like() |
Genera un confronto di fine simile (LIKE) |
| static
string
|
equ() |
Genera un confronto di uguaglianza (=) |
| static
string
|
genera_count() |
Genera una query COUNT su una tabella |
| static
string
|
genera_delete() |
Genera una clausola DELETE su una tabella data un'eventuale condizione |
| static
string
|
genera_exists() |
Genera una query EXISTS su una tabella |
| static
string
|
genera_insert() |
Genera una clausola INSERT su una tabella dati i valori in un array associativo e le eventuali colonne di filtro |
| static
string
|
genera_select() |
Ritorna la query di selezione in base ai parametri specificati |
| static
string
|
genera_update() |
Genera una clausola UPDATE su una tabella dati i valori in un array associativo e le eventuali colonne di filtro |
| static
string
|
gt() |
Genera un confronto di maggioranza (>) |
| static
string
|
gte() |
Genera un confronto di maggioranza o uguaglianza (>=) |
| static
string
|
iequ() |
Genera un confronto di uguaglianza (=) case-insensitive |
| static
string
|
in() |
Genera una condizione IN. Se l'array di valori passato a' vuoto, genera una clausola "dummy" sempre falsa |
| static
string
|
in_tp() |
Genera una clausola IN basata su una subquery. La subquery viene generata come SELECT $campo_ricerca FROM $tabella_ricerca WHERE cond($campo_filtro, $valore), $campo_ricerca deve essere presente anche nella tabella corrente. Es. i_acc_utente_id IN (SELECT i_acc_utente_id FROM t_p_acc_utente_gruppo WHERE i_acc_gruppo_id = 4) |
| static
string
|
like() |
Genera un confronto di similitudine (LIKE) |
| static
string
|
lt() |
Genera un confronto di minoranza (<) |
| static
string
|
lte() |
Genera un confronto di minoranza o uguaglianza (<=) |
| static
string
|
not_in() |
Genera una condizione NOT IN. Se l'array di valori passato a' vuoto, genera una clausola "dummy" sempre vera |
| static
string
|
op_tp() |
Genera una clausola IN basata su una subquery. E' una generalizzazione di in_tp, in cui la ricerca nella subquery e' generalizzata e i campi nella tabella corrente e in $tabella_ricerca non devono essere necessariamente omonimi. |
| static
void
|
set_sql() |
Imposta il nome della classe sql |
| static
mixed
|
utente_2_db() |
Prende un valore in formato utente (quello visualizzato a video) lo trasforma nel formato database |
| static
string
|
word_like() |
Genera un confronto di similitudine (LIKE) su ognuna delle parole (supposte separate da spazi) presenti nel valore specificato |
Properties
Nome della classe sql - serve per le chiamate parametriche a metodi della stessa classe quando viene estesa
API Tags:
Methods
static string begins_like(
string
$colonna, mixed
$valore
)
|
|
Genera un confronto di inizio simile (LIKE)
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore: |
Valore in formato utente |
API Tags:
Redefined in descendants as:
static string between(
string
$colonna, mixed
$valore_inizio, mixed
$valore_fine
)
|
|
Genera una condizione BETWEEN
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore_inizio: |
Valore minimo |
|
mixed |
$valore_fine: |
Valore massimo |
API Tags:
static string cond(
string
$colonna, mixed
$valore, string
$operatore
)
|
|
Genera una condizione facente parte di una clausola WHERE, con un operatore binario qualunque. Se il valore da confrontare a' NULL, gli operatori = e != sono tradotti in IS e IS NOT, altrimenti viene sollevata un'eccezione
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore: |
Valore in formato utente |
|
string |
$operatore: |
Operatore binario di confronto |
API Tags:
static string cond_tp(
string
$tabella_ricerca, string
$campo_ricerca, string
$campo, string
$cond
)
|
|
Versione contratta della op_tp, in cui la condizione viene passata gia' calcolata, senza usare la terna $operatore($campo_filtro, $valore)
Parameters:
|
string |
$tabella_ricerca: |
Tabella in cui la ricerca viene effettuata |
|
string |
$campo_ricerca: |
Nome del campo su cui viene effettuata la ricerca (il campo della tabella corrente viene confrontato con i valori della query su $tabella_ricerca.$campo_ricerca) |
|
string |
$campo: |
Campo della tabella corrente, operando di sinistra della clausola IN |
|
string |
$cond: |
Condizione di filtro su $tabella_ricerca |
API Tags:
Genera una condizione AND unendo tutte le sotto-clausole passate come argomento (usa func_get_args)
API Tags:
static string c_not(
string
$cond
)
|
|
Nega la condizione passata
Parameters:
API Tags:
Genera una condizione OR unendo tutte le sotto-clausole passate come argomento (usa func_get_args)
API Tags:
static mixed db_2_ascii(
string
$colonna, mixed
$valore
)
|
|
Questa serve nel caso in cui i dati debbano arrivare a video ma non in HTML vengono restituite totalmente in chiaro. Vedere GESTORE::valore_ascii
Parameters:
|
string |
$colonna: |
Nome del campo, mi serve per conoscerne il tipo |
|
mixed |
$valore: |
Valore in formato db |
API Tags:
static mixed db_2_fwk(
string
$colonna, mixed
$valore
)
|
|
Questa serve nel caso in cui i dati non debbano arrivare a video, ma debbano subire manipolazioni intermedie; vengono restituite totalmente in chiaro. Vedere GESTORE::valore_fwk
Parameters:
|
string |
$colonna: |
Nome del campo, mi serve per conoscerne il tipo |
|
mixed |
$valore: |
Valore in formato db |
API Tags:
static mixed db_2_utente(
string
$colonna, mixed
$valore
)
|
|
Prende un valore in formato database e lo trasforma nel formato utente (quello visualizzato a video). I formati conosciuti sono: d (data), h (ora), r (timestamp), b (booleano), i (intero), f (float), s (stringa uppercase), t (stringa), e (codifica reversibile), c (codifica hash irreversibile)
Parameters:
|
string |
$colonna: |
Nome del campo, mi serve per conoscerne il tipo |
|
mixed |
$valore: |
Valore in formato db |
API Tags:
Redefined in descendants as:
static string diff(
string
$colonna, mixed
$valore
)
|
|
Genera un confronto di differenza (!=)
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore: |
Valore in formato utente |
API Tags:
static string ends_like(
string
$colonna, mixed
$valore
)
|
|
Genera un confronto di fine simile (LIKE)
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore: |
Valore in formato utente |
API Tags:
Redefined in descendants as:
static string equ(
string
$colonna, mixed
$valore
)
|
|
Genera un confronto di uguaglianza (=)
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore: |
Valore in formato utente |
API Tags:
static string genera_count(
string
$tabella, [string
$condizione = NULL], [mixed
$distinct = FALSE]
)
|
|
Genera una query COUNT su una tabella
Parameters:
|
string |
$tabella: |
Nome della tabella |
|
string |
$condizione: |
Eventuale clausola WHERE |
|
mixed |
$distinct: |
se FALSE a' un count *, se diverso a' il campo di cui fare la distinct |
API Tags:
static string genera_delete(
string
$tabella, [string
$condizione = NULL]
)
|
|
Genera una clausola DELETE su una tabella data un'eventuale condizione
Parameters:
|
string |
$tabella: |
Nome della tabella |
|
string |
$condizione: |
Eventuale clausola WHERE |
API Tags:
static string genera_exists(
string
$tabella, [string
$condizione = NULL]
)
|
|
Genera una query EXISTS su una tabella
Parameters:
|
string |
$tabella: |
Nome della tabella |
|
string |
$condizione: |
Eventuale clausola WHERE |
API Tags:
Redefined in descendants as:
static string genera_insert(
string
$tabella, array
$valori, [array
$colonne_filtro = NULL]
)
|
|
Genera una clausola INSERT su una tabella dati i valori in un array associativo e le eventuali colonne di filtro
Parameters:
|
string |
$tabella: |
Nome della tabella |
|
array |
$valori: |
Array associativo (campo => valore) |
|
array |
$colonne_filtro: |
Se impostato, indica le sole colonne da inserire |
API Tags:
static string genera_select(
$nome_tabella,
$colonne, [string
$condizione = NULL], [string
$ordine = NULL], [string
$distinct = false], [string
$pagina_iniziale = NULL], [string
$dim_pagina = NULL], string
$tabella
)
|
|
Ritorna la query di selezione in base ai parametri specificati
Parameters:
|
string |
$tabella: |
Il nome della tabella di cui caricare l'identita' * @param string $colonne La stringa con in nomi di colonna separati da virgole (come da SQL) |
|
string |
$condizione: |
Il contenuto dell WHERE |
|
string |
$ordine: |
Il contenuto della ORDER BY |
|
string |
$distinct: |
Vero o falso |
|
string |
$pagina_iniziale: |
Il numero di pagina da cui iniziare a visualizzare |
|
string |
$dim_pagina: |
Numero di record da visualizzare |
|
|
$nome_tabella: |
|
|
|
$colonne: |
|
API Tags:
Redefined in descendants as:
static string genera_update(
string
$tabella, array
$valori, [array
$colonne_filtro = NULL], [string
$condizione = NULL]
)
|
|
Genera una clausola UPDATE su una tabella dati i valori in un array associativo e le eventuali colonne di filtro
Parameters:
|
string |
$tabella: |
Nome della tabella |
|
array |
$valori: |
Array associativo (campo => valore) |
|
array |
$colonne_filtro: |
Se impostato, indica le sole colonne da inserire |
|
string |
$condizione: |
Eventuale clausola WHERE |
API Tags:
static string gt(
string
$colonna, mixed
$valore
)
|
|
Genera un confronto di maggioranza (>)
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore: |
Valore in formato utente |
API Tags:
static string gte(
string
$colonna, mixed
$valore
)
|
|
Genera un confronto di maggioranza o uguaglianza (>=)
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore: |
Valore in formato utente |
API Tags:
static string iequ(
string
$colonna, mixed
$valore
)
|
|
Genera un confronto di uguaglianza (=) case-insensitive
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore: |
Valore in formato utente |
API Tags:
Redefined in descendants as:
static string in(
string
$colonna, array
$valori
)
|
|
Genera una condizione IN. Se l'array di valori passato a' vuoto, genera una clausola "dummy" sempre falsa
Parameters:
|
string |
$colonna: |
Nome del campo |
|
array |
$valori: |
Valori di confronto |
API Tags:
static string in_tp(
string
$tabella_ricerca, string
$campo_ricerca, [string
$campo_filtro = NULL], [mixed
$valore = NULL]
)
|
|
Genera una clausola IN basata su una subquery. La subquery viene generata come SELECT $campo_ricerca FROM $tabella_ricerca WHERE cond($campo_filtro, $valore), $campo_ricerca deve essere presente anche nella tabella corrente. Es. i_acc_utente_id IN (SELECT i_acc_utente_id FROM t_p_acc_utente_gruppo WHERE i_acc_gruppo_id = 4)
Parameters:
|
string |
$tabella_ricerca: |
Tabella in cui la ricerca viene effettuata |
|
string |
$campo_ricerca: |
Nome del campo su cui viene effettuata la ricerca (il campo della tabella corrente viene confrontato con i valori della query su $tabella_ricerca.$campo_ricerca) |
|
string |
$campo_filtro: |
Campo su cui viene fatto un filtro nella tabella di ricerca; se NULL, nessuna WHERE condition viene aggiunta |
|
mixed |
$valore: |
Valore ( o array di valori ) su cui viene fatto il filtro; se NULL, nessuna WHERE condition viene aggiunta |
API Tags:
static string like(
string
$colonna, mixed
$valore
)
|
|
Genera un confronto di similitudine (LIKE)
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore: |
Valore in formato utente |
API Tags:
Redefined in descendants as:
static string lt(
string
$colonna, mixed
$valore
)
|
|
Genera un confronto di minoranza (<)
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore: |
Valore in formato utente |
API Tags:
static string lte(
string
$colonna, mixed
$valore
)
|
|
Genera un confronto di minoranza o uguaglianza (<=)
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$valore: |
Valore in formato utente |
API Tags:
static string not_in(
string
$colonna, array
$valori
)
|
|
Genera una condizione NOT IN. Se l'array di valori passato a' vuoto, genera una clausola "dummy" sempre vera
Parameters:
|
string |
$colonna: |
Nome del campo |
|
array |
$valori: |
Valori di confronto |
API Tags:
static string op_tp(
string
$operatore, string
$tabella_ricerca, string
$campo_ricerca, string
$campo_filtro, string
$campo, mixed
$valore
)
|
|
Genera una clausola IN basata su una subquery. E' una generalizzazione di in_tp, in cui la ricerca nella subquery e' generalizzata e i campi nella tabella corrente e in $tabella_ricerca non devono essere necessariamente omonimi.
Parameters:
|
string |
$operatore: |
Operatore di confronto fra $campo_filtro e $valore |
|
string |
$tabella_ricerca: |
Tabella in cui la ricerca viene effettuata |
|
string |
$campo_ricerca: |
Nome del campo su cui viene effettuata la ricerca (il campo della tabella corrente viene confrontato con i valori della query su $tabella_ricerca.$campo_ricerca) |
|
string |
$campo_filtro: |
Campo su cui viene fatto un filtro nella tabella di ricerca |
|
string |
$campo: |
Campo della tabella corrente, operando di sinistra della clausola IN |
|
mixed |
$valore: |
Valore ( o array di valori ) su cui viene fatto il filtro |
API Tags:
static void set_sql(
string
$sql
)
|
|
Imposta il nome della classe sql
Parameters:
API Tags:
static mixed utente_2_db(
string
$colonna, mixed
$valore
)
|
|
Prende un valore in formato utente (quello visualizzato a video) lo trasforma nel formato database
Parameters:
|
string |
$colonna: |
Nome del campo, mi serve per conoscerne il tipo |
|
mixed |
$valore: |
Valore in formato utente |
API Tags:
Redefined in descendants as:
static string word_like(
string
$colonna, mixed
$parole_str
)
|
|
Genera un confronto di similitudine (LIKE) su ognuna delle parole (supposte separate da spazi) presenti nel valore specificato
Parameters:
|
string |
$colonna: |
Nome del campo |
|
mixed |
$parole_str: |
Elenco di parole separate da spazi, in formato utente |
API Tags:
|
|