Nette Documentation Preview

syntax
Редакторы и инструменты
***********************

.[perex]
Вы можете быть искусным программистом, но только с хорошими инструментами вы станете мастером. В этой главе вы найдете советы о важных инструментах, редакторах и плагинах.


Редактор IDE .[#toc-ide-editor]
===============================

Мы настоятельно рекомендуем использовать для разработки полнофункциональную IDE, такую как PhpStorm, NetBeans, VS Code, а не просто текстовый редактор с поддержкой PHP. Разница действительно принципиальна. Нет причин довольствоваться классическим редактором с подсветкой синтаксиса, потому что он не дотягивает до возможностей IDE с точным предложением кода, возможностью рефакторинга кода и т. д. Некоторые IDE являются платными, другие — бесплатными.

**NetBeans IDE** имеет встроенную поддержку Nette, Latte и NEON.

**PhpStorm**: установите эти плагины в `Settings > Plugins > Marketplace`:
- Nette framework helpers
- Latte
- NEON support
- Nette Tester

**VS Code**: найдите плагин "Nette Latte + Neon" в маркетплейсе.

Также соедините Tracy с редактором. Когда отображается страница ошибки, вы можете кликнуть по именам файлов, и они откроются в редакторе с курсором в соответствующей строке. Узнайте [как настроить систему |tracy:open-files-in-ide].


PHPStan
=======

PHPStan — это инструмент, который обнаруживает логические ошибки в вашем коде до того, как вы его запустите.

Установите его через Composer:

```shell
composer require --dev phpstan/phpstan-nette
```

Создайте в проекте конфигурационный файл `phpstan.neon`:

```neon
includes:
	- vendor/phpstan/phpstan-nette/extension.neon

parameters:
	scanDirectories:
		- app

	level: 5
```

А затем позвольте ему проанализировать классы в папке `app/`:

```shell
vendor/bin/phpstan analyse app
```

Вы можете найти полную документацию непосредственно на сайте [PHPStan |https://phpstan.org].


Code Checker
============

[Code Checker|code-checker:] проверяет и по возможности исправляет некоторые формальные ошибки в вашем исходном коде.

- удаляет [BOM |nette:glossary#bom].
- проверяет валидность шаблонов [Latte |latte:].
- проверяет валидность файлов `.neon`, `.php` и `.json`.
- проверяет наличие [управляющих символов |nette:glossary#Control-Characters].
- проверяет, закодирован ли файл в UTF-8
- контролирует правильность написания `/* @annotations */` (пропущена вторая звездочка)
- удаляет завершающие теги PHP `?>` в файлах PHP
- удаляет из конца файла пробельные символы и ненужные пустые строки
- нормализует окончания строк к системному значению по умолчанию (с параметром `-l`)


Composer
========

[Composer] — это инструмент для управления зависимостями в PHP. Он позволяет нам объявить зависимости библиотек, и он установит их за нас в наш проект.


Скрипт проверки требований .[#toc-requirements-checker]
=======================================================

Это был инструмент, который тестировал рабочую среду сервера и сообщал, можно ли (и в какой степени) использовать фреймворк. В настоящее время Nette можно использовать на любом сервере, на котором установлена минимально необходимая версия PHP.

{{sitename: Лучшие практики}}

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

Вы можете быть искусным программистом, но только с хорошими инструментами вы станете мастером. В этой главе вы найдете советы о важных инструментах, редакторах и плагинах.

Редактор IDE

Мы настоятельно рекомендуем использовать для разработки полнофункциональную IDE, такую как PhpStorm, NetBeans, VS Code, а не просто текстовый редактор с поддержкой PHP. Разница действительно принципиальна. Нет причин довольствоваться классическим редактором с подсветкой синтаксиса, потому что он не дотягивает до возможностей IDE с точным предложением кода, возможностью рефакторинга кода и т. д. Некоторые IDE являются платными, другие — бесплатными.

NetBeans IDE имеет встроенную поддержку Nette, Latte и NEON.

PhpStorm: установите эти плагины в Settings > Plugins > Marketplace:

  • Nette framework helpers
  • Latte
  • NEON support
  • Nette Tester

VS Code: найдите плагин „Nette Latte + Neon“ в маркетплейсе.

Также соедините Tracy с редактором. Когда отображается страница ошибки, вы можете кликнуть по именам файлов, и они откроются в редакторе с курсором в соответствующей строке. Узнайте как настроить систему.

PHPStan

PHPStan — это инструмент, который обнаруживает логические ошибки в вашем коде до того, как вы его запустите.

Установите его через Composer:

composer require --dev phpstan/phpstan-nette

Создайте в проекте конфигурационный файл phpstan.neon:

includes:
	- vendor/phpstan/phpstan-nette/extension.neon

parameters:
	scanDirectories:
		- app

	level: 5

А затем позвольте ему проанализировать классы в папке app/:

vendor/bin/phpstan analyse app

Вы можете найти полную документацию непосредственно на сайте PHPStan.

Code Checker

Code Checker проверяет и по возможности исправляет некоторые формальные ошибки в вашем исходном коде.

  • удаляет BOM.
  • проверяет валидность шаблонов Latte.
  • проверяет валидность файлов .neon, .php и .json.
  • проверяет наличие управляющих символов.
  • проверяет, закодирован ли файл в UTF-8
  • контролирует правильность написания /* @annotations */ (пропущена вторая звездочка)
  • удаляет завершающие теги PHP ?> в файлах PHP
  • удаляет из конца файла пробельные символы и ненужные пустые строки
  • нормализует окончания строк к системному значению по умолчанию (с параметром -l)

Composer

Composer — это инструмент для управления зависимостями в PHP. Он позволяет нам объявить зависимости библиотек, и он установит их за нас в наш проект.

Скрипт проверки требований

Это был инструмент, который тестировал рабочую среду сервера и сообщал, можно ли (и в какой степени) использовать фреймворк. В настоящее время Nette можно использовать на любом сервере, на котором установлена минимально необходимая версия PHP.