Merge Request Info

Was genau fehlgeschlagen ist, offenbart ein Klick auf das 'X' im roten Kreis oder auf die ID der Pipeline.
Alle Jobs/Tests, die fehlgeschlagen sind, sind mit einem 'X' markiert.
Ein Klick auf den entsprechenden Job, zeigt die Konsolenausgabe des Jobs an.
Dort steht was konkret schiefgelaufen ist bzw. nicht korrekt ist.

Um die Fehler zu beheben und mergen zu können, gehe wie folgt vor:

1. Installiere das Paket in der Version des Feature Branches (dev-$mergeSourceBranch)
2. Stelle sicher, dass du Composer und PHIVE global installiert hast
3. Führe composer dev:init aus

Versuche nun wie in den Abschnitten unten beschrieben, die Fehler zu beheben.

Wenn nichts hilft, können einzelne Jobs/Tests in der Pipeline auch deaktiviert oder modifiziert werden.
Siehe dazu https://dev.quiqqer.com/explore/catalog/quiqqer/stabilization/ci-cd-components/quiqqer-package-bundle#how-to-use

PHP_CodeSniffer (phpcs)

Um Codestyle Fehler (phpcs) zu finden, führe composer dev:lint:style aus.

Viele Fehler können automatisch behoben werden, führe dazu composer dev:lint:style:fix aus.
Übrige Fehler müssen manuell basierend auf den Fehlermeldungen behoben werden.

Es ist auch möglich Fehler zu ignorieren, siehe dazu das PHP_CodeSniffer Wiki: https://github.com/PHPCSStandards/PHP_CodeSniffer/wiki
Bei Bedarf kannst du auch die PHP_CodeSniffer Config (phpcs.xml.dist) anpassen.

Wenn keine Fehler mehr auftreten, spiele deine Änderungen in den Feature-Branch ein.
Die Pipeline startet neu und sollte keine Fehler mehr melden.

PHPStan

Um PHPStan Fehler zu sehen, führe composer dev:lint:phpstan aus.

Da das PHPStan Level standardmäßig sehr hoch ist, können sehr viele Fehler auftreten.
Du musst nicht (!) alle Fehler beheben.

Gehe stattdessen wie folgt vor:

• Setze in der phpstan.dist.neon das Level auf 1.
• Führe nun PHPStan - wie oben beschrieben - erneut aus
• Nun werden alle kritischen Fehler gelistet, die du auf jeden Fall beheben solltest
• Wenn du alle Fehler behoben hast oder sie nicht behebbar sind, generiere die Baseline: tools/phpstan --generate-baseline --allow-empty-baseline
• Erhöhe jetzt das Level schrittweise und wiederhole die vorigen Schritte, bis du Level 8 erreicht hast.

Wenn sich Fehler nicht beheben und nicht ignorieren lassen, solltest du die gesamte Datei ignorieren.
Wie das und weiteres geht, findest du in der PHPStan Dokumentation: https://phpstan.org/user-guide/getting-started

Wenn keine Fehler mehr auftreten, spiele deine Änderungen in den Feature Branch ein.
Die Pipeline sollte neu starten und keine Fehler mehr melden.

PHPUnit

Um PHPUnit Fehler zu sehen, führe composer dev:phpunit aus.
Gibt es Fehler überprüfe folgendes:

• Stelle sicher, dass die per PHIVE installierte PHPUnit Version korrekt ist (siehe .phive/phars.xml).
• Stelle sicher, dass deine PHPUnit Config Datei korrekt ist.
• Stelle sicher, dass deine Tests mit allen PHP Versionen funktionieren.