Skip to content

Commit f8f45b1

Browse files
committed
moved editor-and-tools to tools:ide
1 parent 16e2ccc commit f8f45b1

102 files changed

Lines changed: 1494 additions & 1494 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

best-practices/bg/@home.texy

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,6 @@ Nette Приложения
4242
- [Защо Nette използва PascalCase нотация за константи? |https://blog.nette.org/bg/for-less-screaming-in-the-code]
4343
- [Защо Nette не използва суфикс Interface? |https://blog.nette.org/bg/prefixes-and-suffixes-do-not-belong-in-interface-names]
4444
- [Composer: съвети за използване |composer]
45-
- [Съвети за редактори & инструменти |editors-and-tools]
4645
- [Въведение в обектно-ориентираното програмиране |nette:introduction-to-object-oriented-programming]
4746

4847
</div>
Lines changed: 1 addition & 84 deletions
Original file line numberDiff line numberDiff line change
@@ -1,84 +1 @@
1-
Редактори & инструменти
2-
***********************
3-
4-
.[perex]
5-
Може да сте опитен програмист, но само с добри инструменти ще станете майстор. В тази глава ще намерите съвети за важни инструменти, редактори и плъгини.
6-
7-
8-
IDE редактор
9-
============
10-
11-
Определено препоръчваме да използвате пълнофункционално IDE за разработка, като PhpStorm, NetBeans, VS Code, а не само текстов редактор с поддръжка на PHP. Разликата е наистина съществена. Няма причина да се задоволявате само с редактор, който може да оцветява синтаксиса, но не достига възможностите на водещо IDE, което точно подсказва, следи за грешки, може да рефакторира код и много повече. Някои IDE са платени, други дори безплатни.
12-
13-
**NetBeans IDE** има вградена поддръжка за Nette, Latte и NEON.
14-
15-
**PhpStorm**: инсталирайте тези плъгини в `Settings > Plugins > Marketplace`
16-
- Nette framework helpers
17-
- Latte
18-
- NEON support
19-
- Nette Tester
20-
21-
**VS Code**: намерете плъгина "Nette Latte + Neon" в marketplace.
22-
23-
Свържете също Tracy с редактора си. Когато се покаже страница с грешка, ще можете да кликнете върху имената на файловете и те ще се отворят в редактора с курсор на съответния ред. Прочетете [как да конфигурирате системата |tracy:open-files-in-ide].
24-
25-
26-
PHPStan
27-
=======
28-
29-
PHPStan е инструмент, който открива логически грешки в кода, преди да го стартирате.
30-
31-
Инсталираме го с помощта на Composer:
32-
33-
```shell
34-
composer require --dev phpstan/phpstan-nette
35-
```
36-
37-
Създаваме конфигурационен файл `phpstan.neon` в проекта:
38-
39-
```neon
40-
includes:
41-
- vendor/phpstan/phpstan-nette/extension.neon
42-
43-
parameters:
44-
scanDirectories:
45-
- app
46-
47-
level: 5
48-
```
49-
50-
И след това го оставяме да анализира класовете в папката `app/`:
51-
52-
```shell
53-
vendor/bin/phpstan analyse app
54-
```
55-
56-
Изчерпателна документация можете да намерите директно на [уебсайта на PHPStan |https://phpstan.org].
57-
58-
59-
Code Checker
60-
============
61-
62-
[Code Checker|tools:code-checker] проверява и евентуално коригира някои от формалните грешки във вашия изходен код:
63-
64-
- премахва [BOM |nette:glossary#BOM]
65-
- проверява валидността на [Latte |latte:] шаблоните
66-
- проверява валидността на файловете `.neon`, `.php` и `.json`
67-
- проверява за наличие на [контролни знаци |nette:glossary#Контролни знаци]
68-
- проверява дали файлът е кодиран в UTF-8
69-
- проверява за неправилно записани `/* @anotace */` (липсва звездичка)
70-
- премахва затварящия таг `?>` от PHP файловете
71-
- премахва интервалите в края на реда и ненужните редове в края на файла
72-
- нормализира разделителите на редове до системните (ако посочите опцията `-l`)
73-
74-
75-
Composer
76-
========
77-
78-
[Composer |Composer] е инструмент за управление на зависимости в PHP. Позволява ни да декларираме произволно сложни зависимости на отделни библиотеки и след това ги инсталира вместо нас в нашия проект.
79-
80-
81-
Requirements Checker
82-
====================
83-
84-
Това беше инструмент, който тестваше средата за изпълнение на сървъра и информираше дали (и до каква степен) е възможно да се използва framework-ът. В момента Nette може да се използва на всеки сървър, който има минималната изисквана версия на PHP.
1+
{{redirect: tools:bg:ide}}

best-practices/cs/@home.texy

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,6 @@ Obecné
4343
- [Proč Nette používá PascalCase notaci konstant? |https://blog.nette.org/cs/za-mene-kriku-v-kodu]
4444
- [Proč Nette nepoužívá příponu Interface? |https://blog.nette.org/cs/predpony-a-pripony-do-nazvu-rozhrani-nepatri]
4545
- [Composer: tipy pro použití |composer]
46-
- [Tipy na editory & nástroje |editors-and-tools]
4746
- [Úvod do objektově orientovaného programování |nette:introduction-to-object-oriented-programming]
4847

4948
</div>
Lines changed: 1 addition & 83 deletions
Original file line numberDiff line numberDiff line change
@@ -1,83 +1 @@
1-
Editory & nástroje
2-
******************
3-
4-
.[perex]
5-
Můžete být zdatný programátor, ale teprve s dobrými nástroji se z vás stane mistr. V této kapitole najdete tipy na důležité nástroje, editory a pluginy.
6-
7-
8-
IDE editor
9-
==========
10-
11-
Rozhodně doporučujeme pro vývoj používat plnohodnotné IDE, jako je třeba PhpStorm, NetBeans, VS Code, a nikoliv jen textový editor s podporou PHP. Rozdíl je opravdu zásadní. Není důvod se spokojit s pouhým editorem, který sice umí obarvovat syntaxi, ale nedosahuje možností špičkového IDE, které přesně napovídá, hlídá chyby, umí refaktorovat kód a spoustu dalšího. Některé IDE jsou placené, jiné dokonce zdarma.
12-
13-
**NetBeans IDE** má podporu pro Nette, Latte a NEON už vestavěnou.
14-
15-
**PhpStorm**: nainstalujte si tyto pluginy v `Settings > Plugins > Marketplace`
16-
- [Nette |https://plugins.jetbrains.com/plugin/28342-nette]
17-
- [Latte |https://plugins.jetbrains.com/plugin/24218-latte-support] nebo [Latte Pro |https://plugins.jetbrains.com/plugin/19661-latte-pro]
18-
- [NEON |https://plugins.jetbrains.com/plugin/28338-neon] nebo [NEON / Nette support |https://plugins.jetbrains.com/plugin/18387-neon-nette-support]
19-
- Nette Tester
20-
21-
**VS Code**: najděte v marketplace "Nette Latte + Neon" plugin.
22-
23-
Také si propojte Tracy s editorem. Při zobrazení chybové stránky pak půjde kliknout na jména souborů a ty se otevřou v editoru s kurzorem na příslušné řádce. Přečtěte si, [jak systém nakonfigurovat|tracy:open-files-in-ide].
24-
25-
26-
PHPStan
27-
=======
28-
29-
PHPStan je nástroj, který odhalí logické chyby v kódu dřív, než jej spustíte.
30-
31-
Nainstalujeme jej pomocí Composeru:
32-
33-
```shell
34-
composer require --dev phpstan/phpstan
35-
```
36-
37-
Vytvoříme v projektu konfigurační soubor `phpstan.neon`:
38-
39-
```neon
40-
parameters:
41-
paths:
42-
- app
43-
44-
level: 8
45-
```
46-
47-
A následně jej necháme zanalyzovat třídy ve složce `app/`:
48-
49-
```shell
50-
vendor/bin/phpstan analyse
51-
```
52-
53-
Vyčerpávající dokumentaci najdete přímo na [stránkách PHPStan |https://phpstan.org].
54-
55-
Aby byl PHPStan na Nette kódu ještě chytřejší, nainstalujte si také [Nette PHPStan Rules |tools:phpstan-rules]. Přidá přesnější návratové typy Nette helperů, zúží typy komponent a formulářových prvků, odstraní nemožné `|false`/`|null` z mnoha nativních PHP funkcí a ztiší známá falešná hlášení specifická pro Nette.
56-
57-
58-
Code Checker
59-
============
60-
61-
[Code Checker|tools:code-checker] zkontroluje a případně opraví některé z formálních chyb ve vašich zdrojových kódech:
62-
63-
- odstraňuje [BOM |nette:glossary#BOM]
64-
- kontroluje validitu [Latte |latte:] šablon
65-
- kontroluje validitu souborů `.neon`, `.php` a `.json`
66-
- kontroluje výskyt [kontrolních znaků |nette:glossary#Kontrolní znaky]
67-
- kontroluje, zda je soubor kódován v UTF-8
68-
- kontroluje chybně zapsané `/* @anotace */` (chybí hvězdička)
69-
- odstraňuje ukončovací `?>` u PHP souborů
70-
- odstraňuje pravostranné mezery a zbytečné řádky na konci souboru
71-
- normalizuje oddělovače řádků na systémové (pokud uvedete volbu `-l`)
72-
73-
74-
Composer
75-
========
76-
77-
[Composer] je nástroj na správu závislostí v PHP. Dovoluje nám deklarovat libovolně složité závislosti jednotlivých knihoven a pak je za nás nainstaluje do našeho projektu.
78-
79-
80-
Requirements Checker
81-
====================
82-
83-
Šlo o nástroj, který testoval běhové prostředí serveru a informoval, zda (a do jaké míry) je možné framework používat. V současnosti je Nette možné používat na každém serveru, který má minimální požadovanou verzi PHP.
1+
{{redirect: tools:cs:ide}}

best-practices/de/@home.texy

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,6 @@ Allgemeines
4242
- [Warum Nette die PascalCase-Notation für Konstanten verwendet |https://blog.nette.org/de/for-less-screaming-in-the-code]
4343
- [Warum Nette das Interface-Suffix nicht verwendet |https://blog.nette.org/de/prefixes-and-suffixes-do-not-belong-in-interface-names]
4444
- [Composer: Tipps zur Verwendung |composer]
45-
- [Tipps für Editoren & Werkzeuge |editors-and-tools]
4645
- [Einführung in die objektorientierte Programmierung |nette:introduction-to-object-oriented-programming]
4746

4847
</div>
Lines changed: 1 addition & 84 deletions
Original file line numberDiff line numberDiff line change
@@ -1,84 +1 @@
1-
Editoren & Werkzeuge
2-
********************
3-
4-
.[perex]
5-
Sie können ein geschickter Programmierer sein, aber erst mit guten Werkzeugen werden Sie zum Meister. In diesem Kapitel finden Sie Tipps zu wichtigen Werkzeugen, Editoren und Plugins.
6-
7-
8-
IDE-Editor
9-
==========
10-
11-
Wir empfehlen dringend, für die Entwicklung eine vollwertige IDE wie PhpStorm, NetBeans, VS Code zu verwenden und nicht nur einen Texteditor mit PHP-Unterstützung. Der Unterschied ist wirklich grundlegend. Es gibt keinen Grund, sich mit einem reinen Editor zufrieden zu geben, der zwar Syntax hervorheben kann, aber nicht die Möglichkeiten einer Spitzen-IDE erreicht, die präzise Vorschläge macht, Fehler überwacht, Code refaktorieren kann und vieles mehr. Einige IDEs sind kostenpflichtig, andere sogar kostenlos.
12-
13-
**NetBeans IDE** hat bereits integrierte Unterstützung für Nette, Latte und NEON.
14-
15-
**PhpStorm**: Installieren Sie diese Plugins unter `Settings > Plugins > Marketplace`
16-
- Nette framework helpers
17-
- Latte
18-
- NEON support
19-
- Nette Tester
20-
21-
**VS Code**: Suchen Sie im Marketplace nach dem Plugin "Nette Latte + Neon".
22-
23-
Verbinden Sie auch Tracy mit dem Editor. Bei der Anzeige einer Fehlerseite können Sie dann auf Dateinamen klicken und diese werden im Editor mit dem Cursor an der entsprechenden Zeile geöffnet. Lesen Sie, [wie das System konfiguriert wird|tracy:open-files-in-ide].
24-
25-
26-
PHPStan
27-
=======
28-
29-
PHPStan ist ein Werkzeug, das logische Fehler im Code aufdeckt, bevor Sie ihn ausführen.
30-
31-
Wir installieren es mit Composer:
32-
33-
```shell
34-
composer require --dev phpstan/phpstan-nette
35-
```
36-
37-
Wir erstellen im Projekt eine Konfigurationsdatei `phpstan.neon`:
38-
39-
```neon
40-
includes:
41-
- vendor/phpstan/phpstan-nette/extension.neon
42-
43-
parameters:
44-
scanDirectories:
45-
- app
46-
47-
level: 5
48-
```
49-
50-
Und lassen es anschließend die Klassen im Ordner `app/` analysieren:
51-
52-
```shell
53-
vendor/bin/phpstan analyse app
54-
```
55-
56-
Eine ausführliche Dokumentation finden Sie direkt auf den [PHPStan-Seiten |https://phpstan.org].
57-
58-
59-
Code Checker
60-
============
61-
62-
Der [Code Checker|tools:code-checker] überprüft und korrigiert gegebenenfalls einige formale Fehler in Ihren Quellcodes:
63-
64-
- entfernt [BOM |nette:glossary#BOM]
65-
- überprüft die Gültigkeit von [Latte |latte:]-Templates
66-
- überprüft die Gültigkeit von `.neon`-, `.php`- und `.json`-Dateien
67-
- überprüft das Vorkommen von [Steuerzeichen |nette:glossary#Steuerzeichen]
68-
- überprüft, ob die Datei in UTF-8 kodiert ist
69-
- überprüft falsch geschriebene `/* @annotation */` (Stern fehlt)
70-
- entfernt abschließende `?>` bei PHP-Dateien
71-
- entfernt Leerzeichen am Zeilenende und unnötige Zeilen am Ende der Datei
72-
- normalisiert Zeilentrenner auf Systemstandard (wenn Sie die Option `-l` angeben)
73-
74-
75-
Composer
76-
========
77-
78-
[Composer] ist ein Werkzeug zur Verwaltung von Abhängigkeiten in PHP. Es ermöglicht uns, beliebig komplexe Abhängigkeiten einzelner Bibliotheken zu deklarieren und diese dann für uns in unser Projekt zu installieren.
79-
80-
81-
Requirements Checker
82-
====================
83-
84-
Dies war ein Werkzeug, das die Laufzeitumgebung des Servers testete und informierte, ob (und inwieweit) das Framework verwendet werden kann. Derzeit kann Nette auf jedem Server verwendet werden, der die minimal erforderliche PHP-Version hat.
1+
{{redirect: tools:de:ide}}

best-practices/el/@home.texy

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,6 @@
4242
- [Γιατί το Nette χρησιμοποιεί τη σημειογραφία PascalCase για σταθερές; |https://blog.nette.org/el/for-less-screaming-in-the-code]
4343
- [Γιατί το Nette δεν χρησιμοποιεί το επίθημα Interface; |https://blog.nette.org/el/prefixes-and-suffixes-do-not-belong-in-interface-names]
4444
- [Composer: συμβουλές χρήσης |composer]
45-
- [Συμβουλές για editors & εργαλεία |editors-and-tools]
4645
- [Εισαγωγή στον αντικειμενοστρεφή προγραμματισμό |nette:introduction-to-object-oriented-programming]
4746

4847
</div>
Lines changed: 1 addition & 84 deletions
Original file line numberDiff line numberDiff line change
@@ -1,84 +1 @@
1-
Επεξεργαστές & εργαλεία
2-
***********************
3-
4-
.[perex]
5-
Μπορεί να είστε ένας ικανός προγραμματιστής, αλλά μόνο με καλά εργαλεία γίνεστε μάστορας. Σε αυτό το κεφάλαιο θα βρείτε συμβουλές για σημαντικά εργαλεία, επεξεργαστές και plugins.
6-
7-
8-
IDE editor
9-
==========
10-
11-
Συνιστούμε ανεπιφύλακτα τη χρήση ενός πλήρους IDE για την ανάπτυξη, όπως το PhpStorm, το NetBeans, το VS Code, και όχι απλώς ενός επεξεργαστή κειμένου με υποστήριξη PHP. Η διαφορά είναι πραγματικά θεμελιώδης. Δεν υπάρχει λόγος να αρκεστείτε σε έναν απλό επεξεργαστή που, αν και μπορεί να χρωματίζει τη σύνταξη, δεν φτάνει τις δυνατότητες ενός κορυφαίου IDE, το οποίο προτείνει με ακρίβεια, ελέγχει για σφάλματα, μπορεί να αναδιαμορφώσει τον κώδικα και πολλά άλλα. Ορισμένα IDE είναι επί πληρωμή, άλλα είναι ακόμη και δωρεάν.
12-
13-
Το **NetBeans IDE** έχει ενσωματωμένη υποστήριξη για Nette, Latte και NEON.
14-
15-
**PhpStorm**: εγκαταστήστε αυτά τα plugins στο `Settings > Plugins > Marketplace`
16-
- Nette framework helpers
17-
- Latte
18-
- NEON support
19-
- Nette Tester
20-
21-
**VS Code**: βρείτε το plugin "Nette Latte + Neon" στο marketplace.
22-
23-
Συνδέστε επίσης το Tracy με τον επεξεργαστή σας. Όταν εμφανίζεται μια σελίδα σφάλματος, θα μπορείτε να κάνετε κλικ στα ονόματα των αρχείων και αυτά θα ανοίγουν στον επεξεργαστή με τον κέρσορα στην αντίστοιχη γραμμή. Διαβάστε [πώς να διαμορφώσετε το σύστημα |tracy:open-files-in-ide].
24-
25-
26-
PHPStan
27-
=======
28-
29-
Το PHPStan είναι ένα εργαλείο που εντοπίζει λογικά σφάλματα στον κώδικα πριν τον εκτελέσετε.
30-
31-
Το εγκαθιστούμε χρησιμοποιώντας το Composer:
32-
33-
```shell
34-
composer require --dev phpstan/phpstan-nette
35-
```
36-
37-
Δημιουργούμε στο έργο ένα αρχείο διαμόρφωσης `phpstan.neon`:
38-
39-
```neon
40-
includes:
41-
- vendor/phpstan/phpstan-nette/extension.neon
42-
43-
parameters:
44-
scanDirectories:
45-
- app
46-
47-
level: 5
48-
```
49-
50-
Και στη συνέχεια το αφήνουμε να αναλύσει τις κλάσεις στον φάκελο `app/`:
51-
52-
```shell
53-
vendor/bin/phpstan analyse app
54-
```
55-
56-
Μπορείτε να βρείτε εξαντλητική τεκμηρίωση απευθείας στην [ιστοσελίδα του PHPStan |https://phpstan.org].
57-
58-
59-
Code Checker
60-
============
61-
62-
Ο [Code Checker|tools:code-checker] ελέγχει και ενδεχομένως διορθώνει ορισμένα από τα τυπικά σφάλματα στους πηγαίους κώδικές σας:
63-
64-
- αφαιρεί το [BOM |nette:glossary#BOM]
65-
- ελέγχει την εγκυρότητα των templates [Latte |latte:]
66-
- ελέγχει την εγκυρότητα των αρχείων `.neon`, `.php` και `.json`
67-
- ελέγχει την ύπαρξη [χαρακτήρων ελέγχου |nette:glossary#Control characters]
68-
- ελέγχει αν το αρχείο είναι κωδικοποιημένο σε UTF-8
69-
- ελέγχει λανθασμένα γραμμένα `/* @anotace */` (λείπει ο αστερίσκος)
70-
- αφαιρεί το τελικό `?>` από τα αρχεία PHP
71-
- αφαιρεί τα δεξιά κενά και τις περιττές γραμμές στο τέλος του αρχείου
72-
- κανονικοποιεί τους διαχωριστές γραμμών σε συστήματος (αν δώσετε την επιλογή `-l`)
73-
74-
75-
Composer
76-
========
77-
78-
Ο [Composer |Composer] είναι ένα εργαλείο διαχείρισης εξαρτήσεων στο PHP. Μας επιτρέπει να δηλώνουμε αυθαίρετα πολύπλοκες εξαρτήσεις μεμονωμένων βιβλιοθηκών και στη συνέχεια τις εγκαθιστά για εμάς στο έργο μας.
79-
80-
81-
Requirements Checker
82-
====================
83-
84-
Ήταν ένα εργαλείο που δοκίμαζε το περιβάλλον εκτέλεσης του server και ενημέρωνε αν (και σε ποιο βαθμό) ήταν δυνατό να χρησιμοποιηθεί το framework. Επί του παρόντος, το Nette μπορεί να χρησιμοποιηθεί σε κάθε server που έχει την ελάχιστη απαιτούμενη έκδοση PHP.
1+
{{redirect: tools:el:ide}}

best-practices/en/@home.texy

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,6 @@ General
4343
- [Why Does Nette Use PascalCase Notation for Constants? |https://blog.nette.org/en/for-less-screaming-in-the-code]
4444
- [Why Doesn't Nette Use the Interface Suffix? |https://blog.nette.org/en/prefixes-and-suffixes-do-not-belong-in-interface-names]
4545
- [Composer: Usage Tips |composer]
46-
- [Tips for Editors & Tools |editors-and-tools]
4746
- [Introduction to Object-Oriented Programming |nette:introduction-to-object-oriented-programming]
4847

4948
</div>

0 commit comments

Comments
 (0)