Создайте своё первое приложение!
********************************

.[perex]
Познакомьтесь с Nette Framework, создавая простой блог с комментариями. Начнём!

После первых двух глав у вас будет собственный работающий блог и вы будете готовы публиковать свои замечательные записи, хотя после этих двух глав возможности будут довольно ограниченными. Прочитайте и следующие главы, в которых мы реализуем добавление комментариев, редактирование записей и, наконец, защиту блога.

.[tip]
Это руководство предполагает, что вы прошли документ [Установка |nette:installation] и успешно настроили свои инструменты. Оно также предполагает, что вы разбираетесь в [объектно-ориентированном программировании на PHP |nette:introduction-to-object-oriented-programming].

Используйте, пожалуйста, PHP 8.1 или новее. Готовое приложение вы найдёте [на GitHub |https://github.com/nette-examples/quickstart/tree/v4.0].


Приветственная страница
=======================

Начнём с создания нового проекта в каталоге `nette-blog`:

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

В этот момент уже должна работать приветственная страница Web Project. Проверьте это, открыв браузер и перейдя по такому URL:

```
http://localhost/nette-blog/www/
```

и вы должны увидеть приветственную страницу Nette Framework:

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

Приложение работает, и вы можете начать его изменять.

.[note]
Если возникнет проблема, [попробуйте эти несколько советов |nette:troubleshooting#Nette не работает, отображается белая страница].


Содержимое Web Project
======================

У Web Project такая структура:

/--pre
<b>nette-blog/</b>
├── <b>app/</b>              ← каталог приложения
│   ├── <b>Core/</b>         ← базовые необходимые классы
│   ├── <b>Presentation/</b> ← презентеры, шаблоны и компания
│   │   └── <b>Home/</b>     ← каталог презентера Home
│   └── <b>Bootstrap.php</b> ← загрузочный класс Bootstrap
├── <b>assets/</b>           ← исходные ресурсы (SCSS, TypeScript, исходные изображения)
├── <b>bin/</b>              ← скрипты для командной строки
├── <b>config/</b>           ← конфигурационные файлы
├── <b>log/</b>              ← логи ошибок
├── <b>temp/</b>             ← временные файлы, кеш, …
├── <b>vendor/</b>           ← библиотеки, установленные Composer
│   └── <b>autoload.php</b>  ← автозагрузка всех установленных пакетов
└── <b>www/</b>              ← публичная папка, единственное место, доступное из браузера
    ├── <b>assets/</b>       ← скомпилированные статические файлы (CSS, JS, изображения, …)
    └── <b>index.php</b>     ← начальный файл, запускающий приложение
\--

Каталог `www/` предназначен для хранения изображений, файлов JavaScript, стилей CSS и прочих публично доступных файлов. Это единственный каталог, доступный напрямую из интернета, так что задайте document root вашего веб-сервера так, чтобы он указывал сюда (настроить это можно в Apache или Nginx, но сделаем это позже, потому что сейчас это не критично).

Самый важный каталог для вас - `app/`. Здесь вы найдёте файл `Bootstrap.php`, содержащий класс, который загружает фреймворк и настраивает приложение. Он включает [автозагрузку |robot-loader:], настраивает [отладчик |tracy:] и [маршруты |application:routing].


Уборка
======

Web Project содержит приветственную страницу, которую мы уберём, прежде чем начать программировать. Смело замените содержимое файла `app/Presentation/Home/default.latte` на "Hello world!".


[* qs-hello.webp .{url:-} *]


Tracy (отладчик)
================

Чрезвычайно важный инструмент при разработке - [инструмент отладки Tracy |tracy:]. Попробуйте внести ошибку в файл `app/Presentation/Home/HomePresenter.php` (например, уберите фигурную скобку из определения класса `HomePresenter`) и посмотрите, что произойдёт. Появится страница с красным экраном и понятным описанием ошибки.

[* qs-tracy.avif .{url:-}(экран отладчика) *]

Tracy существенно поможет вам при поиске ошибок. Обратите внимание и на плавающую панель Tracy Bar в правом нижнем углу экрана, которая показывает важные сведения о работе приложения.

[* qs-tracybar.webp .{url:-} *]

В продакшн-режиме Tracy, разумеется, выключена и никаких конфиденциальных сведений не показывает. Все ошибки вместо этого сохраняются в каталог `log/`. Попробуем. В файле `app/Bootstrap.php` найдите следующий кусок кода, раскомментируйте строку и измените параметр вызова метода на `false`, чтобы получилось так:

```php .{file:app/Bootstrap.php}
// ...
$this->configurator->setDebugMode(false);
```

После обновления страницы красного экрана вы уже не увидите. Вместо него отобразится понятное пользователю сообщение:

[* qs-fatal.webp .{url:-}(экран ошибки) *]

Теперь загляните в каталог `log/`. Здесь (в файле `exception.log`) вы найдёте записанную ошибку, а также знакомую страницу с сообщением об ошибке (сохранённую как HTML-файл с именем, начинающимся на `exception-`).

Закомментируйте строку `// $this->configurator->setDebugMode(false);` обратно. Tracy автоматически включает режим разработки в окружении `localhost` и выключает его в других местах.

Теперь мы можем исправить внесённую ошибку и продолжить строить приложение.


Отправьте благодарность
=======================

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

```shell
composer thanks
```

Попробуйте!

{{priority: -1}}