EuroPronostici: Sviluppo di un portale per gioco a pronostici realizzato in PHP con il framework Humus

Il framework Humus è basato sul paradigma MVC (Model-View-Controller) e mette a disposizione dello sviluppatore una serie di strumenti atti all’utilizzo di questo stesso paradigma.
All’interno della cartella “bin” del framework, possiamo infatti trovare l’implementazione di varie classi che vanno a definire il comportamento del routing, dell’ORM, della sessione e dei modelli, oltre che della cache e del loader delle varie librerie.
In aggiunta alla gestione custom delle librerie presente nella versione originale del framework, per questo progetto mi sono occupato di aggiungere la compatibilità con il più diffuso sistema composer⁴ che consente di installare librerie da riga di comando e di mantenere, tramite l’utilizzo dell’apposito file composer.json un versionamento stabile e sicuramente compatibile delle stesse. La gestione originale di Humus delle librerie è quindi deprecata in favore di questo sistema più moderno e stabile.

Il framework inoltre vuole che la cartella del progetto (situata allo stesso livello della cartella “humus”, contenente il framework stesso) contenga una struttura di cartelle così definita:
• Cartella progetto
⁃ cache – Va a contenere eventuali file temporanei di elaborazione dati
⁃ errors – Contiene le pagine di errore personalizzate per i vari errori http (per esempio 404.php)
⁃ extensions – Contiene alcune estensioni di base per l’utilizzo di sistema, come ad esempio la gestione della sessione/login, una classe di utilità varie e la gestione del multilingua
▪ langs – Contiene i vari file di linguaddio con le relative traduzioni (per esempio ita.php e eng.php)
⁃ library – Contiene file di libreria utili al front-end, come ad esempio le librerie jQuery⁵, Bootstrap⁶, FontAwesome⁷ e moment.js⁸
⁃ views – Contiene le varie view a disposizione del front-end e relativi file utili alla presentazione del front-end stesso
▪ actions – Contiene file .php da utilizzare nel caso in cui si decida di utilizzare il framework per realizzare applicazioni in stile One Page Application, che Humus implementa tramite l’ausilio della libreria taconite⁹
▪ json – Contiene file .php che generano in risposta stringhe di tipo json, utili nel caso di richieste ajax (si pensi ad esempio al voler aggiornare una tendina con i comuni quando si seleziona una provincia), o nel caso si voglia implementare una api RESTful
▪ pages – Contiene le vere e proprie pagine da visualizzare a front-end. È possibile usare la tecnica del server-side rendering nativa di PHP o utilizzare librerie di templating più avanzate come per esempio mustache¹⁰, semplicemente installandole tramite composer.
▪ script – Contiene file .js personalizzati da utilizzare a front-end
▪ themes – Contiene i file css e altri assets come per esempio i font, le immagini o template html.

• models – Contiene i file .php che definiscono i modelli degli oggetti che verranno utilizzati nel progetto, descritti in modo tale da essere leggibili dal motore ORM messo a disposizione dal framework

La cartella di progetto può essere nominata in qualunque modo l’utente desideri, riportando il nome della stessa nell’apposito file di configurazione del framework.


_{4 https://getcomposer.org/
5 https://jquery.com/
6 https://getbootstrap.com/
7 https://fontawesome.com/
8 https://momentjs.com/
9 https://taconite.sourceforge.net/
10 https://packagist.org/packages/mustache/mustache}