Nette Documentation Preview

syntax
Szerkesztők és eszközök
***********************

.[perex]
Lehetsz ügyes programozó, de csak jó eszközökkel válsz mesterré. Ebben a fejezetben tippeket találsz fontos eszközökhöz, szerkesztőkhöz és bővítményekhez.


IDE szerkesztő
==============

Határozottan javasoljuk, hogy a fejlesztéshez teljes értékű IDE-t használj, mint például a PhpStorm, NetBeans, VS Code, és ne csak egy PHP támogatással rendelkező szövegszerkesztőt. A különbség valóban alapvető. Nincs ok megelégedni egy egyszerű szerkesztővel, amely ugyan tudja színezni a szintaxist, de nem éri el egy csúcskategóriás IDE képességeit, amely pontosan súg, figyeli a hibákat, képes refaktorálni a kódot és sok minden mást. Néhány IDE fizetős, mások pedig ingyenesek.

A **NetBeans IDE** beépített támogatással rendelkezik a Nette, Latte és NEON számára.

**PhpStorm**: telepítsd ezeket a bővítményeket a `Settings > Plugins > Marketplace` menüpontban:
- Nette framework helpers
- Latte
- NEON support
- Nette Tester

**VS Code**: keresd meg a marketplace-en a "Nette Latte + Neon" bővítményt.

Kapcsold össze a Tracy-t is a szerkesztővel. Amikor egy hibaoldal jelenik meg, rákattinthatsz a fájlnevekre, és azok megnyílnak a szerkesztőben a megfelelő sorra állított kurzorral. Olvasd el, [hogyan konfiguráld a rendszert |tracy:open-files-in-ide].


PHPStan
=======

A PHPStan egy eszköz, amely logikai hibákat tár fel a kódban, mielőtt futtatnád azt.

Telepítsük a Composer segítségével:

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

Hozzunk létre egy konfigurációs fájlt a projektben `phpstan.neon` néven:

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

parameters:
	scanDirectories:
		- app

	level: 5
```

Majd futtassuk az elemzést az `app/` mappában lévő osztályokon:

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

Kimerítő dokumentációt találsz közvetlenül a [PHPStan oldalán |https://phpstan.org].


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

A [Code Checker|code-checker:] ellenőrzi és szükség esetén kijavítja a forráskódok néhány formai hibáját:

- eltávolítja a [BOM |nette:glossary#BOM]-ot
- ellenőrzi a [Latte |latte:] sablonok érvényességét
- ellenőrzi a `.neon`, `.php` és `.json` fájlok érvényességét
- ellenőrzi a [vezérlőkarakterek |nette:glossary#Vezérlő karakterek] előfordulását
- ellenőrzi, hogy a fájl UTF-8 kódolású-e
- ellenőrzi a hibásan írt `/* @anotace */` (hiányzik a csillag)
- eltávolítja a záró `?>` PHP fájlokból
- eltávolítja a jobb oldali szóközöket és a felesleges sorokat a fájl végéről
- normalizálja a sorelválasztókat a rendszer alapértelmezettjére (ha megadja a `-l` opciót)


Composer
========

A [Composer |best-practices:composer] egy függőségkezelő eszköz PHP-hez. Lehetővé teszi számunkra, hogy tetszőlegesen összetett függőségeket deklaráljunk az egyes könyvtárakhoz, majd telepíti őket a projektünkbe.


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

Ez egy eszköz volt, amely tesztelte a szerver futási környezetét, és tájékoztatott arról, hogy (és milyen mértékben) lehet használni a keretrendszert. Jelenleg a Nette minden olyan szerveren használható, amely rendelkezik a minimálisan szükséges PHP verzióval.

{{sitename: Best Practices}}

Szerkesztők és eszközök

Lehetsz ügyes programozó, de csak jó eszközökkel válsz mesterré. Ebben a fejezetben tippeket találsz fontos eszközökhöz, szerkesztőkhöz és bővítményekhez.

IDE szerkesztő

Határozottan javasoljuk, hogy a fejlesztéshez teljes értékű IDE-t használj, mint például a PhpStorm, NetBeans, VS Code, és ne csak egy PHP támogatással rendelkező szövegszerkesztőt. A különbség valóban alapvető. Nincs ok megelégedni egy egyszerű szerkesztővel, amely ugyan tudja színezni a szintaxist, de nem éri el egy csúcskategóriás IDE képességeit, amely pontosan súg, figyeli a hibákat, képes refaktorálni a kódot és sok minden mást. Néhány IDE fizetős, mások pedig ingyenesek.

NetBeans IDE beépített támogatással rendelkezik a Nette, Latte és NEON számára.

PhpStorm: telepítsd ezeket a bővítményeket a Settings > Plugins > Marketplace menüpontban:

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

VS Code: keresd meg a marketplace-en a „Nette Latte + Neon“ bővítményt.

Kapcsold össze a Tracy-t is a szerkesztővel. Amikor egy hibaoldal jelenik meg, rákattinthatsz a fájlnevekre, és azok megnyílnak a szerkesztőben a megfelelő sorra állított kurzorral. Olvasd el, hogyan konfiguráld a rendszert.

PHPStan

A PHPStan egy eszköz, amely logikai hibákat tár fel a kódban, mielőtt futtatnád azt.

Telepítsük a Composer segítségével:

composer require --dev phpstan/phpstan-nette

Hozzunk létre egy konfigurációs fájlt a projektben phpstan.neon néven:

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

parameters:
	scanDirectories:
		- app

	level: 5

Majd futtassuk az elemzést az app/ mappában lévő osztályokon:

vendor/bin/phpstan analyse app

Kimerítő dokumentációt találsz közvetlenül a PHPStan oldalán.

Code Checker

Code Checker ellenőrzi és szükség esetén kijavítja a forráskódok néhány formai hibáját:

  • eltávolítja a BOM-ot
  • ellenőrzi a Latte sablonok érvényességét
  • ellenőrzi a .neon, .php és .json fájlok érvényességét
  • ellenőrzi a vezérlőkarakterek előfordulását
  • ellenőrzi, hogy a fájl UTF-8 kódolású-e
  • ellenőrzi a hibásan írt /* @anotace */ (hiányzik a csillag)
  • eltávolítja a záró ?> PHP fájlokból
  • eltávolítja a jobb oldali szóközöket és a felesleges sorokat a fájl végéről
  • normalizálja a sorelválasztókat a rendszer alapértelmezettjére (ha megadja a -l opciót)

Composer

Composer egy függőségkezelő eszköz PHP-hez. Lehetővé teszi számunkra, hogy tetszőlegesen összetett függőségeket deklaráljunk az egyes könyvtárakhoz, majd telepíti őket a projektünkbe.

Requirements Checker

Ez egy eszköz volt, amely tesztelte a szerver futási környezetét, és tájékoztatott arról, hogy (és milyen mértékben) lehet használni a keretrendszert. Jelenleg a Nette minden olyan szerveren használható, amely rendelkezik a minimálisan szükséges PHP verzióval.