Installazione di Nette
**********************

.[perex]
Volete sfruttare i vantaggi di Nette nel vostro progetto esistente, oppure state pensando di creare un nuovo progetto basato su Nette? Questa guida vi accompagna nell'installazione passo passo.


Come aggiungere Nette al vostro progetto
----------------------------------------

Nette offre una raccolta di pacchetti (librerie) utili e ben congegnati per PHP. Per inserirli nel vostro progetto seguite questi passi:

1) **Preparate [Composer|best-practices:composer]:** questo strumento è indispensabile per installare, aggiornare e gestire facilmente le librerie che il vostro progetto richiede.

2) **Scegliete un [pacchetto|www:packages]:** diciamo che avete bisogno di muovervi nel file system, cosa che il [Finder|utils:finder] del pacchetto `nette/utils` fa in modo eccellente. Il nome del pacchetto lo trovate nella colonna destra della sua documentazione.

3) **Installate il pacchetto:** eseguite questo comando nella directory radice del vostro progetto:

```shell
composer require nette/utils
```

Preferite un'interfaccia grafica? Date un'occhiata alla [guida|https://www.jetbrains.com/help/phpstorm/using-the-composer-dependency-manager.html] su come installare i pacchetti nell'ambiente PhpStorm.


Come avviare un nuovo progetto con Nette
----------------------------------------

Se volete creare un progetto completamente nuovo sulla piattaforma Nette, consigliamo di usare lo scheletro preconfigurato [Web Project|https://github.com/nette/web-project]:

1) **Preparate [Composer|best-practices:composer].**

2) **Aprite la riga di comando** e spostatevi nella directory radice del vostro server web, per esempio `/var/www/html`, `C:/xampp/htdocs`, `/Library/WebServer/Documents`.

3) **Create il progetto** con questo comando:

```shell
composer create-project nette/web-project NOME_PROGETTO
```

4) **Non usate Composer?** Basta scaricare il [Web Project in formato ZIP|https://github.com/nette/web-project/archive/preloaded.zip] ed estrarlo. Ma credeteci, Composer ne vale la pena!

5) **Impostate i permessi:** sui sistemi macOS o Linux impostate i [permessi di scrittura |nette:troubleshooting#Impostazione dei permessi delle directory] per le directory.

6) **Aprite il progetto nel browser:** inserite l'URL `http://localhost/NOME_PROGETTO/www/`. Vedrete la pagina iniziale dello scheletro:

[* qs-welcome.webp .{url: http://localhost/PROJECT_NAME/www/} *]

Congratulazioni! Il vostro sito è ora pronto per lo sviluppo. Potete tranquillamente rimuovere il template di benvenuto e cominciare a costruire la vostra applicazione.

Uno dei vantaggi di Nette è che il progetto funziona subito senza bisogno di configurazione. Se però incontrate qualche problema, provate a dare un'occhiata alle [soluzioni dei problemi più comuni |nette:troubleshooting#Nette non funziona, viene mostrata una pagina bianca].

.[note]
Se cominciate con Nette, consigliamo di proseguire con il tutorial [Crea la tua prima applicazione|quickstart:].


Strumenti e consigli
--------------------

Per lavorare in modo efficiente con Nette consigliamo questi strumenti:

- [Un IDE di qualità con i plugin per Nette|tools:ide]
- Il sistema di versionamento Git
- [Composer|best-practices:composer]