Nette Documentation Preview

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

.[perex]
Може да сте опитен програмист, но само с добри инструменти ще станете майстор. В тази глава ще намерите съвети за важни инструменти, редактори и плъгини.


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" в marketplace.

Свържете също 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#Контролни знаци]
- проверява дали файлът е кодиран в UTF-8
- проверява за неправилно записани `/* @anotace */` (липсва звездичка)
- премахва затварящия таг `?>` от PHP файловете
- премахва интервалите в края на реда и ненужните редове в края на файла
- нормализира разделителите на редове до системните (ако посочите опцията `-l`)


Composer
========

[Composer |Composer] е инструмент за управление на зависимости в PHP. Позволява ни да декларираме произволно сложни зависимости на отделни библиотеки и след това ги инсталира вместо нас в нашия проект.


Requirements Checker
====================

Това беше инструмент, който тестваше средата за изпълнение на сървъра и информираше дали (и до каква степен) е възможно да се използва framework-ът. В момента Nette може да се използва на всеки сървър, който има минималната изисквана версия на PHP.

{{sitename: Best Practices}}

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

Може да сте опитен програмист, но само с добри инструменти ще станете майстор. В тази глава ще намерите съвети за важни инструменти, редактори и плъгини.

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“ в marketplace.

Свържете също 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
  • проверява за неправилно записани /* @anotace */ (липсва звездичка)
  • премахва затварящия таг ?> от PHP файловете
  • премахва интервалите в края на реда и ненужните редове в края на файла
  • нормализира разделителите на редове до системните (ако посочите опцията -l)

Composer

Composer е инструмент за управление на зависимости в PHP. Позволява ни да декларираме произволно сложни зависимости на отделни библиотеки и след това ги инсталира вместо нас в нашия проект.

Requirements Checker

Това беше инструмент, който тестваше средата за изпълнение на сървъра и информираше дали (и до каква степен) е възможно да се използва framework-ът. В момента Nette може да се използва на всеки сървър, който има минималната изисквана версия на PHP.