Questo libro è un passo a passo nello sviluppo di una applicazione real-world utilizzando l’approccio incrementale e iterativo di sviluppo del software.

Si impara di sviluppo software su agile appoggiandosi sulla natura agile del quadro di sviluppo di applicazioni Yii.

Si toccano ogni aspetto del ciclo di sviluppo software mediante la costruzione di un compito applicazione la gestione del progetto, dalla concezione fino al deployment di produzione.

ACQUISTALO SU AMAZON!
Agile Web Application Development with Yii 1.1 and PHP5

Dopo una breve introduzione generale al quadro Yii e definisce l’impostazione dello sviluppo software adottato in tutto il libro, i capitoli abbattere nello stesso modo come iterazioni di sviluppo del software fare a progetti reali.

Dopo la prima iterazione, si avrà una domanda di lavoro e testati con una valida, collegamento testato per un database.

Nelle iterazioni 2a e 3a, abbiamo la nostra carne entità del database principale e oggetto modello di dominio e familiarizzare con gli oggetti Yù-relazionale-mapping (ORM) strato, Active Record.

Abbiamo anche imparare ad appoggiarsi sugli strumenti Yii di auto-generazione per costruire automaticamente la nostra creazione / lettura / aggiornamento / eliminazione (CRUD), la funzionalità contro il nostro modello appena creato.

Queste iterazioni anche concentrarsi su come la validazione dei form Yii e le opere del modello di sottomissione. Entro la fine della terza iterazione si avrà una domanda di lavoro che ti permette di rogna progetti e problemi (compiti) all’interno di tali progetti.

ACQUISTALO SU AMAZON!
Agile Web Application Development with Yii 1.1 and PHP5

In questo articolo vediamo dei modi per creare documenti PDF al volo utilizzando PHP.

Attualmente il formato Pdf (Portable Document Format) è in pratica uno standard, per quanto riguarda i documenti multipiattaforma.
Esistono numerose librerie PHP che permettono la creazione di file PDF e qui cercheremo di analizzarno qualcuna.

FPDF

FPDF è una libreria scritta in php che permette di generare file PDF con puro PHP, vale a dire senza utilizzare la libreria PDFlib. Il suo punto di forza è nella semplicità del suo codice e nella vasta comunità che ha messo a disposizione alcune soluzioni pronte molto utili.

La libreria dispone di un’ampia documentazione in forma di manuale e di tutorial.

La lettera F di FPDF sta per Free infatti la si può utilizzare per qualsiasi tipo di utilizzo e modificarlo in base alle  esigenze.  FPDF ha altri vantaggi, funzioni decisamente di alto livello:

• Scelta dell’unità di misura, il formato pagina e dei margini
• Pagina di intestazione e piè di pagina
• Interruzione di pagina e di Linea automatica
• Giustificazione del testo
• Supporto delle immagini (JPEG e PNG)
• Colori
• Links
• TrueType, Type1 e il supporto di codifica
• Pagina di compressione

FPDF non richiede alcuna estensione (eccetto zlib per attivare la compressione) e lavora con PHP4 e PHP5.

Ulteriori informazioni su FPDF sono disponibili all’indirizzo: fpdf.org/.

Per utilizzare FPDF basta richiamarla da qualsiasi pagina tramite una require()

require('fpdf.php');

A questo punto con poche righe di codice sarà possibile generare i nostri documenti PDF al volo.

Vediamo un esempio :

< ?php
require('fpdf.php');
$pdf =new FPDF();
$pdf -> AddPage();
$pdf -> SetFont('Arial', 'B', 16 );
$pdf -> Cell(40, 10, 'Pdf document' );
$pdf -> Output();
?>

E’ possibile modificare i parametri predefiniti passandoli come argomento alla classe ad esempio:

$pdf=new FPDF('L','cm','A3');

Dove “L” indica il formato con allineamento orrizzontale e “cm” l’unità di misura espressa in centimetri.

Tramite il metodo output(), il documento viene creato e spedito al browser.

TCPDF

Da Fpdf è nata TCPDF è una classe Open Source PHP per la generazione di documenti PDF. Il progetto TCPDF è stato avviato nel 2002 e oggi conta milioni di utilizzatori in tutto il mondo.
TCPDF è un Software Libero e Open Source (FLOSS). Può essere scaricata da SourceForge.

PDFlib

La libreria PDFlib è un’estensione di php che si interfaccia ad API scritte in ANSI C quindi è la libreria più veloce in circolazione.
Inoltre facendo parte di php è anche molto ben documentata.
Tuttavia è poco diffusa poiché richiede interventi sull’installazione di PHP, poichè essendo un’estensione dell’interprete si ha la necessità di ricompilare il php stesso.
Inoltre è distribuita a pagamento con licenze che partono dai 795,00 Euro per server!

Per informazioni si può consultare la pagina ufficiale PDFlib.
Ecco anche per questa libreria un breve esempio per capirne il funzionamento.

< ?
    $pdf = pdf_new();
    pdf_open_file($pdf, "filepdfdiesempio.pdf");
    pdf_begin_page($pdf, 595, 842);
    pdf_show_xy($pdf, "testo da inserire nel nostro file pdf",50, 750);
    pdf_end_page($pdf);
    pdf_close($pdf);
?>

Vediamo alcune delle funzioni usate:

pdf_new() Crea un’istanza dell’oggetto PDF Lib che viene aperta da pdf_open_file().

pdf_begin_page() Imposta il formato della pagina.

pdf_show_xy() è usata per scrivere all’interno del documento pdf da creare.

pdf_end_page() : Chiude il buffer di memoria del file temporaneo

pdf_close() : Distrugge l’oggetto PDF Lib

Yii implementa, il pattern architetturale MVC (Model-View-Controller) .
Ampiampente utilizzato nel web anche da altri grossi framework, è una tecnica di sviluppo di sistemi software che si propone di separare la logica di business da tutto ciò che è interfaccia utente.
In questo modo gli sviluppatori possono lavorare ai vari blocchi in maniera indipendente.
Nell’ MVC, il model rappresenta le informazioni (i dati) e le regole di business cioè il significato dei dati stessi e come i dati devono essere trattati ed elaborati, il View contiene gli elementi dell’interfaccia utente (in un sito si parlerebbe di template o layout) cioè come i dati vengono prsentati , mentre il Controller gestisce la comunicazione tra il model e view.

Oltre ad applicare l’MVC, Yii introduce anche un controller, denominato Application, che racchiude il contesto dell’applicazione ed elabora le richieste.

Dal sito ufficiale di Yii ecco un’immagine che rappresenta la struttura di un applicazione Yii.

Struttura di una applicazione Yii

Sempre dal sito ufficiale ecco il tipico flusso di lavoro dell’applicazione sviluppata tramite Yii.

Flusso di lavoro Yii

• L’utente effettua una richiesta all’URL http://www.mia_app.com/index.php?r=post/show&id=1 e il server Web gestisce la richiesta eseguendo lo script index.php.

• Lo script crea un istanza dell’oggetto Application e lo avvia.
• L’oggetto Application recupera informazioni sulle richieste dell’utente dal componente Request, dell’applicazione.
• L’applicazione determina il Controller e la Action da utilizzare per la richiesta con l’aiuto di un componente denominato urlManager.
• L’applicazione crea un’istanza del controller da utilizzare.
• Successivamente, elaborati i dati tramite il model, viene stabilita la view da utilizzare per presentare i risultati.
• La Action termina la View visualizzando i risultati all’utente

Questo post spiega molto brevemente ed in modo molto semplificato il flusso di lavoro di Yii.

Per una delucidazione generale sul pattern MVC un libro adatto è il seguente : PHP 6. Guida per lo sviluppatore (Linguaggi & programmazione) in cui si discute di PHP 6 di MVC e di programmazione OO.

Yii è un framework Php per lo sviluppo di applicazioni Web 2.0. Si tratta di un Framework abbastanza giovane e si inserisce in un mercato già ricco di alternative, ma ha delle feature interessanti, inoltre è leggero e molto veloce, dalle performance eccezionali. Per questi motivi sta diventando velocemente uno dei Framework più apprezzati.

Yii è basato sul pattern MVC, supporta jQuery e può operare con i database quali SQLite, MySQL, PostgreSQL e Oracle.In questo e nei prossimi post, vedremo come utilizzarlo al meglio per le nostre applicazioni.

Iniziamo dall’installazione e dai settaggi iniziali.

Yii è disponibile gratuitamente all’indirizzo Sito Web ufficiale del Yii Framework .

Tutto il core del Framewrk è contenutio in un file Zip che al suo interno contiene le cartelle

• demos
• framework
• requirements
• altri file (changelog, readme ecc..)

La cartella requirements contiene degli applicativi che verificano i requisiti di sistema del webserver per valutare se è possibile utilizzare Yii.

La cartella Demos contiene delle applicazioni di esempio realizzate con Yii.

La cartella che serve realmente per la realizzazione delle applicazioni è la cartella framework .

Supponiamo di voler realizzare l’applicazione Yiitest.

Nella root del nostro webserver  (se utilizziamo wamp la root sarà c:\wamp\www ) creaiamo una cartella chiamata Yiitest ( nel nostro caso c:\wamp\www\Yiitest ).

All’interno dela cartella della nostra applicazione copiamo la cartella framework vista prima.

Ora ,  andiamo nella cartella c:\wamp\www\Yiitest\framework e digitiamo la riga di comando

yiic webapp c:\wamp\www\Yiitest

Verrà chisto di confermare l’operazione “Create we application under ‘C:\wamp\www\yytest’? [Yes:No]“

Scegliendo Yes verrà creata la struttura di base per la realizzazione della nostra applicazione.

Ora non resta che inserire il nostro codice e continuare con lo sviluppo dell’applicazione.

Soluzione di alcuni problemi

Potrebbe capitare che il sistema non riesca ad eseguire il comando Yii. Questo è dovuto al fatto che probabilmente alcune variabili d’ambiente non sono impostate correttamente.

Sicuremente il problema è nella configurazione della cartelle dove risiede il core per l’utilizzo di PHP.

Quello che dobbiamo fare è aggiungere alla variabile d’ambiente PATH il corretto indirizzo dell’eseguibile PHP.exe

Nei sistemi Windows xp basta andare in

Start -> My Computer -> Advanced Tab -> Environment Variables

e modificare la variabile PATH aggiungendo il percorso mancante .

Nei sistemi Windows 7 basta andare in Pannello di controllo -> Sistema -> Impostazioni di Sistema Avanzate e scegliere V’ariabili d’ambiente.

Il percorso da inserire di solito (se si usa wamp) è del tipo C:\wamp\bin\php\php5.3.0 dove l’ultima cartella dipende dalla versione di Php utilizzata.

Attenzione a non cancellare il contenuto della variabile Path, ma aggiungere in coda preceduto da un “;” il percorso desiderato.

Utilizzare la classe JDatabaseQuery in Joomla 1.6

La struttura del database di Joomla è rimasto pressochè invariato dalla verisone Joomla 1.0 lanciata nel 2005.
Dopo sei anni, era abbastanza prevedibile un refactoring, per risolvere diversi problemi esistenti e per preparare il terreno per i prossimi cinque o sei anni di sviluppo.
Nell’ultima vesrsione Joomla 1.6 ci sono dei cambiamentei nell schema del database e nelle strutture dati che gestiscono lo stesso Db.
In questo e in successivi articoli vedidremo alcune di queste novità e come utilizzarle dal punto di vista dello sviluppo.

Oggi parliamo di JDatabaseQuery.
E’ una nuova classe nata per rispondere alle richieste di un supporto migliore ai motori di database esistenti, e per una maggiore scalabilità del sistema.
Joomla 1.6 introduce appunto una nuova classe utilizzata per la generazione di query che gli sviluppatori possono facoltativamente sfruttare.

Questa classe consente di astrarsi dal database usato.
Si noti inoltre che in PHP è possibile utilizzare il concatenamento e creare query anche molto complesse programmando in un modo molto ordinato e pulito.

Vediamo degli esempi pratici.

Nella versione precedente di Joomla per creare una query si usava

	$db = JFactory::getDbo();
	$db->setQuery(
	 'SELECT *'.
	 ' FROM #__articles'.
	 ' WHERE state = '.(int) $published.
	 '  AND catid = '.(int) $categoryId.
	 ' ORDER BY created DESC'
	);

che crea una query che legge tutti gli articoli della categoria selezionata con lo stato selezionato ordinati in base alla data di creazione descrescente.

	$db = JFactory::getDbo();
	$query = $db->getQuery(true);
	$query->select('*')
	 ->from('#__articles')
	 ->where('state = '.(int) $published)
	 ->where('catid = '.(int) $categoryId)
	 ->order('created DESC');
	$db->setQuery($query);

Vediamo ora un esempio più complesso.

Consideriamo un caso in cui ci sono tre tabelle denominate “__pt_property”, “__pt_building” e “__pt_unit”.
Le chiavi primarie per queste tabelle sono “property_id”, “building_id” e “unit_id”, rispettivamente.
Vogliamo costruire una query che restituisce il numero di unità associate a un property_id.
La tabella __pt_unit non ha relazione diretta con la tabella di __pt_property.
Essa ha una relazione con la tabella __pt_building, che a sua volta ha una relazione con la tabella di proprietà.

	$db =& JFactory::getDBO();
	$query = $db->getQuery(true);
	$query->select('count(*)');
	$query->from('#__pt_building AS b');
	$query->leftJoin('#__pt_unit AS u ON b.building_id = u.building_id');
	$query->where('b.property_id = '. (int) $property_id);
	$db->setQuery($query);

 	select ($columns)
	delete ($table=null)
 	insert ($tables)
 	update ($tables)
 	from ($tables)
 	join ($type, $conditions)
 	innerJoin ($conditions)
 	outerJoin ($conditions)
 	leftJoin ($conditions)
 	rightJoin ($conditions)
 	set ($conditions, $glue=',')
 	where ($conditions, $glue='AND')
 	group ($columns)
 	having ($conditions, $glue='AND')
 	order ($columns)
 	clear ($clause=null)	
 	__toString ()

Ognuno di questi metodi serve per comporre la query.
Si possono richiamare anche in modo non ordinato e alla fine l’oggetto query avrà sempre la medesima stringa sql.

Spesso capita di dover recuperare l’anteprima di un video caricato su youtube.
Ad esempio se si deve creare una gallery video sul proprio sito a anche solo per un singolo video.
L’anteprima del video è l’immaginetta che contiene un frame del video che viene utilizata appunto per illustrare il video prima di mandarlo in play.
L’anteprima o thumbnail viene generata direttamente da youtube che fornisce anche il modo per recuperarla.
In realtà Youtube genera 4 thumbnail differenti.

Uno dei modi per ottenere le miniature di youtube è quello di utiizzare le API fornite dallo stesso Youtube (di cui non tratteremo ora).
La funzione messa a disposizione da youtube è youtube.videos.get_details che tra le altre informazioni fornisce le thumbnail del video in una struttura xml con tag del tipo < thumbnail_url >.
Un’altro modo è reperire la miniatura direttamente dove vengono memorizzate da youtube e cioè all’indirizzo

http://img.youtube.com/vi/VIDEO_ID/NIMAGE.jpg

Questo è il formato dell’ URL delle immaagini cercate.
Al posto di VIDEO_ID è necessario inserire il codice alfanumerico del video che stiamo considerando mentre NIMAGE è il numero dell’immagine da considerare (le immagini vanno da 1 a 4).


Facciamo un esempio .
Consideriamo il seguente video

L’url del video è

http://www.youtube.com/watch?v=iIp7OnHXBlo

l’Id del video è :iIp7OnHXBlo

Le miniature del video sono reperibili a questi indirizzi

http://img.youtube.com/vi/iIp7OnHXBlo/1.jpg
http://img.youtube.com/vi/iIp7OnHXBlo/2.jpg
http://img.youtube.com/vi/iIp7OnHXBlo/3.jpg
http://img.youtube.com/vi/iIp7OnHXBlo/4.jpg

e sono le seguenti :
Prima miniatura : 1.jpg

Seconda miniatura : 2.jpg

Terza miniatura : 3.jpg

Quarta miniatura : 4.jpg

La numero 2 è la miniatura di default o quella che l’autore del video definisce come tale.

Molto spesso in Php si ha la necessità di stampare il valore di una variabile.
E’ una tipica operazione di debug e normalmente è effettuata con la funzione di stampa echo.
L’ambiente Php è un ambiente molto potente ed è possibile creare dei tipi di dati anche complessi.

Se si deve visualizzare a schermo il contenuto di un’array o di un oggetto il metodo base è quello di un loop utilizzando un for, foreach o while per ogni componente dell’array o dell’oggetto.
Esiste però una funzione molto potente che ci permette di evitare questa operazione e visualizzare tutto il contenuto dell’oggetto in un sol colpo :la funzione chiamata print_r().

Ad esempio se si vuole stampare il contenuto di un’oggetto $object basta scrivere

print_r($object);

e l’echo risultante sarà del tipo

stdClass Object ( [ID] => 1 [post_author] => 1 [post_date] => 2000-01-01 00:00:01 [post_content] => This is the content of the message. [post_title] => Message Title [post_excerpt] => This is the excerpt of the message. [post_status] => publish [post_name] => message [post_parent] => 0 [menu_order] => 0 [post_type] => post )

Con una sola riga di codice abbiamo ottentuto un output dettagliato contenente tutti i dati contenuti all’interno dell’object.

Tuttavia, soprattutto per oggetti grandi o complessi l’output risultante è abbastanza confuso e di difficile lettura.
Per risolvere a questo inconveniente ci viene incontro un tag HTML, il pre.

Nel linguaggio HTML gli a capo contenuti nei testi vengono ignorati (per andare su una nuova linea bisogna utilizzare il tag apposito
), quindi la stampa risultante dalla nostra print_r() viene visualizzata tutta sulla stessa linea.

Racchiudendo il nostro ouptut all’interno della tag < pre> (che sta per “pre-formattato”) in questo modo

< pre>
print_r($object);
< /pre>

gli a capo contenuti nell’output verranno letti correttamente, ottenendo quindi un risultato di questo tipo

stdClass Object
(
    [ID] => 1
    [post_author] => 1
    [post_date] => 2001-01-01 00:00:01
    [post_content] => This is the content of the message.
    [post_title] => Message Title
    [post_excerpt] => This is the excerpt of the message.
    [post_status] => publish
    [post_name] => message
    [post_parent] => 0
    [menu_order] => 0
    [post_type] => post
)

Ora l’output è decisamente più chiaro e leggibile: ogni dato è sulla sua riga ed inoltre il risultato è indentato in maniera gerarchica, ottimo!
Lo stesso risultato si può ottenere anche per le funzioni similari come la funzione var_dump() o la funzione var_export().

Se volete potete approfondire l’argomento consultando un buon libro su Php.

A volte può servire creare le thumbnails delle foto che abbiamo caricato sul sito, per crearle on the fly, senza doverle salvare sul disco del server (anche se in molti casi, per non dare lavoro inutile al processore è sicuramente meglio salvarle…).

Possiamo utilizzare il codice che troviamo qui sotto, è sufficiente richiamarlo dal tag <img> utilizzando per la proprietà src una stringa tipo ‘imgres.php?file=nomefileimmagine’, volendo possiamo passare come parametro anche dimensione della thumb da creare…:

< ?php
// il file di cui dobbiamo creare la thumbnail
$file = $_GET['file'];
 
//Questo restringe l'immagine in output al 25% dell'originale
$size = 0.25;
 
// io di solito uso i .jpg, ma si possono utilizzare anche png e gif
header('Content-type: image/jpeg');
 
// setto i parametri per il ridimensionamento
list($width, $height) = getimagesize($file);
$modwidth = $width * $size;
$modheight = $height * $size;
 
// Creo il canvas (la tela)
$tn= imagecreatetruecolor($modwidth, $modheight);
$source = imagecreatefromjpeg($file);
 
// Ridimensiono l'immagine per far sì che combaci con il canvas
imagecopyresized($tn, $source, 0, 0, 0, 0, $modwidth, $modheight, $width, $height);
 
// Butto in output l'immagine creata in formato jpg, volendo si può fare anche in png o gif
imagejpeg($tn);
?>

Nell’elaborazione di tabulati si ha spesso necessità di formattare correttamente i numeri. I problemi che spesso si pongono sono i seguenti:

- troncare i decimali
- usare il divisore italiano virgola per separare i decimali
- usare il divisore italiano punto per dividere le migliaia
- aggiungere degli zeri in testa (fillare a zero a sinistra)

Per eseguire tutte queste operazioni ci vengono in aiuto due funzioni php, la number_format e la sprintf.

Troncare i decimali
Per troncare i decimali é sufficiente passare come secondo parametro della funzione number_format il numero di decimali a cui troncare, così questo esempio tronca al secondo decimale, restituendo 1,234.57, in quanto effettua anche l’arrotondamento:

1

$valore = number_format(1234.5678, 2);

Nel caso si voglia troncare senza effettuare l’arrotondamento occorre usare oportunamente la funzione floor(), moltiplicando (ad esempio per 100 se si vogliono due decimali) e dividendo per lo stesso valore, ad esempio:

1

$valore = floor((1234.5678) * 100) * .01;

E’ chiaro che a sua volta il risultato può essere passato alla number_format().

Usare il divisore italiano virgola per separare i decimali e il divisore punto per le migliaia
Per Usare il divisore italiano virgola per separare i decimali e il divisore punto per le migliaia é sufficiente passare come terzo parametro della funzione number_format il carattere separatore dei decimali (in italiano la virgola) e come quarto parametro il separatore delle migliaia (in italiano il punto). Così questo esempio tronca al secondo decimale e formatta in italiano, restituendo 1.234,57:

1

$valore = number_format(1234.5678, 2, ',', '.');

Chiaramente se non si vuole che venga presentato il divisore delle migliaia é sufficiente togliere il carattere tra gli apici del quarto parametro:

1

$valore = number_format(1234.5678, 2, ',', '');

Aggiungere zeri in testa ad un numero (fillare a zero a sinistra)
Per aggiungere degli zeri in testa ad un numero e quindi fillarlo a zero a sinistra possiamo utilizzare la funzione sprintf. Se, ad esempio, vogliamo avere numeri tutti di 6 cifre fillati con zeri in testa, possiamo fare:

1

$valore = sprintf("%06d", $numeroDaFillare);