DressCode
DressCode kontroluje a opravuje styl PHP kódu nad bezztrátovým syntaktickým stromem: pravidlo změní jen to, na co sáhne, a zbytek souboru zůstane bajt po bajtu stejný. Nemá vlastní styl, jen presety PER, PSR-12 a Nette.
Používal jsem roky PHP CS Fixer i PHP_CodeSniffer a považoval je za hotovou věc: nástroj, který se jednou nastaví a pak se o něm nemluví. Pak jsem si přečetl, jak vypadá pravidlo v DressCode, a pochopil, kolik času jsem trávil ne stylem, ale obcházením toho, že nástroj vidí jen seznam tokenů. Tahle dokumentace je psaná z pohledu někoho, kdo ho od té doby nasadil na všechno, co má; kde je něco jinak než jinde, řeknu to, a kde je něco jinde lepší, taky.
Kudy dál
- Začínáme instalace, první kontrola a první oprava.
- Přechod na DressCode pokud dnes používáte PHP CS Fixer, PHP_CodeSniffer, Slevomat nebo ECS.
- Vlastní pravidlo pokud vám v katalogu něco chybí.
Používání
- Jak DressCode přemýšlí mentální model: strom, pravidla, presety, průchody.
- Konfigurace soubor, presety a vrstvy, pravidla a volby, cesty.
- Potlačení a baseline výjimky na řádku, v souboru a v projektu.
- Příkazová řádka příkazy, volby, formáty výstupu, exit kódy.
Reference
- Pravidla všechna vestavěná pravidla s příklady a volbami.
- Presety co který preset zapíná.
- Uzly stromu pro autory pravidel a uživatele PhpSyntax.
Rozšíření a integrace
- Jak se DressCode rozšiřuje, pravidla hry, pravidla o mezerách, testování.
- PhpSyntax parser jako samostatná knihovna.
- Editory a IDE, průběžná integrace, Git hooky a agenti.