Nette Documentation Preview

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

.[perex]
Deseja aproveitar os benefícios do Nette em seu projeto existente ou está planejando criar um novo projeto baseado no Nette? Este guia o orientará passo a passo na instalação.


Como adicionar o Nette ao seu projeto .[#toc-how-to-add-nette-to-your-project]
------------------------------------------------------------------------------

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

1) **Configure o [Composer |best-practices:composer]:** Essa ferramenta é essencial para facilitar a instalação, a atualização e o gerenciamento das bibliotecas necessárias para o seu projeto.

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

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

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

Você prefere uma interface gráfica? Confira o [guia |https://www.jetbrains.com/help/phpstorm/using-the-composer-dependency-manager.html] sobre a instalação de pacotes no ambiente PhpStorm.


Como iniciar um novo projeto com o Nette .[#toc-how-to-start-a-new-project-with-nette]
--------------------------------------------------------------------------------------

Se você quiser criar um projeto totalmente novo na plataforma Nette, recomendamos usar o esqueleto predefinido do [Projeto Web |https://github.com/nette/web-project]:

1) **Configure 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 PROJECT_NAME
```

4) **Não está usando o Composer? Basta fazer o download do [Projeto Web em formato ZIP |https://github.com/nette/web-project/archive/preloaded.zip] e extraí-lo. Mas confie em nós, o Composer vale a pena!

5) **Definição de permissões:** Nos sistemas macOS ou Linux, defina [permissões de gravação |nette:troubleshooting#Setting directory permissions] para os diretórios.

6) **Abrir o projeto em um navegador:** Digite o URL `http://localhost/PROJECT_NAME/www/`. Você verá a página inicial do esqueleto:

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

Parabéns! Seu site agora está pronto para o desenvolvimento. Sinta-se à vontade para remover o modelo de boas-vindas e começar a criar seu aplicativo.

Uma das vantagens do Nette é que o projeto funciona imediatamente sem a necessidade de configuração. No entanto, se você encontrar algum problema, considere dar uma olhada nas [soluções de problemas comuns |nette:troubleshooting#nette-is-not-working-white-page-is-displayed].

.[note]
Se estiver começando a usar o Nette, recomendamos que continue com o [tutorial Criar seu primeiro aplicativo |quickstart:].


Ferramentas e recomendações .[#toc-tools-and-recommendations]
-------------------------------------------------------------

Para um trabalho eficiente com a Nette, recomendamos as seguintes ferramentas:

- [IDE de alta qualidade com plug-ins para Nette |best-practices:editors-and-tools]
- Sistema de controle de versão Git
- [Compositor |best-practices:composer]


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

Instalação do Nette

Deseja aproveitar os benefícios do Nette em seu projeto existente ou está planejando criar um novo projeto baseado no Nette? Este guia o orientará passo a passo na instalação.

Como adicionar o Nette ao seu projeto

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

  1. Configure o Composer: Essa ferramenta é essencial para facilitar a instalação, a atualização e o gerenciamento das bibliotecas necessárias para o seu projeto.
  2. Escolha um pacote: Digamos que você precise navegar no sistema de arquivos, o que o Finder do pacote nette/utils faz de forma excelente. Você pode encontrar o nome do pacote na coluna da direita da documentação.
  3. Instale o pacote: Execute este comando no diretório raiz de seu projeto:
composer require nette/utils

Você prefere uma interface gráfica? Confira o guia sobre a instalação de pacotes no ambiente PhpStorm.

Como iniciar um novo projeto com o Nette

Se você quiser criar um projeto totalmente novo na plataforma Nette, recomendamos usar o esqueleto predefinido do Projeto Web:

  1. Configure o 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:
composer create-project nette/web-project PROJECT_NAME
  1. **Não está usando o Composer? Basta fazer o download do Projeto Web em formato ZIP e extraí-lo. Mas confie em nós, o Composer vale a pena!
  2. Definição de permissões: Nos sistemas macOS ou Linux, defina permissões de gravação para os diretórios.
  3. Abrir o projeto em um navegador: Digite o URL http://localhost/PROJECT_NAME/www/. Você verá a página inicial do esqueleto:

Parabéns! Seu site agora está pronto para o desenvolvimento. Sinta-se à vontade para remover o modelo de boas-vindas e começar a criar seu aplicativo.

Uma das vantagens do Nette é que o projeto funciona imediatamente sem a necessidade de configuração. No entanto, se você encontrar algum problema, considere dar uma olhada nas soluções de problemas comuns.

Se estiver começando a usar o Nette, recomendamos que continue com o tutorial Criar seu primeiro aplicativo.

Ferramentas e recomendações

Para um trabalho eficiente com a Nette, recomendamos as seguintes ferramentas: