Installazione e Test

Installazione (Vagrant/Homestead Improved)

Per questa procedura consiglio l'uso di Homestead Improved, un'ottima versione modificata di Laravel Homestead ancora più semplice da usare di quella "classica".

Clona nella cartella del progetto (generalmente "Project") il repository.

A questo punto, scegli un indirizzo ip per la macchina virtuale ed inseriscilo in Homestead.yaml, e modifica il valore del primo elemento in sites:

ip: "192.168.4.4"

...

sites:
    - map: laravel-italia.dev
      to: /home/vagrant/Code/Project/public

databases:
    - homestead
    - homestead_testing

Nota: il database homestead viene usato per lo sviluppo, homestead_testing per far girare i test. Assicurati che entrambi siano presenti.

Dopo aver avviato la macchina ed effettuato l'accesso al suo interno via SSH (con vagrant ssh), da linea di comando esegui...

tools/install

ed aspetta qualche minuto. Questo tool da linea di comando preparerà tutto l'ambiente di sviluppo ed installerà le dipendenze necessarie, con Composer ed NPM. Infine, eseguirà gulp per compilare gli asset da usare nel frontend del sito.

Et voilà! La tua copia in locale di Laravel-Italia è pronta per essere usata.

Testing

Il progetto conta svariati test per verificare che tutto funzioni correttamente. Al momento sono disponibili degli unit test dei singoli componenti ed alcuni integration test. Per avviarli, usa i seguenti comandi:

$ phpunit # avvia tutti i test
$ phpunit --testsuite="Unit" # avvia gli unit test
$ phpunit --testsuite="Integration" # avvia gli integration test

In futuro non mi dispiacerebbe creare qualche test sull'interfaccia, per assicurarmi di volta in volta che le nuove aggiunte non vadano a rompere ciò che già esiste. Aggiornerò questa pagina in caso di sviluppi.