Installation de Nette
*********************

.[perex]
Vous souhaitez exploiter les avantages de Nette dans votre projet existant ou vous envisagez de créer un nouveau projet basé sur Nette ? Ce guide vous guidera pas à pas dans l'installation.


Comment ajouter Nette à votre projet .[#toc-how-to-add-nette-to-your-project]
-----------------------------------------------------------------------------

Nette propose une collection de packages (bibliothèques) utiles et sophistiqués pour PHP. Pour les intégrer à votre projet, suivez les étapes suivantes :

1) **Cet outil [Composer|best-practices:composer]:** est essentiel pour faciliter l'installation, la mise à jour et la gestion des bibliothèques nécessaires à votre projet.

2) **Choisir un [paquetage |www:packages]:** Supposons que vous ayez besoin de naviguer dans le système de fichiers, ce que [Finder |utils:finder] du paquetage `nette/utils` fait à merveille. Vous trouverez le nom du paquet dans la colonne de droite de sa documentation.

3) **Installer le paquetage:** Exécutez cette commande dans le répertoire racine de votre projet :

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

Vous préférez une interface graphique ? Consultez le [guide d' |https://www.jetbrains.com/help/phpstorm/using-the-composer-dependency-manager.html] installation des paquets dans l'environnement PhpStorm.


Comment démarrer un nouveau projet avec Nette .[#toc-how-to-start-a-new-project-with-nette]
-------------------------------------------------------------------------------------------

Si vous souhaitez créer un tout nouveau projet sur la plateforme Nette, nous vous recommandons d'utiliser le squelette prédéfini de [projet Web |https://github.com/nette/web-project]:

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

2) **Ouvrez la ligne de commande** et naviguez jusqu'au répertoire racine de votre serveur web, par exemple, `/etc/var/www`, `C:/xampp/htdocs`, `/Library/WebServer/Documents`.

3) **Créez le projet** à l'aide de cette commande :

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

4) **Ne pas utiliser Composer?** Téléchargez simplement le [projet Web au format ZIP |https://github.com/nette/web-project/archive/preloaded.zip] et extrayez-le. Mais croyez-nous, Composer en vaut la peine !

5) **Définir les permissions:** Sur les systèmes macOS ou Linux, définissez les [permissions d'écriture |nette:troubleshooting#Setting directory permissions] pour les répertoires.

6) **Ouvrir le projet dans un navigateur:** Entrez l'URL `http://localhost/PROJECT_NAME/www/`. Vous verrez la page d'accueil du squelette :

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

Félicitations ! Votre site web est maintenant prêt à être développé. N'hésitez pas à supprimer le modèle de bienvenue et à commencer à construire votre application.

L'un des avantages de Nette est que le projet fonctionne immédiatement sans nécessiter de configuration. Toutefois, si vous rencontrez des problèmes, pensez à consulter les [solutions aux problèmes courants |nette:troubleshooting#nette-is-not-working-white-page-is-displayed].

.[note]
Si vous débutez avec Nette, nous vous recommandons de poursuivre avec le [tutoriel Créer votre première application |quickstart:].


Outils et recommandations .[#toc-tools-and-recommendations]
-----------------------------------------------------------

Pour un travail efficace avec Nette, nous recommandons les outils suivants :

- [IDE de haute qualité avec des plugins pour Nette |best-practices:editors-and-tools]
- Système de contrôle de version Git
- [Compositeur |best-practices:composer]


{{leftbar: www:@menu-common}}