Scenario classico: torniamo a casa da Ikea tutti contenti e felici con il nostro nuovo mobiletto da montare. Apriamo la scatola, prendiamo il foglio con le istruzioni, e lì inizia il calvario: figure strane, sinistri ominidi sorridenti, immagini di viti e tasselli che sembrano tutti uguali e, sopratutto, disegni dei vari passaggi che mai rispecchiano la realtà. Ecco, è proprio in questo momento che capiamo una cosa molto importante: l’importanza della documentazione!

Laravel.com

Il primo passo che consigliamo a chi si appresta a scoprire per la prima volta Laravel è, ovviamente, andare sul sito ufficiale, www.laravel.com, e leggere la relativa documentazione che inizia in maniera molto diretta, senza grossi giri di parole, con l’installazione. Già, perché anche se può sembrare un azzardo, non c’è niente di meglio che prendere subito confidenza con il framework piuttosto che leggere pagine e pagine di chiacchiere che, senza un riscontro pratico, rischiano ancora di più di confondere le idee del lettore.

documentazione di laravel

La struttura della documentazione ufficiale

Al momento nel quale vi scriviamo, la documentazione ufficiale di Laravel è composta da 8 macroaree.

Le macroaree della documentazione di Laravel

  • Prologue, dove vengono fornite le indicazioni generali sul framework, come le note di rilascio e la guida per i feedback;

  • Setup, cioè tutto quello che riguarda il primo approccio con la nuova app che vogliamo creare, ossia l’installazione e la configurazione iniziale;

  • Tutorials, una lista di comandi divisa tra livello base e livello intermedio, una sorta di indice di tutte le principali operazioni che possiamo effettuare con il framework;

  • The Basic, l’analisi di tutte le operazioni fondamentali per il funzionamento della nostra app, come le routes, i controllers e le views;

  • Architecture Foundations, le basi dell’architettura di Laravel, divisa per aree concettuali;

  • Services, ossia una serie di elementi che, comunemente, fanno parte di un’applicativo web (invio di email, autenticazione degli utenti, gestione delle sessioni e tanto altro ancora), già integrati nel framework;

  • Database, tutte le operazioni che gestiscono la creazione, gestione e interrogazione del nostro DB;

  • Eloquent ORM, una panoramica esaustiva su come integrare il software con il database grazie al nostro ORM di fiducia.

Laravel API

Vista la sua importanza nello sviluppo di applicativi funzionali, rapidi ed eleganti, Laravel ha deciso di dedicare una documentazione separata a Illuminate, la libreria base del framework. Anch’essa suddivisa in macrocategorie, qui troviamo in maniera molto dettagliata e chiara l’elenco di tutte le funzioni di ogni classe della libreria. Inutile sottolineare l’importanza di questa documentazione che ci permette di avere il pieno possesso su quello che è il motore di Laravel.

Laracast

laracast

Uno dei grandi motivi per cui Laravel è diventato un framework diffusissimo è la comunità che ha attorno. Laracast.com è la pietra principale su cui si basa questa comunità: forum dove chiedere aiuto, Podcast di approfondimenti, newsletter, libri e, sopratutto, una serie di video-tutorial (a pagamento) che spiegano in maniera precisa e pratica come risolvere tantissimi dubbi e problemi che chiunque utilizza Laravel prima o poi incontra. Fondamentali per i neofiti sono, anche, i tutorial per l’installazione di componenti di terze parti, come Socialite. Numerosi video servono anche ad ampliare i nostri orizzonti della programmazione, facendoci conoscere metodologie e approcci che magari non conoscevamo e che renderanno il nostro software migliore, sotto tanti punti di vista.

Laravel, tutto intorno a te

Ci perdoneranno il famoso operatore telefonico e l’importante banca se utilizziamo uno slogan a loro familiare, ma la comunità cresciuta attorno a Laravel è davvero notevole ed è uno dei suoi punti di forza. Oltre a ciò, di cui abbiamo già parlato dettagliatamente, abbiamo anche Forge, grazie al quale si ha sempre sotto controllo la gestione dei propri server (il che facilita molto il deploy dei progetti), e Larajobs, che non crediamo abbia bisogno di tante spiegazioni.