Omschrijving
Alle code in Zilver voldoet aan de laagste check (level 0) van PHPStan, waarmee ernstige fouten uitgesloten zijn; dit gaat vooral om syntax fouten. Echter betekend dat niet dat de code probleem-vrij is. Om de kwaliteit van de code te verhogen, zal ook het level van PHPStan stapsgewijs verhoogd moeten worden, waarna de dan gemelde problemen opgelost zullen moeten worden.
PHPStan is opgenomen in de docker stack en kan (in de basis) als volgt gedraaid worden:
1
docker-compose run –rm phpstan
De output geeft aan welke argumenten mogelijk zijn. Het argument komt overeen met een bestand in de map build-files/phpstan, waarbij het argument src de configuratie uit phpstan.src.neon gebruikt. Het template argument wordt alleen voor frontend-templates gebruikt, en is dus niet van toepassing op de Zilver code. De overige configuraties zijn opgesplitst om excessief geheugengebruik te voorkomen, en dienen allemaal toegepast te worden. In principe behoeven de configuratiebestanden geen aanpassing.
Verder is het mogelijk om extra opties voor PHPStan mee te geven, door deze simpelweg op te nemen in de commandline. Denk hierbij aan een enkel bestand analyseren, memory limit instellen (–memory-limit=4G) of verbose output geven (-vvv). Zie verder https://phpstan.org/user-guide/command-line-usage
Denk er om dat, afhankelijke van de gebruikte configuratie, alle PHP (of PHTML) bestanden geanalyseerd worden. Dus ook bestanden die niet in versiebeheer opgenomen zijn, zoals custom scripts of templates. Voor die laatste is het handig om site-specifieke templates in de map templates/custom te plaatsen, welke wordt uitgesloten van analyse (de custom prefix kan dan in de Zilver configuratie opgenomen worden bij de $frontend variabele).
Zie ook https://050media.atlassian.net/browse/CMS-12837