Instalação do Nette
*******************

.[perex]
Quer aproveitar as vantagens do Nette em seu projeto existente ou está planejando criar um novo projeto baseado no Nette? Este guia o levará pela instalação passo a passo.


Como adicionar o Nette ao seu projeto
-------------------------------------

O Nette oferece uma coleção de pacotes (bibliotecas) úteis e avançados para PHP. Para incorporá-los ao seu projeto, siga estas etapas:

1) **Prepare o [Composer|best-practices:composer]:** Esta ferramenta é essencial para instalar, atualizar e gerenciar facilmente as bibliotecas necessárias para o seu projeto.

2) **Escolha um [pacote|www:packages]:** Digamos que você precise navegar pelo sistema de arquivos, o que o [Finder|utils:finder] do pacote `nette/utils` faz muito bem. Você pode ver o nome do pacote na coluna direita de sua documentação.

3) **Instale o pacote:** Execute este comando no diretório raiz do seu projeto:

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

Prefere uma interface gráfica? Confira o [guia|https://www.jetbrains.com/help/phpstorm/using-the-composer-dependency-manager.html] para instalar pacotes no ambiente PhpStorm.


Como iniciar um novo projeto com o Nette
----------------------------------------

Se você deseja criar um projeto totalmente novo na plataforma Nette, recomendamos usar o esqueleto pré-configurado [Web Project|https://github.com/nette/web-project]:

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

2) **Abra a linha de comando** e navegue até o diretório raiz do seu servidor web, por exemplo, `/etc/var/www`, `C:/xampp/htdocs`, `/Library/WebServer/Documents`.

3) **Crie o projeto** usando este comando:

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

4) **Não usa o Composer?** Basta baixar o [Web Project em formato ZIP|https://github.com/nette/web-project/archive/preloaded.zip] e descompactá-lo. Mas acredite, o Composer vale a pena!

5) **Configuração de permissões:** Em sistemas macOS ou Linux, defina as [permissões de escrita |nette:troubleshooting#Configurando Permissões de Diretório] para os diretórios `temp/` e `log/`.

6) **Abrindo o projeto no navegador:** Digite a URL `http://localhost/NOME_DO_PROJETO/www/` e você verá a página inicial do esqueleto:

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

Parabéns! Seu site agora está pronto para desenvolvimento. Você pode remover o template de boas-vindas e começar a criar sua aplicação.

Uma das vantagens do Nette é que o projeto funciona imediatamente sem a necessidade de configuração. No entanto, se você encontrar problemas, tente consultar as [soluções para problemas comuns |nette:troubleshooting#O Nette não funciona uma página em branco é exibida].

.[note]
Se você está começando com o Nette, recomendamos continuar com o [tutorial Escrevendo a primeira aplicação|quickstart:].


Ferramentas e Recomendações
---------------------------

Para trabalhar eficientemente com o Nette, recomendamos as seguintes ferramentas:

- [IDE de qualidade com plugins para Nette|best-practices:editors-and-tools]
- Sistema de controle de versão Git
- [Composer|best-practices:composer]


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