Costruire un’applicazione reale con Zend Framework ( parte 6 )

Di admin in Php, Zend Framework Controls: +-close

Gestione del database

Ritorniamo sull’argomento modelli iniziato qualche articolo fa, in questo articolo tratteremo come recuperare i dati dal database con Zend Framework. Una volta creato l’oggetto $db tramite chiamata al metodo statico factory, potremo procedere in diversi modi.

Effettuare una query

Tramitel’utilizzo del metodo ‘query’ potremo eseguire direttamente la query da noi specificata sul database, ad esempio:

$data = $db->quote('1990-01-01');
$sql = 'SELECT * FROM utenti WHERE data_di_nascita > ' . $date;
$result = $db->query($sql);

Nel codice precedente abbiamo utilizzato il metodo ‘quote’ che effettua per noi l’inserimento degli apici in modo da creare una query corretta ed esente da pericoli di SqlInjections.
Tuttavia potrebbe capitare di dimenticare di usare quote quindi l’ideale potrebbe essere utilizzare il seguente metodo per scrivere una query corretta e sicura:

$sql = 'SELECT * FROM utenti WHERE data_di_nascita > ?'
$result = $db->query($sql, array('1990-01-01'));

In ogni caso, il $result sarà un oggetto su cui potremo effettuare le chiamate dei metodi fetch() e fetchAll() per il recupero dei dati.

Zend_Db_Select

Zend_Db_Select è un oggetto che ci viene in aiuto per costruire delle query per la selezione di dati utilizzando maggiormente il linguaggio php piuttosto che SQL. Prendendo in considerazione l’esempio precedente, il codice qui di seguito mostra come ottenere lo stesso risultato utilizzando questa classe:

$select = new Zend_Db_Select($db);
$select->from('utenti');
$select->where('data_di_nascita > ?', '1990-01-01');
$result = $select->query();

Inserimento, Modifica ed Eliminazione dei dati con Zend_Db_Adapter

Per effettuare queste operazioni, la classe Zend_Db_Adapter ci offre i metodi insert(), update() e delete() rispettivamente. Il loro utilizzo è decisamente semplice, creare un array associatico con chiave il nome del campo della nostra tabella e come valore appunto il valore che dovrà avere questo campo, e passarlo ai vari metodi sopra citati nei seguenti modi:

inserimento

  $data = array(,
    'nome' => 'Mark',
    'cognome' => 'Hollis',
    'inserimento_data' => date('Y-m-d')
  ); 

  $table = 'utenti';
  $rows_affected = $db->insert($table, $data);
  $last_insert_id = $db->lastInsertId();

modifica

  $data = array(,
    'paese' => 'United Kingdom'
  ); 

  $table = 'utenti';
  $where = $db->quoteInto('country = ?', 'UK');
  $db->update($table, $data, $where);

elimina

  $table = 'utenti';
  $where = 'id = 2';
  $rows_affected = $db->delete($table, $where);

Inserimento, Modifica ed Eliminazione dei dati con Zend_Db_Table

Un’interessante metodo per la gestione del database ci viene offerto dalla classe Zend_Db_Table. Questa classe gestisce ogni tabella del database come se fosse un oggetto. Prima di cominciare con gli esempi aggiungiamo una nuova tabella al nostro database

CREATE TABLE `utenti` (
  `id` int(11) NOT NULL auto_increment,
  `username` varchar(99) NOT NULL,
  `password` varchar(32) NOT NULL,
  `nome` varchar(99) NOT NULL,
  `cognome` varchar(99) NOT NULL,
  `sesso` enum('M','F') default NULL,
  `data_di_nascita` datetime NOT NULL,
  `paese` varchar(99) default NULL,
  `cap` varchar(20) NOT NULL,
  `inserimento_data` datetime NOT NULL,
  `inserimento_user_id` int(11) NOT NULL,
  `inserimento_ip` varchar(15) NOT NULL,
  `modifica_data` timestamp NULL default NULL on update CURRENT_TIMESTAMP,
  `modifica_user_id` int(11) default NULL,
  `modifica_ip` varchar(15) default NULL,
  PRIMARY KEY  (`id`)
) ENGINE=InnoDB  DEFAULT CHARSET=latin1 AUTO_INCREMENT=2 ;

INSERT INTO `utenti` (`id`, `username`, `password`, `nome`, `cognome`, `sesso`, `data_di_nascita`, `paese`, `cap`, `inserimento_data`, `inserimento_user_id`, `inserimento_ip`, `modifica_data`, `modifica_user_id`, `modifica_ip`) VALUES
(1, 'Razorblade', '0c88028bf3aa6a6a143ed846f2be1ea4', 'Sergio', 'Rinaudo', 'M', '1982-03-26 20:56:22', NULL, '10023', '2008-08-16 20:56:51', 1, '127.0.0.1', '2008-08-16 20:57:01', NULL, NULL);

Abbiamo dunque creato la tabella utenti, quindi possiamo procedere alla creazione della relativa classe. Questo nuovo file andrà salvato nella directory models

Utenti.php

<?php

  class Utenti extends Zend_Db_Table_Abstract
  {
    protected $_name = 'utenti';
    protected $_rowClass = 'Utente';
    protected $_dependentTables = array('Recensioni');
  }

In quanto Utenti estende Zend_Db_Table_Abstract come potete immaginare ne eredita i vari metodi e proprietà. Prima di procedere alla spiegazione di cosa siano le proprietà presenti all’interno della classe Utenti diamo uno sguardo su come effettuare le medesime operazioni di inserimento, modifica e update utilizzando Zend_Db_Table_Abstract

inserimento

  $utenti = new Utenti(); 

  $data = array(,
    'nome' => 'Mark',
    'cognome' => 'Hollis',
    'inserimento_data' => date('Y-m-d')
  ); 

  $id = $utenti->insert($data);

modifica

  $utenti = new Utenti(); 

  $data = array(,
    'paese' => 'United Kingdom'
  ); 

  $where = $db->quoteInto('country = ?', 'UK');
  $utenti->update($data, $where);

elimina

  $utenti = new Utenti(); 

  $where = 'id = 2';
  $utenti->delete($where);

Creazione dei nuovi modelli per l’applicazione

Prima di listare il codice delle classi delle altre tabelle del nostro database, ovvero recensioni e paesi, dobbiamo fare una precisazione sui livelli di accesso al database, che possono essere di due tipi: tabella e riga. Il primo livello di accesso è utlizzato quando dobbiamo creare dei listati di record, il secondo livello è utilizzato quando abbiamo a che fare con un singolo record della tabella.

Lavorando al secondo livello di accesso è inoltre possibile utilizzare il metodo save() in sostituzione di insert e update, il codice per effettuare entrambe le operazioni è molto simile:

inserimento

  $utenti = new Utenti();
  $riga = $utenti->fetchNew(); 

  $riga->nome = 'Mark';
  $riga->cognome = 'Hollis'; 

  $riga->save();

modifica

  $utenti = new Utenti();
  $riga = $utenti->fetchRow('id=2'); 

  $riga->nome = 'Mark';
  $riga->cognome = 'Hollis'; 

  $riga->save();

La classe Utenti da noi creata poco sopra agisce a livello di tabella. Al suo interno si trova una proprietà, $_rowClass, che indica il nome della classe per la gestione del secondo livello di accesso, ovvero Utente. Il seguente è il codice che ha attualmente Utente:

<?php

  class Utente extends Zend_Db_Table_Row_Abstract
  {
    public function name(){
      $name = trim($this->nome . ' ' . $this->cognome);
      if (empty($name)) {
        $name = $this->username;
      }
      return $name;
    }

    function __get($key)
    {
      if(method_exists($this, $key)){
        return $this->$key();
      }
      return parent::__get($key);
    }
  }

Come avrete sicuramente notato, il primo livello di accesso è gestito dalla classe Zend_Db_Table_Abstract mentre il secondo è gestito da Zend_Db_Table_Row_Abstract . Nella classe Utente abbiamo inserito due metodi, il primo serve a ricavare il nome dell’utente selezionato, il secondo è un metodo magico ( presto disponibile un articolo sui metodi magici su questo blog, fino ad allora vi consiglio una ricerca su google per saperne di più ) che ci da la possibilità di richiamare il metodo name come se fosse una proprietà ( omettendo le parentesi ).

Di seguito trovate il codice attuale delle classi Paesi e Recensioni, da inserire all’interno della directory models, assieme ad Utenti e Utente

Paesi

<?php

  class Paesi extends Zend_Db_Table
  {
    protected $_name = 'paesi';
    protected $_dependentTables = array('Recensioni');

    function fetchLatest($count = 10){
      return $this->fetchAll(null,'inserimento_data DESC', $count);
    }
  }

Recensioni

<?php 

  class Recensioni extends Zend_Db_Table_Abstract
  {
    protected $_name = 'recensioni';
    protected $_referenceMap = array(
      'Paesi' => array(
        'columns'           => array('id_paese'),
        'refTableClass'     => 'Paesi',
        'refColumns'        => array('id')
      ),
      'Utenti' => array(
        'columns'           => array('id_utente'),
        'refTableClass'     => 'Utenti',
        'refColumns'        => array('id')
      ) ,
      'Abilitazione' => array(
        'columns'           => array('id_utente_abilitazione'),
        'refTableClass'     => 'Utenti',
        'refColumns'        => array('id')
      )
    );
  }

Nel prossimo articolo continueremo il discorso sui modelli, spiegando nel dettaglio a cosa servono le proprietà $_referenceMap e $_dependentTables ed effettueremo dei test di visualizzazione.