migliorata guida instalazione Docker Sail

README.md

@@ -14,58 +14,78 @@ GASdotto è il gestionale web-based per gruppi di acquisto.
 * non è possibile inoltrare le email usando GMail, a causa delle restrizioni imposte all'autenticazione
 
 # Scarica e Installa
-GASdotto può essere installato localmente o in un container Docker tramite Laravel Sail. 
+GASdotto può essere installato localmente o in un container Docker utilizzando Laravel Sail. 
 
 Per installare GASdotto localmente, segui le istruzioni fornite sul sito ufficiale all'indirizzo [www.gasdotto.net/docs/installazione](https://www.gasdotto.net/docs/installazione).
 
 Se preferisci installarlo in un container Docker, segui i seguenti passaggi.
 
-## Installazione container Docker tramite Laravel Sail
+## Installazione container Docker utilizzando Laravel Sail
 
 ##### Requisiti:
-- php (comprese le estensioni necessarie per far funzionare Laravel)
-
-- composer
 
 - Docker e Docker Compose
 
 ### Installazione 
 
 #### 1. Clona GASdottoNG e naviga nella cartella `<cartella di instaliazione>/GASdottoNG/code/`
-`git clone https://github.com/madbob/GASdottoNG.git && cd GASdottoNG/code/`
+```shell
+git clone https://github.com/madbob/GASdottoNG.git && cd GASdottoNG/code/
+```
 
-#### 2. Installa le dipendenze del progetto dal file *composer.lock*.
-`composer install`
-
-#### 3. Crea il file *.env* e imposta la chiave *APP_KEY*.
-`cp .env.example .env`
-
-`php artisan key:generate`
-
-*Se stai utilizzando Docker, assicurati di aver configurato correttamente le impostazioni nel file .env, seguendo le istruzioni fornite nella sezione 'For Docker' all'interno del medesimo file.*
+#### 2. Installa le dipendenze con Composer tramite Docker
+```shell
+docker run --rm \
+ -u "$(id -u):$(id -g)" \
+ -v "$(pwd):/var/www/html" \
+ -w /var/www/html \
+ laravelsail/php82-composer:latest \
+ composer install --ignore-platform-reqs
+```
+
+#### 3. Crea il file .env e configuralo per Docker
+```shell
+cp .env.example .env
+```
+**Ricordati di configurare le impostazioni Docker nel file .env, abilitando o sostituendo i parametri commentati con quelli di default nella sezione 'For Docker' all'interno dello stesso file.*
 
 #### 4. Avvia i contenitori Docker ed entra nella Terminale all'interno del container del progetto.
-`sail up -d`
-
-`sail shell`
+*Il primo avvio potrebbe richiedere più o meno tempo a seconda delle caratteristiche del tuo computer e della connessione internet.*
+```shell
+sail up -d
+```
+```shell
+sail shell
+```
 
 *Se non hai configurato un alias per `sail`, puoi utilizzare:*
 
-`./vendor/bin/sail up -d`
+```shell
+./vendor/bin/sail up -d
+```
 
-`./vendor/bin/sail shell`
+```shell
+./vendor/bin/sail shell
+```
 
-#### 5. All'interno del container, esegui i comandi per le migrazioni e il popolamento del database.
-`php artisan migrate`
+#### 5. All'interno del container:
+Imposta la chiave APP_KEY
 
-`php artisan db:seed`
+```shell
+php artisan key:generate
+```
+Migrazioni e popolamento del database
 
-`php artisan db:seed --class=FirstInstallSeed`
+```shell
+php artisan migrate && php artisan db:seed && php artisan db:seed --class=FirstInstallSeed
+```
 
 #### 6. Installa i pacchetti npm necessari ed esegui Laravel Mix.
-`npm install`
+```shell
+npm install && npm run development
+```
 
-`npm run development`
+Adesso puoi visitare `localhost` e iniziare a testare e sviluppare.
 
 ### Uscita