Nette Documentation Preview

syntax
Uredniki in orodja
******************

.[perex]
Lahko ste spreten programer, a le z dobrimi orodji boste postali mojster. V tem poglavju boste našli nasvete o pomembnih orodjih, urejevalnikih in vtičnikih.


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

Priporočamo, da za razvoj uporabljate celovit IDE, kot so PhpStorm, NetBeans, VS Code, in ne le urejevalnik besedila s podporo za PHP. Razlika je res bistvena. Ni razloga, da bi se zadovoljili s klasičnim urejevalnikom z označevanjem sintakse, saj ne dosega zmogljivosti IDE z natančnim predlaganjem kode, ki lahko kodo refaktorizira in še več. Nekateri IDE so plačljivi, drugi so brezplačni.

**NetBeans IDE** ima vgrajeno podporo za Nette, Latte in NEON.

**PhpStorm**: namestite te vtičnike v `Settings > Plugins > Marketplace`:
- Pomočniki ogrodja Nette
- Latte
- Podpora za NEON
- Nette Tester

**VS koda**: poiščite vtičnik "Nette Latte + Neon" na tržnici.

Prav tako povežite Tracy z urejevalnikom. Ko se prikaže stran z napako, lahko kliknete na imena datotek in te se bodo odprle v urejevalniku s kazalcem na ustrezni vrstici. Naučite se, [kako konfigurirati sistem |tracy:open-files-in-ide].


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

PHPStan je orodje, ki odkriva logične napake v vaši kodi, preden jo zaženete.

Namestite ga prek programa Composer:

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

Ustvarite konfiguracijsko datoteko `phpstan.neon` v projektu:

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

parameters:
	scanDirectories:
		- app

	level: 5
```

Nato naj analizira razrede v mapi `app/`:

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

Izčrpno dokumentacijo lahko najdete neposredno na spletnem mestu [PHPStan |https://phpstan.org].


Preverjanje kode .[#toc-code-checker]
=====================================

[Code Checker |code-checker:] preveri in po možnosti popravi nekatere formalne napake v vaši izvorni kodi.

- odstrani [BOM |nette:glossary#bom]
- preveri veljavnost predlog [Latte |latte:]
- preveri veljavnost datotek `.neon`, `.php` in `.json`
- preveri [kontrolne znake |nette:glossary#control characters]
- preveri, ali je datoteka kodirana v UTF-8
- preveri napačno zapisano `/* @annotations */` (manjka druga zvezdica)
- odstrani končne oznake PHP `?>` v datotekah PHP
- na koncu datoteke odstrani zaključni beli prostor in nepotrebne prazne vrstice
- normalizira konce vrstic na privzete sistemske (s parametrom `-l` )


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

[Composer |Composer] je orodje za upravljanje odvisnosti v PHP. Omogoča nam, da prijavimo odvisnosti knjižnic, in jih namesto nas namesti v naš projekt.


Preverjanje zahtev .[#toc-requirements-checker]
===============================================

To je bilo orodje, ki je preverjalo okolje, v katerem deluje strežnik, in obveščalo o tem, ali (in v kolikšni meri) je mogoče uporabiti ogrodje. Trenutno se lahko Nette uporablja v vsakem strežniku, ki ima najmanjšo zahtevano različico PHP.

{{sitename: Best Practices}}

Uredniki in orodja

Lahko ste spreten programer, a le z dobrimi orodji boste postali mojster. V tem poglavju boste našli nasvete o pomembnih orodjih, urejevalnikih in vtičnikih.

Urejevalnik IDE

Priporočamo, da za razvoj uporabljate celovit IDE, kot so PhpStorm, NetBeans, VS Code, in ne le urejevalnik besedila s podporo za PHP. Razlika je res bistvena. Ni razloga, da bi se zadovoljili s klasičnim urejevalnikom z označevanjem sintakse, saj ne dosega zmogljivosti IDE z natančnim predlaganjem kode, ki lahko kodo refaktorizira in še več. Nekateri IDE so plačljivi, drugi so brezplačni.

NetBeans IDE ima vgrajeno podporo za Nette, Latte in NEON.

PhpStorm: namestite te vtičnike v Settings > Plugins > Marketplace:

  • Pomočniki ogrodja Nette
  • Latte
  • Podpora za NEON
  • Nette Tester

VS koda: poiščite vtičnik „Nette Latte + Neon“ na tržnici.

Prav tako povežite Tracy z urejevalnikom. Ko se prikaže stran z napako, lahko kliknete na imena datotek in te se bodo odprle v urejevalniku s kazalcem na ustrezni vrstici. Naučite se, kako konfigurirati sistem.

PHPStan

PHPStan je orodje, ki odkriva logične napake v vaši kodi, preden jo zaženete.

Namestite ga prek programa Composer:

composer require --dev phpstan/phpstan-nette

Ustvarite konfiguracijsko datoteko phpstan.neon v projektu:

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

parameters:
	scanDirectories:
		- app

	level: 5

Nato naj analizira razrede v mapi app/:

vendor/bin/phpstan analyse app

Izčrpno dokumentacijo lahko najdete neposredno na spletnem mestu PHPStan.

Preverjanje kode

Code Checker preveri in po možnosti popravi nekatere formalne napake v vaši izvorni kodi.

  • odstrani BOM
  • preveri veljavnost predlog Latte
  • preveri veljavnost datotek .neon, .php in .json
  • preveri kontrolne znake
  • preveri, ali je datoteka kodirana v UTF-8
  • preveri napačno zapisano /* @annotations */ (manjka druga zvezdica)
  • odstrani končne oznake PHP ?> v datotekah PHP
  • na koncu datoteke odstrani zaključni beli prostor in nepotrebne prazne vrstice
  • normalizira konce vrstic na privzete sistemske (s parametrom -l )

Composer

Composer je orodje za upravljanje odvisnosti v PHP. Omogoča nam, da prijavimo odvisnosti knjižnic, in jih namesto nas namesti v naš projekt.

Preverjanje zahtev

To je bilo orodje, ki je preverjalo okolje, v katerem deluje strežnik, in obveščalo o tem, ali (in v kolikšni meri) je mogoče uporabiti ogrodje. Trenutno se lahko Nette uporablja v vsakem strežniku, ki ima najmanjšo zahtevano različico PHP.