Nette Documentation Preview

syntax 
Установка Nette
***************

.[perex]
Хотите воспользоваться преимуществами Nette в существующем проекте или планируете создать новый проект на Nette? Это руководство шаг за шагом проведёт вас через установку.


Как добавить Nette в свой проект
--------------------------------

Nette предлагает набор полезных и продуманных пакетов (библиотек) для PHP. Чтобы подключить их в свой проект, выполните следующие шаги:

1) **Настройте [Composer|best-practices:composer]:** этот инструмент необходим для лёгкой установки, обновления и управления библиотеками, которые нужны вашему проекту.

2) **Выберите [пакет|www:packages]:** допустим, вам нужно ходить по файловой системе, с чем прекрасно справляется [Finder|utils:finder] из пакета `nette/utils`. Имя пакета вы найдёте в правом столбце его документации.

3) **Установите пакет:** выполните в корневом каталоге проекта эту команду:

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

Предпочитаете графический интерфейс? Посмотрите [руководство|https://www.jetbrains.com/help/phpstorm/using-the-composer-dependency-manager.html] по установке пакетов в среде PhpStorm.


Как начать новый проект на Nette
--------------------------------

Если вы хотите создать совершенно новый проект на платформе Nette, мы рекомендуем использовать заранее настроенный каркас [Web Project|https://github.com/nette/web-project]:

1) **Настройте [Composer|best-practices:composer].**

2) **Откройте командную строку** и перейдите в корневой каталог вашего веб-сервера, например `/var/www/html`, `C:/xampp/htdocs`, `/Library/WebServer/Documents`.

3) **Создайте проект** этой командой:

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

4) **Не используете Composer?** Просто скачайте [Web Project в формате ZIP|https://github.com/nette/web-project/archive/preloaded.zip] и распакуйте его. Но поверьте нам, Composer того стоит!

5) **Задайте права:** в системах macOS или Linux задайте каталогам [права на запись |nette:troubleshooting#Задание прав на каталоги].

6) **Откройте проект в браузере:** введите URL `http://localhost/PROJECT_NAME/www/`. Вы увидите стартовую страницу каркаса:

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

Поздравляем! Ваш сайт готов к разработке. Смело удаляйте приветственный шаблон и начинайте строить своё приложение.

Одно из преимуществ Nette в том, что проект работает сразу, без всякой настройки. Однако если вы столкнётесь с трудностями, загляните в [решения частых проблем |nette:troubleshooting#Nette не работает, отображается белая страница].

.[note]
Если вы начинаете с Nette, мы рекомендуем продолжить руководством [Пишем первое приложение|quickstart:].


Инструменты и рекомендации
--------------------------

Для эффективной работы с Nette мы рекомендуем следующие инструменты:

- [Качественная IDE с плагинами для Nette|tools:ide]
- Система контроля версий Git
- [Composer|best-practices:composer]

Установка Nette

Хотите воспользоваться преимуществами Nette в существующем проекте или планируете создать новый проект на Nette? Это руководство шаг за шагом проведёт вас через установку.

Как добавить Nette в свой проект

Nette предлагает набор полезных и продуманных пакетов (библиотек) для PHP. Чтобы подключить их в свой проект, выполните следующие шаги:

  1. Настройте Composer: этот инструмент необходим для лёгкой установки, обновления и управления библиотеками, которые нужны вашему проекту.
  2. Выберите пакет: допустим, вам нужно ходить по файловой системе, с чем прекрасно справляется Finder из пакета nette/utils. Имя пакета вы найдёте в правом столбце его документации.
  3. Установите пакет: выполните в корневом каталоге проекта эту команду:
composer require nette/utils

Предпочитаете графический интерфейс? Посмотрите руководство по установке пакетов в среде PhpStorm.

Как начать новый проект на Nette

Если вы хотите создать совершенно новый проект на платформе Nette, мы рекомендуем использовать заранее настроенный каркас Web Project:

  1. Настройте Composer.
  2. Откройте командную строку и перейдите в корневой каталог вашего веб-сервера, например /var/www/html, C:/xampp/htdocs, /Library/WebServer/Documents.
  3. Создайте проект этой командой:
composer create-project nette/web-project PROJECT_NAME
  1. Не используете Composer? Просто скачайте Web Project в формате ZIP и распакуйте его. Но поверьте нам, Composer того стоит!
  2. Задайте права: в системах macOS или Linux задайте каталогам права на запись.
  3. Откройте проект в браузере: введите URL http://localhost/PROJECT_NAME/www/. Вы увидите стартовую страницу каркаса:

Поздравляем! Ваш сайт готов к разработке. Смело удаляйте приветственный шаблон и начинайте строить своё приложение.

Одно из преимуществ Nette в том, что проект работает сразу, без всякой настройки. Однако если вы столкнётесь с трудностями, загляните в решения частых проблем.

Если вы начинаете с Nette, мы рекомендуем продолжить руководством Пишем первое приложение.

Инструменты и рекомендации

Для эффективной работы с Nette мы рекомендуем следующие инструменты: