Instalacja Nette
****************

.[perex]
Chcesz wykorzystać zalety Nette w swoim istniejącym projekcie, czy planujesz stworzyć nowy projekt oparty na Nette? Ten przewodnik przeprowadzi Cię przez instalację krok po kroku.


Jak dodać Nette do swojego projektu
-----------------------------------

Nette oferuje kolekcję użytecznych i zaawansowanych pakietów (bibliotek) dla PHP. Aby włączyć je do swojego projektu, postępuj zgodnie z poniższymi krokami:

1) **Przygotuj [Composer|best-practices:composer]:** To narzędzie jest niezbędne do łatwej instalacji, aktualizacji i zarządzania bibliotekami potrzebnymi dla Twojego projektu.

2) **Wybierz [pakiet|www:packages]:** Załóżmy, że potrzebujesz przeglądać system plików, co świetnie robi [Finder|utils:finder] z pakietu `nette/utils`. Nazwę pakietu widzisz w prawej kolumnie jego dokumentacji.

3) **Zainstaluj pakiet:** Uruchom to polecenie w głównym katalogu swojego projektu:

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

Preferujesz interfejs graficzny? Zapoznaj się z [instrukcją|https://www.jetbrains.com/help/phpstorm/using-the-composer-dependency-manager.html] instalacji pakietów w środowisku PhpStorm.


Jak założyć nowy projekt z Nette
--------------------------------

Jeśli chcesz stworzyć zupełnie nowy projekt na platformie Nette, zalecamy skorzystanie z gotowego szkieletu [Web Project|https://github.com/nette/web-project]:

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

2) **Otwórz wiersz poleceń** i przejdź do głównego katalogu swojego serwera WWW, np. `/var/www/html`, `C:/xampp/htdocs`, `/Library/WebServer/Documents`.

3) **Utwórz projekt** za pomocą tego polecenia:

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

4) **Nie używasz Composera?** Wystarczy pobrać [Web Project w formacie ZIP|https://github.com/nette/web-project/archive/preloaded.zip] i rozpakować go. Ale uwierz, Composer jest tego wart!

5) **Ustawienia uprawnień:** Na systemach macOS lub Linux ustaw [prawa zapisu |nette:troubleshooting#Ustawianie uprawnień do katalogów] do katalogów `temp/` i `log/`.

6) **Otwarcie projektu w przeglądarce:** Wpisz URL `http://localhost/NAZWA_PROJEKTU/www/` i zobaczysz stronę powitalną szkieletu:

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

Gratulacje! Twoja strona jest teraz gotowa do rozwoju. Możesz usunąć szablon powitalny i zacząć tworzyć swoją aplikację.

Jedną z zalet Nette jest to, że projekt działa od razu bez potrzeby konfiguracji. Jeśli jednak napotkasz problemy, spróbuj zajrzeć do [rozwiązań częstych problemów |nette:troubleshooting#Nette nie działa wyświetla się biała strona].

.[note]
Jeśli zaczynasz z Nette, zalecamy kontynuowanie [tutorialem Pisanie pierwszej aplikacji|quickstart:].


Narzędzia i zalecenia
---------------------

Do efektywnej pracy z Nette polecamy następujące narzędzia:

- [Dobrej jakości IDE z dodatkami dla Nette|best-practices:editors-and-tools]
- System kontroli wersji Git
- [Composer|best-practices:composer]


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