Nette Documentation Preview

syntax
Editores & Ferramentas
**********************

.[perex]
Você pode ser um programador habilidoso, mas é com boas ferramentas que você se torna um mestre. Neste capítulo, você encontrará dicas sobre ferramentas importantes, editores e plugins.


Editor IDE
==========

Recomendamos fortemente o uso de um IDE completo para desenvolvimento, como PhpStorm, NetBeans, VS Code, e não apenas um editor de texto com suporte a PHP. A diferença é realmente fundamental. Não há razão para se contentar com um simples editor que, embora possa colorir a sintaxe, não atinge as capacidades de um IDE de ponta, que sugere com precisão, monitora erros, pode refatorar código e muito mais. Alguns IDEs são pagos, outros são até gratuitos.

**NetBeans IDE** já vem com suporte integrado para Nette, Latte e NEON.

**PhpStorm**: instale estes plugins em `Settings > Plugins > Marketplace`
- Nette framework helpers
- Latte
- NEON support
- Nette Tester

**VS Code**: encontre o plugin "Nette Latte + Neon" no marketplace.

Conecte também o Tracy ao seu editor. Ao exibir uma página de erro, você poderá clicar nos nomes dos arquivos e eles serão abertos no editor com o cursor na linha correspondente. Leia [como configurar o sistema|tracy:open-files-in-ide].


PHPStan
=======

PHPStan é uma ferramenta que detecta erros lógicos no código antes mesmo de você executá-lo.

Instalamos usando o Composer:

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

Criamos um arquivo de configuração `phpstan.neon` no projeto:

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

parameters:
	scanDirectories:
		- app

	level: 5
```

E, em seguida, deixamos que ele analise as classes na pasta `app/`:

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

Você encontrará documentação completa diretamente no [site do PHPStan |https://phpstan.org].


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

O [Code Checker|code-checker:] verifica e, opcionalmente, corrige alguns erros formais em seus códigos-fonte:

- remove [BOM |nette:glossary#BOM]
- verifica a validade dos templates [Latte |latte:]
- verifica a validade dos arquivos `.neon`, `.php` e `.json`
- verifica a ocorrência de [caracteres de controle |nette:glossary#Caracteres de controle]
- verifica se o arquivo está codificado em UTF-8
- verifica `/* @anotações */` escritas incorretamente (falta um asterisco)
- remove `?>` de fechamento em arquivos PHP
- remove espaços em branco à direita e linhas desnecessárias no final do arquivo
- normaliza os separadores de linha para os do sistema (se você usar a opção `-l`)


Composer
========

[Composer|best-practices:composer] é uma ferramenta para gerenciamento de dependências em PHP. Permite declarar dependências arbitrariamente complexas de bibliotecas individuais e, em seguida, as instala para nós em nosso projeto.


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

Era uma ferramenta que testava o ambiente de execução do servidor e informava se (e em que medida) o framework poderia ser usado. Atualmente, o Nette pode ser usado em qualquer servidor que tenha a versão mínima exigida do PHP.

{{sitename: Best Practices}}

Editores & Ferramentas

Você pode ser um programador habilidoso, mas é com boas ferramentas que você se torna um mestre. Neste capítulo, você encontrará dicas sobre ferramentas importantes, editores e plugins.

Editor IDE

Recomendamos fortemente o uso de um IDE completo para desenvolvimento, como PhpStorm, NetBeans, VS Code, e não apenas um editor de texto com suporte a PHP. A diferença é realmente fundamental. Não há razão para se contentar com um simples editor que, embora possa colorir a sintaxe, não atinge as capacidades de um IDE de ponta, que sugere com precisão, monitora erros, pode refatorar código e muito mais. Alguns IDEs são pagos, outros são até gratuitos.

NetBeans IDE já vem com suporte integrado para Nette, Latte e NEON.

PhpStorm: instale estes plugins em Settings > Plugins > Marketplace

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

VS Code: encontre o plugin „Nette Latte + Neon“ no marketplace.

Conecte também o Tracy ao seu editor. Ao exibir uma página de erro, você poderá clicar nos nomes dos arquivos e eles serão abertos no editor com o cursor na linha correspondente. Leia como configurar o sistema.

PHPStan

PHPStan é uma ferramenta que detecta erros lógicos no código antes mesmo de você executá-lo.

Instalamos usando o Composer:

composer require --dev phpstan/phpstan-nette

Criamos um arquivo de configuração phpstan.neon no projeto:

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

parameters:
	scanDirectories:
		- app

	level: 5

E, em seguida, deixamos que ele analise as classes na pasta app/:

vendor/bin/phpstan analyse app

Você encontrará documentação completa diretamente no site do PHPStan.

Code Checker

Code Checker verifica e, opcionalmente, corrige alguns erros formais em seus códigos-fonte:

  • remove BOM
  • verifica a validade dos templates Latte
  • verifica a validade dos arquivos .neon, .php.json
  • verifica a ocorrência de caracteres de controle
  • verifica se o arquivo está codificado em UTF-8
  • verifica /* @anotações */ escritas incorretamente (falta um asterisco)
  • remove ?> de fechamento em arquivos PHP
  • remove espaços em branco à direita e linhas desnecessárias no final do arquivo
  • normaliza os separadores de linha para os do sistema (se você usar a opção -l)

Composer

Composer é uma ferramenta para gerenciamento de dependências em PHP. Permite declarar dependências arbitrariamente complexas de bibliotecas individuais e, em seguida, as instala para nós em nosso projeto.

Requirements Checker

Era uma ferramenta que testava o ambiente de execução do servidor e informava se (e em que medida) o framework poderia ser usado. Atualmente, o Nette pode ser usado em qualquer servidor que tenha a versão mínima exigida do PHP.