Nette Documentation Preview

syntax
Инсталиране на Nette
********************

.[perex]
Искате ли да използвате предимствата на Nette във вашия съществуващ проект или планирате да създадете нов проект, базиран на Nette? Това ръководство ще ви преведе стъпка по стъпка през инсталацията.


Как да добавите Nette към вашия проект .[#toc-how-to-add-nette-to-your-project]
-------------------------------------------------------------------------------

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 .[#toc-how-to-start-a-new-project-with-nette]
---------------------------------------------------------------------------------

Ако искате да създадете изцяло нов проект в платформата Nette, препоръчваме ви да използвате предварително зададения скелет на [уеб проект |https://github.com/nette/web-project]:

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

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

3) **Създайте проекта**, като използвате тази команда:

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

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

5) **Настройване на разрешенията:** В системите MacOS или Linux задайте [разрешения за запис на |nette:troubleshooting#Setting directory permissions] директории.

6) **Отваряне на проекта в браузър:** Въведете URL адреса `http://localhost/PROJECT_NAME/www/`. Ще видите началната страница на скелета:

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

Поздравления! Вашият уебсайт вече е готов за разработка. Чувствайте се свободни да премахнете шаблона за посрещане и да започнете да изграждате своето приложение.

Едно от предимствата на Nette е, че проектът работи веднага, без да е необходимо да се конфигурира. Въпреки това, ако се сблъскате с някакви проблеми, помислете дали да не разгледате [общите решения на проблемите |nette:troubleshooting#nette-is-not-working-white-page-is-displayed].

.[note]
Ако започвате работа с Nette, препоръчваме ви да продължите с [урока |quickstart:]" [Създаване на първото ви приложение |quickstart:]".


Инструменти и препоръки .[#toc-tools-and-recommendations]
---------------------------------------------------------

За ефективна работа с Nette препоръчваме следните инструменти:

- [Висококачествен IDE с плъгини за Nette |best-practices:editors-and-tools]
- Система за контрол на версиите Git
- [Composer |best-practices:composer]


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

Инсталиране на Nette

Искате ли да използвате предимствата на Nette във вашия съществуващ проект или планирате да създадете нов проект, базиран на Nette? Това ръководство ще ви преведе стъпка по стъпка през инсталацията.

Как да добавите Nette към вашия проект

Nette предлага колекция от полезни и усъвършенствани пакети (библиотеки) за PHP. За да ги включите във вашия проект, следвайте следните стъпки:

  1. Настройте Composer: Този инструмент е от съществено значение за лесното инсталиране, актуализиране и управление на библиотеките, необходими за вашия проект.
  2. Избор на пакет: Да речем, че трябва да се ориентирате във файловата система, което Finder от пакета nette/utils прави отлично. Можете да намерите името на пакета в дясната колона на неговата документация.
  3. Инсталирайте пакета: Изпълнете тази команда в главната директория на вашия проект:
composer require nette/utils

Предпочитате ли графичен интерфейс? Разгледайте ръководството за инсталиране на пакети в средата PhpStorm.

Как да започнете нов проект с Nette

Ако искате да създадете изцяло нов проект в платформата Nette, препоръчваме ви да използвате предварително зададения скелет на уеб проект:

  1. Настройте Composer.
  2. Отворете командния ред и отидете в главната директория на вашия уеб сървър, например /etc/var/www, C:/xampp/htdocs, /Library/WebServer/Documents.
  3. Създайте проекта, като използвате тази команда:
composer create-project nette/web-project PROJECT_NAME
  1. Не използвате Composer? Просто изтеглете уеб проекта в ZIP формат и го разархивирайте. Но повярвайте ни, Composer си заслужава!
  2. Настройване на разрешенията: В системите MacOS или Linux задайте разрешения за запис на директории.
  3. Отваряне на проекта в браузър: Въведете URL адреса http://localhost/PROJECT_NAME/www/. Ще видите началната страница на скелета:

Поздравления! Вашият уебсайт вече е готов за разработка. Чувствайте се свободни да премахнете шаблона за посрещане и да започнете да изграждате своето приложение.

Едно от предимствата на Nette е, че проектът работи веднага, без да е необходимо да се конфигурира. Въпреки това, ако се сблъскате с някакви проблеми, помислете дали да не разгледате общите решения на проблемите.

Ако започвате работа с Nette, препоръчваме ви да продължите с урока" Създаване на първото ви приложение".

Инструменти и препоръки

За ефективна работа с Nette препоръчваме следните инструменти: