Nette Documentation Preview

syntax
Edytory i narzędzia
*******************

.[perex]
Możesz być zdolnym programistą, ale tylko dzięki dobrym narzędziom staniesz się mistrzem. W tym rozdziale znajdziesz wskazówki dotyczące ważnych narzędzi, edytorów i wtyczek.


Edytor IDE .[#toc-ide-editor]
=============================

Zdecydowanie zalecamy używanie w pełni funkcjonalnego IDE do programowania, takiego jak PhpStorm, NetBeans, VS Code, a nie tylko edytora tekstu z obsługą PHP. Różnica jest naprawdę kluczowa. Nie ma powodu, aby zadowalać się klasycznym edytorem z kolorowaniem składni, ponieważ nie osiąga on możliwości IDE z dokładną sugestią kodu, który może refaktoryzować kod i więcej. Niektóre IDE są płatne, inne darmowe.

**NetBeans IDE** ma wbudowane wsparcie dla Nette, Latte i NEON.

**PhpStorm**: zainstaluj te wtyczki w `Settings > Plugins > Marketplace`:
- Pomocnicy frameworka Nette
- Latte
- Wsparcie dla NEON
- Tester Nette

**Kod VS**: znajdź wtyczkę "Nette Latte + Neon" na rynku.

Zamieść również link Tracy to the editor. Gdy pojawi się strona z błędami, można wtedy kliknąć na nazwy plików i otworzą się one w edytorze z kursorem w odpowiedniej linii. Dowiedz się, [jak skonfigurować system |tracy:open-files-in-ide].


PHPStan .[#toc-phpstan]
=======================

PHPStan to narzędzie, które wykrywa błędy logiczne w Twoim kodzie, zanim go uruchomisz.

Instalujemy go za pomocą programu Composer:

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

Utwórz plik konfiguracyjny w projekcie `phpstan.neon`:

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

parameters:
	scanDirectories:
		- app

	level: 5
```

A potem niech analizuje klasy w folderze `app/`:

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

Obszerną dokumentację można znaleźć bezpośrednio na [stronie PHPStan |https://phpstan.org].


Code Checker .[#toc-code-checker]
=================================

[Code Checker |code-checker:] sprawdzi i ewentualnie naprawi niektóre błędy formalne w Twoim kodzie źródłowym:

- usuwa [BOM |nette:glossary#bom]
- sprawdza ważność szablonów [Latte |latte:]
- sprawdza ważność stron `.neon`, `.php` oraz `.json`
- kontrole dla [znaków kontrolnych |nette:glossary#Control-Characters]
- sprawdza czy plik jest zakodowany w UTF-8
- sprawdza, czy nie ma błędnie napisanej strony `/* @anotace */` (brak gwiazdki)
- usuwa terminator `?>` z plików PHP
- usuwa prawe spacje i niepotrzebne linie na końcu pliku
- normalizuje separatory linii do systemowych separatorów linii (jeśli podano opcję `-l`)


Kompozytor .[#toc-composer]
===========================

[Composer |Composer] to narzędzie do zarządzania zależnościami w PHP. Pozwala nam zadeklarować dowolnie złożone zależności biblioteczne, a następnie instaluje je w naszym projekcie za nas.


Sprawdzanie wymagań .[#toc-requirements-checker]
================================================

Było to narzędzie, które testowało środowisko uruchomieniowe serwera i informowało, czy (i w jakim zakresie) można wykorzystać framework. Obecnie Nette można używać na każdym serwerze, który posiada minimalną wymaganą wersję PHP.

{{sitename: Najlepsze praktyki}}

Edytory i narzędzia

Możesz być zdolnym programistą, ale tylko dzięki dobrym narzędziom staniesz się mistrzem. W tym rozdziale znajdziesz wskazówki dotyczące ważnych narzędzi, edytorów i wtyczek.

Edytor IDE

Zdecydowanie zalecamy używanie w pełni funkcjonalnego IDE do programowania, takiego jak PhpStorm, NetBeans, VS Code, a nie tylko edytora tekstu z obsługą PHP. Różnica jest naprawdę kluczowa. Nie ma powodu, aby zadowalać się klasycznym edytorem z kolorowaniem składni, ponieważ nie osiąga on możliwości IDE z dokładną sugestią kodu, który może refaktoryzować kod i więcej. Niektóre IDE są płatne, inne darmowe.

NetBeans IDE ma wbudowane wsparcie dla Nette, Latte i NEON.

PhpStorm: zainstaluj te wtyczki w Settings > Plugins > Marketplace:

  • Pomocnicy frameworka Nette
  • Latte
  • Wsparcie dla NEON
  • Tester Nette

Kod VS: znajdź wtyczkę „Nette Latte + Neon“ na rynku.

Zamieść również link Tracy to the editor. Gdy pojawi się strona z błędami, można wtedy kliknąć na nazwy plików i otworzą się one w edytorze z kursorem w odpowiedniej linii. Dowiedz się, jak skonfigurować system.

PHPStan

PHPStan to narzędzie, które wykrywa błędy logiczne w Twoim kodzie, zanim go uruchomisz.

Instalujemy go za pomocą programu Composer:

composer require --dev phpstan/phpstan-nette

Utwórz plik konfiguracyjny w projekcie phpstan.neon:

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

parameters:
	scanDirectories:
		- app

	level: 5

A potem niech analizuje klasy w folderze app/:

vendor/bin/phpstan analyse app

Obszerną dokumentację można znaleźć bezpośrednio na stronie PHPStan.

Code Checker

Code Checker sprawdzi i ewentualnie naprawi niektóre błędy formalne w Twoim kodzie źródłowym:

  • usuwa BOM
  • sprawdza ważność szablonów Latte
  • sprawdza ważność stron .neon, .php oraz .json
  • kontrole dla znaków kontrolnych
  • sprawdza czy plik jest zakodowany w UTF-8
  • sprawdza, czy nie ma błędnie napisanej strony /* @anotace */ (brak gwiazdki)
  • usuwa terminator ?> z plików PHP
  • usuwa prawe spacje i niepotrzebne linie na końcu pliku
  • normalizuje separatory linii do systemowych separatorów linii (jeśli podano opcję -l)

Kompozytor

Composer to narzędzie do zarządzania zależnościami w PHP. Pozwala nam zadeklarować dowolnie złożone zależności biblioteczne, a następnie instaluje je w naszym projekcie za nas.

Sprawdzanie wymagań

Było to narzędzie, które testowało środowisko uruchomieniowe serwera i informowało, czy (i w jakim zakresie) można wykorzystać framework. Obecnie Nette można używać na każdym serwerze, który posiada minimalną wymaganą wersję PHP.