Nette Code Checker
******************

.[perex]
[Code Checker |https://github.com/nette/code-checker] controlla i tuoi file sorgente alla ricerca di difetti formali come un BOM invisibile, caratteri di controllo, codifica errata o sintassi non valida nei file PHP, Latte, NEON, JSON e YAML, e può correggerli automaticamente.


Installazione
=============

Installalo globalmente tramite Composer:

```shell
composer global require nette/code-checker
```

Assicurati che la directory globale `bin` di Composer sia nel [tuo `$PATH` |https://getcomposer.org/doc/03-cli.md#global]. Il comando `code-checker` è quindi disponibile da qualsiasi posizione, su qualsiasi sistema operativo.

In alternativa, installalo come progetto autonomo:

```shell
composer create-project nette/code-checker
```

Richiede PHP 8.0 o superiore.


Utilizzo
========

Per impostazione predefinita, Code Checker viene eseguito in modalità di sola lettura e segnala solo i problemi che trova:

```shell
code-checker
```

Per riparare effettivamente i file, aggiungi `--fix`. Esegui prima un backup dei file, oppure eseguilo su un albero di lavoro pulito così potrai rivedere le modifiche in seguito con `git diff`:

```shell
code-checker --fix
```

Puoi limitare la scansione a un percorso specifico, saltare file o eseguire controlli più rapidi solo sulla sintassi:

```shell
code-checker -d src --ignore "temp/*"
code-checker --only-syntax
```

In modalità di sola lettura lo strumento esce con codice `0` quando tutto è a posto e `1` quando viene trovato un problema, quindi si integra perfettamente nelle pipeline CI.

Elenco completo delle opzioni:

```
Usage: code-checker [options]

Options:
	-d <path>             Folder or file to scan (default: current directory)
	-i | --ignore <mask>  Files to ignore
	-f | --fix            Fix the files
	-l | --eol            Normalize line endings to the system default
	--only-syntax         Check syntax only (faster)
	--no-progress         Do not show progress dots
	--version             Show version
```


Cosa fa Code Checker
====================

- controlla la sintassi dei template [Latte |latte:] e dei file `.php`, `.neon` e `.json`
- rimuove il [BOM |nette:glossary#BOM]
- verifica che i file siano UTF-8 validi
- controlla la presenza di [caratteri di controllo |nette:glossary#Caratteri di controllo]
- rileva commenti phpDoc malformati (es. `/* @var` invece di `/** @var`)
- impone l'indentazione con tabulazioni nei file PHP, CSS, JS e TS, e con spazi in YAML
- rimuove gli spazi finali e le righe vuote alla fine dei file
- normalizza i fine riga al valore predefinito di sistema (con il parametro `-l`)