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

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


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

Nette oferuje zbiór przydatnych i dopracowanych pakietów (bibliotek) dla PHP. Żeby włączyć je do swojego projektu, wykonaj te kroki:

1) **Przygotuj [Composera|best-practices:composer]:** to narzędzie jest niezbędne do łatwej instalacji, aktualizacji i zarządzania bibliotekami potrzebnymi w Twoim projekcie.

2) **Wybierz [pakiet|www:packages]:** powiedzmy, że potrzebujesz poruszać się po systemie plików, co świetnie robi [Finder|utils:finder] z pakietu `nette/utils`. Nazwę pakietu znajdziesz w prawej kolumnie jego dokumentacji.

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

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

Wolisz interfejs graficzny? Zajrzyj do [przewodnika|https://www.jetbrains.com/help/phpstorm/using-the-composer-dependency-manager.html] po instalacji pakietów w środowisku PhpStorm.


Jak zacząć nowy projekt z Nette
-------------------------------

Jeśli chcesz stworzyć całkowicie nowy projekt na platformie Nette, zalecamy użycie wstępnie skonfigurowanego szkieletu [Web Project|https://github.com/nette/web-project]:

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

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

3) **Utwórz projekt** tym poleceniem:

```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ć. Ale uwierz nam, Composer jest tego wart!

5) **Ustaw uprawnienia:** w systemach macOS albo Linux ustaw [uprawnienia do zapisu |nette:troubleshooting#Ustawienie uprawnień do katalogów] dla katalogów.

6) **Otwórz projekt w przeglądarce:** wpisz URL `http://localhost/NAZWA_PROJEKTU/www/`. Zobaczysz stronę powitalną szkieletu:

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

Gratulacje! Twoja strona jest gotowa do tworzenia. Śmiało usuń szablon powitalny i zacznij budować swoją aplikację.

Jedną z zalet Nette jest to, że projekt działa od razu, bez potrzeby konfigurowania. Jeśli jednak natrafisz na jakieś problemy, zajrzyj do [rozwiązań typowych problemów |nette:troubleshooting#Nette nie działa, wyświetla się biała strona].

.[note]
Jeśli zaczynasz z Nette, zalecamy kontynuować [samouczkiem Tworzymy pierwszą aplikację|quickstart:].


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

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

- [Dobre IDE z pluginami dla Nette|tools:ide]
- System kontroli wersji Git
- [Composer|best-practices:composer]