gino CMS  2.5.0
gino è un CMS scritto in PHP che offre tutti gli strumenti necessari per poter creare un sito web e gestire i contenuti al suo interno in maniera semplice ed efficace, svincolando l'amministratore da conoscenze tecniche di programmazione
DbManager Interface Reference

Interfaccia per le librerie di connessione al database. More...

Inheritance diagram for DbManager:

Public Member Functions

 __construct ($params)
 Costruttore. More...
 
 getInfoQuery ()
 Restituisce informazioni sull'esecuzione delle query. More...
 
 openConnection ()
 Apre una connessione al database. More...
 
 closeConnection ()
 Chiude la connessione al database. More...
 
 begin ()
 Istruzione begin. More...
 
 rollback ()
 Istruzione rollback. More...
 
 commit ()
 Istruzione commit. More...
 
 multiActionQuery ($file_content)
 Esegue una o più query concatenate dal punto e virgola. More...
 
 freeresult ($result)
 Libera tutta la memoria utilizzata dal set di risultati. More...
 
 getLastId ($table)
 Valore dell'ultimo ID generato da una colonna Auto Increment a seguito di una istruzione INSERT o UPDATE. More...
 
 autoIncValue ($table)
 Valore di Auto Increment. More...
 
 getFieldFromId ($table, $field, $field_id, $id, $options)
 Ricava il valore di un campo a una data condizione. More...
 
 tableexists ($table)
 Verifica l'esistenza di una tabella. More...
 
 fieldInformations ($table)
 Recupera le informazioni sui campi di una tabella. More...
 
 conformFieldType ($type)
 Uniforma i tipi di dato dei campi. More...
 
 limit ($range, $offset)
 Istruzione per limitare i risultati di una query (LIMIT) More...
 
 distinct ($fields, $options)
 Distinct keyword. More...
 
 concat ($sequence)
 Istruzione per concatenare i campi. More...
 
 dumpDatabase ($file)
 Effettua il dump del database. More...
 
 changeFieldType ($data_type, $value)
 Reimposta il corretto tipo di dato di un campo quando il valore recuperato da una istruzione select è di un tipo non corrispondente (vedi PDO_SQLSRV) More...
 
 getNumRecords ($table, $where, $field, $options)
 Numero di record interessati da una query di selezione. More...
 
 query ($fields, $tables, $where, $options)
 Costruisce una query di selezione. More...
 
 execCustomQuery ($query, $options)
 Esegue una query di selezione passando direttamente la query. More...
 
 select ($fields, $tables, $where, $options)
 Esegue una query di selezione passando i parametri di costruzione della query. More...
 
 insert ($fields, $table, $debug)
 Costruisce ed esegue una query di inserimento. More...
 
 update ($fields, $table, $where, $debug)
 Costruisce ed esegue una query di aggiornamento. More...
 
 delete ($table, $where, $debug)
 Costruisce ed esegue una query di eliminazione. More...
 
 drop ($table)
 Eliminazione di una tabella. More...
 
 columnHasValue ($table, $field, $value, $options=array())
 Controlla che il valore del campo non sia gia presente in tabella. More...
 
 join ($table, $condition, $option)
 Definizione delle Join. More...
 
 union ($queries, $options=array())
 Permette di combinare delle istruzioni SELECT. More...
 
 restore ($table, $filename, $options=array())
 Restore di un file (ad es. More...
 
 dump ($table, $path_to_file, $options=array())
 Dump di una tabella. More...
 
 escapeString ($string)
 Aggiunge le sequenze di escape ai caratteri speciali in una stringa per l'uso in una istruzione SQL, tenendo conto dell'attuale set di caratteri della connessione. More...
 

Detailed Description

Interfaccia per le librerie di connessione al database.

Definisce i metodi che le librerie di connessione al database devono implementare.

Author
marco guidotti guido.nosp@m.ttim.nosp@m.@gmai.nosp@m.l.co.nosp@m.m
abidibo abidi.nosp@m.bo@g.nosp@m.mail..nosp@m.com

Constructor & Destructor Documentation

__construct (   $params)

Costruttore.

Parameters
array$paramsparametri di connessione al db

Implemented in pdo, mysql, and sqlsrv.

Member Function Documentation

autoIncValue (   $table)

Valore di Auto Increment.

Parameters
string$tablenome della tabella
Returns
auto increment

Implemented in pdo, mysql, sqlsrv, pdo_mysql, and pdo_sqlsrv.

begin ( )

Istruzione begin.

Returns
bool, risultato istruzione

Implemented in pdo, mysql, and sqlsrv.

changeFieldType (   $data_type,
  $value 
)

Reimposta il corretto tipo di dato di un campo quando il valore recuperato da una istruzione select è di un tipo non corrispondente (vedi PDO_SQLSRV)

Parameters
string$data_typetipo di dato come definito da Gino.Model::dataType()
mixed$valuevalore del campo di un record (Gino.Model::$_p)
Returns
mixed

Implemented in pdo, sqlsrv, mysql, and pdo_sqlsrv.

closeConnection ( )

Chiude la connessione al database.

Returns
void

Implemented in pdo, mysql, and sqlsrv.

columnHasValue (   $table,
  $field,
  $value,
  $options = array() 
)

Controlla che il valore del campo non sia gia presente in tabella.

Parameters
string$tablenome della tabella
string$fieldcampo da cercare
string$valuevalore da confrontare
array$optionsarray associativo di opzioni
  • except_id (integer): valore ID del record per il quale non effettuare il controllo
Returns
TRUE se presente, FALSE altrimenti

Implemented in pdo, sqlsrv, and mysql.

commit ( )

Istruzione commit.

Returns
bool risultato istruzione

Implemented in pdo, mysql, and sqlsrv.

concat (   $sequence)

Istruzione per concatenare i campi.

Esempi:

$this->_db->concat(array("label", "' ('", "server", "')'"));
$this->_db->concat(array("lastname", "' '", "firstname"))
Parameters
mixed$sequenceelenco di campi da concatenare
Returns
CONCAT statement

Implemented in pdo, sqlsrv, mysql, pdo_mysql, and pdo_sqlsrv.

conformFieldType (   $type)

Uniforma i tipi di dato dei campi.

Elenco dei tipi di dato validi nella definizione di un campo

  • char, input form
  • text, textarea form
  • int, input form (se length>1) o radio button (length=1)
  • bool, radio button
  • date, input form di tipo data
Parameters
mixed$typetipo di dato come definito dalle singole librerie
Returns
string (char|text|int|bool|date)

Implemented in pdo, sqlsrv, mysql, pdo_sqlsrv, and pdo_mysql.

delete (   $table,
  $where,
  $debug 
)

Costruisce ed esegue una query di eliminazione.

Parameters
string$tablenome della tabella
string$wherecondizione della query
boolean$debugse vero stampa a video la query
Returns
risultato operazione, bool

Implemented in pdo, sqlsrv, and mysql.

distinct (   $fields,
  $options 
)

Distinct keyword.

Parameters
string$fieldsnome/nomi dei campi separati da virgola
array$optionsarray associativo di opzioni
  • alias (string): nome dell'alias del distinct
  • remove_table (boolean): rimuove il nome della tabella dalla definizione del campo
Returns
DISTINCT statement

Implemented in pdo, sqlsrv, mysql, pdo_mysql, and pdo_sqlsrv.

drop (   $table)

Eliminazione di una tabella.

Parameters
string$tablenome della tabella
Returns
risultato dell'operazione, bool

Implemented in pdo, sqlsrv, and mysql.

dump (   $table,
  $path_to_file,
  $options = array() 
)

Dump di una tabella.

Parameters
string$tablenome della tabella
string$path_to_filenome del file completo di percorso
array$optionsarray associativo di opzioni
  • where (string): condizioni della query
  • delim (string): stringa che viene usata per separare tra loro i valori dei campi
  • enclosed (string): carattere utilizzato per racchiudere i valori di tipo stringa
Returns
stringa (nome del file di dump)

Implemented in pdo, sqlsrv, and mysql.

dumpDatabase (   $file)

Effettua il dump del database.

Parameters
string$filepercorso completo del file da scrivere
Returns
risultato operazione, bool

Implemented in pdo, sqlsrv, mysql, pdo_sqlsrv, and pdo_mysql.

escapeString (   $string)

Aggiunge le sequenze di escape ai caratteri speciali in una stringa per l'uso in una istruzione SQL, tenendo conto dell'attuale set di caratteri della connessione.

Parameters
mixed$string
Returns
stringa

Implemented in pdo, sqlsrv, and mysql.

execCustomQuery (   $query,
  $options 
)

Esegue una query di selezione passando direttamente la query.

Parameters
string$queryistruzione sql da eeguire
array$optionsarray associativo di opzioni
  • statement (string): tipologia di query
    • select (default)
    • action
  • opzioni del metodo select()
Returns
array (select statement) or boolean

Implemented in pdo, sqlsrv, and mysql.

fieldInformations (   $table)

Recupera le informazioni sui campi di una tabella.

Utilizzato dalla classe Gino.Options per costruire il form delle opzioni di una classe.

Parameters
string$tablenome della tabella
Returns
informazioni in array

Implemented in pdo, sqlsrv, and mysql.

freeresult (   $result)

Libera tutta la memoria utilizzata dal set di risultati.

Parameters
array$resultrisultato della query
Returns
bool, risultato

Implemented in pdo, sqlsrv, and mysql.

getFieldFromId (   $table,
  $field,
  $field_id,
  $id,
  $options 
)

Ricava il valore di un campo a una data condizione.

Parameters
string$tablenome della tabella
string$fieldnome del campo del quale occorre ricavare il valore
string$field_idnome del campo condizione (where)
mixed$idvalore del campo condizione (where)
array$options
Returns
valore del campo

Implemented in pdo, mysql, and sqlsrv.

getInfoQuery ( )

Restituisce informazioni sull'esecuzione delle query.

Returns
informazioni

Implemented in pdo, mysql, and sqlsrv.

getLastId (   $table)

Valore dell'ultimo ID generato da una colonna Auto Increment a seguito di una istruzione INSERT o UPDATE.

Parameters
string$tablenome della tabella
Returns
ultimo id generato

Implemented in pdo, sqlsrv, and mysql.

getNumRecords (   $table,
  $where,
  $field,
  $options 
)

Numero di record interessati da una query di selezione.

Parameters
string$tablenome della tabella
string$wherecondizione della query
string$fieldnome del campo di selezione per il conteggio dei record
array$optionsopzioni del metodo select()
Returns
numero di record

Implemented in pdo, sqlsrv, and mysql.

insert (   $fields,
  $table,
  $debug 
)

Costruisce ed esegue una query di inserimento.

Parameters
array$fieldselenco dei campi con i loro valori; se il valore di un campo è un array, con la chiave sql è possibile passare una istruzione SQL
  • array(field1=>value1, field2=>value2), esempio:
    array('name'=>$name, 'description'=>$description, 'room'=>$room)
  • array(field1=>array('sql'=>sql_command), field2=>value2), esempio:
    array('label'=>$label, 'orderList'=>array('sql'=>"orderList-1"))
string$tablenome della tabella
boolean$debugse vero stampa a video la query
Returns
risultato operazione, bool

Implemented in pdo, sqlsrv, and mysql.

join (   $table,
  $condition,
  $option 
)

Definizione delle Join.

Parameters
string$tablenome della tabella
string$conditioncondizione della join
string$optionopzione della join
  • left
  • right
  • outer
  • inner
  • left outer
  • right outer
Returns
join clause

Implemented in pdo, sqlsrv, and mysql.

limit (   $range,
  $offset 
)

Istruzione per limitare i risultati di una query (LIMIT)

Esempio

$this->_db->limit(1, 0);
Parameters
integer$rangenumero di elementi da mostrare
integer$offsetrecord di partenza (key)
Returns
LIMIT condition

Implemented in pdo, sqlsrv, mysql, pdo_mysql, and pdo_sqlsrv.

multiActionQuery (   $file_content)

Esegue una o più query concatenate dal punto e virgola.

Il metodo viene utilizzato per l'installazione dei pacchetti.

Parameters
string$file_contentcontenuto del file sql
Returns
bool, risultato

Implemented in pdo, mysql, sqlsrv, pdo_mysql, and pdo_sqlsrv.

openConnection ( )

Apre una connessione al database.

Returns
TRUE in caso di successo, genera un eccezione altrimenti

Implemented in mysql, and sqlsrv.

query (   $fields,
  $tables,
  $where,
  $options 
)

Costruisce una query di selezione.

Parameters
mixed$fieldselenco dei campi
mixed$tableselenco delle tabelle
string$wherecondizione della query
array$optionsarray associativo di opzioni
  • order (string): ordinamento
  • group_by (string): elenco dei campi da raggruppare (istruzione GROUP BY)
  • distinct (string): nome/nomi dei campi sui quali applicare la keyword DISTINCT
  • limit (mixed): limitazione degli elementi
    • string, condizione di limitazione degli elementi
    • array, valori per il range di limitazione (array(offset, range))
  • debug (boolean): se vero stampa a video la query
Returns
query

Implemented in pdo, sqlsrv, and mysql.

restore (   $table,
  $filename,
  $options = array() 
)

Restore di un file (ad es.

di un backup)

Parameters
string$tablenome della tabella
string$filenamenome del file da importare
array$optionsarray associativo di opzioni
  • fields (array): nomi dei campi
  • delim (string): stringa che viene usata per separare tra loro i valori dei campi
  • enclosed (string): stringa utilizzata per racchiudere i valori di tipo stringa
  • escaped (string): carattere di escape, cioè quello utilizzato prima dei caratteri speciali
  • lineend (string): stringa utilizzata come separatore tra i record
  • hasheader (boolean): indica se il file comincia con una riga contenente i nomi dei campi
Returns
risultato dell'operazione, bool

Implemented in pdo, sqlsrv, mysql, pdo_sqlsrv, and pdo_mysql.

rollback ( )

Istruzione rollback.

Returns
bool, risultato istruzione

Implemented in pdo, mysql, and sqlsrv.

select (   $fields,
  $tables,
  $where,
  $options 
)

Esegue una query di selezione passando i parametri di costruzione della query.

See also
query()
Parameters
mixed$fieldselenco dei campi
mixed$tableselenco delle tabelle
string$wherecondizione della query
array$optionsarray associativo di opzioni
  • custom_query (string): query completa
  • cache (boolean): indica se salvare in cache (se abilitata) i risultati della query (default true)
  • identity_keyword (string): codice identificativo dei dati in cache
  • time_caching (integer): tempo di durata della cache
  • opzioni del metodo query()
Returns
array di risultati

Implemented in pdo, sqlsrv, and mysql.

tableexists (   $table)

Verifica l'esistenza di una tabella.

Parameters
string$tablenome della tabella
Returns
bool

Implemented in pdo, mysql, sqlsrv, pdo_mysql, and pdo_sqlsrv.

union (   $queries,
  $options = array() 
)

Permette di combinare delle istruzioni SELECT.

Le regole di base per la combinazione dei set di risultati di più query tramite l'istruzione UNION:

  • Tutte le query devono includere lo stesso numero di colonne nello stesso ordine.
  • I tipi di dati devono essere compatibili.
See also
select()
Parameters
array$queriesquery da unire (viene seguito l'ordine nell'array)
array$optionsarray associativo di opzioni
  • debug (boolean): se vero stampa a video la query
  • instruction (string): istruzione (default UNION)
  • cache (boolean): indica se salvare in cache (se abilitata) i risultati della query (default true)
Returns
array di risultati

Implemented in pdo, sqlsrv, and mysql.

update (   $fields,
  $table,
  $where,
  $debug 
)

Costruisce ed esegue una query di aggiornamento.

Parameters
array$fieldselenco dei campi con i loro valori; se il valore di un campo è un array, con la chiave sql è possibile passare una istruzione SQL
  • array(field1=>value1, field2=>value2), esempio:
    array('name'=>$name, 'description'=>$description, 'room'=>$room)
  • array(field1=>array('sql'=>sql_command), field2=>value2), esempio:
    array('label'=>$label, 'orderList'=>array('sql'=>"orderList-1"))
string$tablenome della tabella
string$wherecondizione della query
boolean$debugse vero stampa a video la query
Returns
risultato operazione, bool

Implemented in pdo, sqlsrv, and mysql.


The documentation for this interface was generated from the following file: