Nette Code Checker ****************** .[perex] Το [Code Checker |https://github.com/nette/code-checker] ελέγχει τα πηγαία αρχεία σας για τυπικά σφάλματα, όπως ένα αόρατο BOM, χαρακτήρες ελέγχου, κατεστραμμένη κωδικοποίηση ή μη έγκυρη σύνταξη αρχείων PHP, Latte, NEON, JSON και YAML, και μπορεί να τα διορθώσει αυτόματα. Εγκατάσταση =========== Εγκαταστήστε το καθολικά μέσω του Composer: ```shell composer global require nette/code-checker ``` Βεβαιωθείτε ότι ο καθολικός σας κατάλογος `bin` του Composer βρίσκεται στο [`$PATH` σας |https://getcomposer.org/doc/03-cli.md#global]. Η εντολή `code-checker` είναι τότε διαθέσιμη από οπουδήποτε, σε οποιοδήποτε λειτουργικό σύστημα. Εναλλακτικά, εγκαταστήστε το ως αυτόνομο έργο: ```shell composer create-project nette/code-checker ``` Απαιτεί PHP 8.0 ή νεότερη έκδοση. Χρήση ===== Από προεπιλογή, το Code Checker εκτελείται σε κατάσταση μόνο ανάγνωσης και απλώς αναφέρει τα προβλήματα που βρίσκει: ```shell code-checker ``` Για να διορθώσετε πραγματικά τα αρχεία, προσθέστε το `--fix`. Δημιουργήστε πρώτα αντίγραφα ασφαλείας των αρχείων σας ή εκτελέστε το σε ένα καθαρό δέντρο εργασίας, ώστε να μπορείτε να ελέγξετε τις αλλαγές στη συνέχεια με το `git diff`: ```shell code-checker --fix ``` Μπορείτε να περιορίσετε τη σάρωση σε μια συγκεκριμένη διαδρομή, να παραλείψετε αρχεία ή να εκτελέσετε ταχύτερους ελέγχους μόνο σύνταξης: ```shell code-checker -d src --ignore "temp/*" code-checker --only-syntax ``` Σε κατάσταση μόνο ανάγνωσης, το εργαλείο τερματίζεται με κωδικό `0` όταν όλα είναι εντάξει και `1` όταν βρεθεί οποιοδήποτε πρόβλημα, οπότε ταιριάζει ωραία σε αγωγούς CI. Πλήρης λίστα επιλογών: ``` 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 ``` Τι κάνει το Code Checker ======================== - ελέγχει τη σύνταξη των templates [Latte |latte:] και των αρχείων `.php`, `.neon` και `.json` - αφαιρεί το [BOM |nette:glossary#BOM] - επαληθεύει ότι τα αρχεία είναι έγκυρα UTF-8 - ελέγχει για [χαρακτήρες ελέγχου |nette:glossary#Control characters] - εντοπίζει κακοδιατυπωμένα σχόλια phpDoc (π.χ. `/* @var` αντί για `/** @var`) - επιβάλλει στηλοθέτες για στοίχιση σε αρχεία PHP, CSS, JS και TS, και κενά σε YAML - αφαιρεί τα τελικά κενά και τις κενές γραμμές στο τέλος των αρχείων - κανονικοποιεί τους τερματισμούς γραμμών στην προεπιλογή του συστήματος (με την παράμετρο `-l`)

Nette Code Checker

Το Code Checker ελέγχει τα πηγαία αρχεία σας για τυπικά σφάλματα, όπως ένα αόρατο BOM, χαρακτήρες ελέγχου, κατεστραμμένη κωδικοποίηση ή μη έγκυρη σύνταξη αρχείων PHP, Latte, NEON, JSON και YAML, και μπορεί να τα διορθώσει αυτόματα.

Εγκατάσταση

Εγκαταστήστε το καθολικά μέσω του Composer:

composer global require nette/code-checker

Βεβαιωθείτε ότι ο καθολικός σας κατάλογος bin του Composer βρίσκεται στο $PATH σας. Η εντολή code-checker είναι τότε διαθέσιμη από οπουδήποτε, σε οποιοδήποτε λειτουργικό σύστημα.

Εναλλακτικά, εγκαταστήστε το ως αυτόνομο έργο:

composer create-project nette/code-checker

Απαιτεί PHP 8.0 ή νεότερη έκδοση.

Χρήση

Από προεπιλογή, το Code Checker εκτελείται σε κατάσταση μόνο ανάγνωσης και απλώς αναφέρει τα προβλήματα που βρίσκει:

code-checker

Για να διορθώσετε πραγματικά τα αρχεία, προσθέστε το --fix. Δημιουργήστε πρώτα αντίγραφα ασφαλείας των αρχείων σας ή εκτελέστε το σε ένα καθαρό δέντρο εργασίας, ώστε να μπορείτε να ελέγξετε τις αλλαγές στη συνέχεια με το git diff:

code-checker --fix

Μπορείτε να περιορίσετε τη σάρωση σε μια συγκεκριμένη διαδρομή, να παραλείψετε αρχεία ή να εκτελέσετε ταχύτερους ελέγχους μόνο σύνταξης:

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

Σε κατάσταση μόνο ανάγνωσης, το εργαλείο τερματίζεται με κωδικό 0 όταν όλα είναι εντάξει και 1 όταν βρεθεί οποιοδήποτε πρόβλημα, οπότε ταιριάζει ωραία σε αγωγούς CI.

Πλήρης λίστα επιλογών:

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

Τι κάνει το Code Checker

ελέγχει τη σύνταξη των templates Latte και των αρχείων .php, .neon και .json
αφαιρεί το BOM
επαληθεύει ότι τα αρχεία είναι έγκυρα UTF-8
ελέγχει για χαρακτήρες ελέγχου
εντοπίζει κακοδιατυπωμένα σχόλια phpDoc (π.χ. /* @var αντί για /** @var)
επιβάλλει στηλοθέτες για στοίχιση σε αρχεία PHP, CSS, JS και TS, και κενά σε YAML
αφαιρεί τα τελικά κενά και τις κενές γραμμές στο τέλος των αρχείων
κανονικοποιεί τους τερματισμούς γραμμών στην προεπιλογή του συστήματος (με την παράμετρο -l)

Nette Documentation Preview

Nette Code Checker

Εγκατάσταση

Χρήση

Τι κάνει το Code Checker