GitHub Actions - PHP-Projekte bauen und testen

in  Builds & Tests , , ,

GitHub Actions - PHP-Projekte bauen und testen

Eine Aktion zur PHP-Einrichtung

Für die wichtigsten Punkte, die notwendig sind, um ein auf PHP basierendes Projekt zu testen, gibt es die Action setup-php. Diese bietet unter anderem folgende Möglichkeiten:

  • unterschiedliche PHP-Versionen verwenden
  • PHP-Extensions einrichten
  • PHP-Konfigurationen vornehmen
  • zusätzliche, häufig verwendete Tools installieren

Diese Aktion sollte für allgemeine Anwendungen keine Wünsche offen lassen. Wir verwenden diese Aktion seit einigen Monaten in mehreren Repositories ohne jegliche Probleme.

Weitergehende Möglichkeiten

Auch Matrix-Builds sind möglich: hiermit lässt sich ein Workflow für mehrere Betriebssysteme und/oder PHP-Versionen ausführen.

Beispiel:

1
2
3
4
5
6
runs-on: ${{ matrix.operating-system }}
strategy:
  matrix:
    operating-system: [ubuntu-latest, windows-latest, macos-latest]
    php-versions: ['7.2', '7.3', '7.4']
name: PHP ${{ matrix.php-versions }} Test on ${{ matrix.operating-system }}

Es gibt darüber hinaus übrigens auch eine ganze Reihe an Beispiel-Workflows. Diese stellen einige typische Setups für unterschiedliche Frameworks, wie etwa Symfony oder Laravel, in Kombination mit verschiedenen Datenbank-Systemen, zur Verfügung.

phpqa - eine immens große Toolbox

Sollte die Liste unterstützer Zusatzwerkzeuge nicht ausreichen, weil man bestimmte weitere Metrik-Tools oder ähnliches verwenden möchte, gibt es grundsätzlich bzw. mindestens drei Möglichkeiten:

  1. Die benötigten Tools einfach im Workflow, zum Beispiel mittels wget, herunterladen. Nachteil: ggf. müssen regelmäßig Links aktualisiert oder Versionen angepasst werden.
  2. Eine Abhängigkeit via composer.json hinzufügen, um die gewünschten Werkzeuge via Composer zu laden. Nachteil: ggf. können Konflikte zwischen mehreren Tools entstehen.
  3. Die folgenden Docker-Images verwenden.

Mit phpqa steht eine Liste von Docker-Containern bereit, die derzeit bereits über 60 Werkzeuge für PHP-Metriken und -Testing bereitstellen. Dieses Angebot kann auch mit GitHub Actions verwendet werden.

Ausblick

Nach dieser kleinen Einführung in die Nutzung von GitHub Actions für PHP-Projekte geht es im kommenden Artikel mit einem anderen Use Case weiter.

Weitere Beiträge in Kategorie Builds & Tests

Abhängigkeiten automatisch aktualisieren mit Renovate
- Um Dependencies aktuell zu halten, wird bei GitHub oft und gerne der Dependabot eingesetzt. Mit Renovate existiert allerdings eine äußerst flexible Alternative, die im Folgenden kurz vorgestellt wird. …
Symfony-Projekte im Monorepo mit Nx bauen
- Mit dem Build-System Nx lassen sich beliebige Projekte in einem Monorepo auf einheitliche Weise testen und bauen. Es bedient sich verschiedener npm-Plugins, um dies für unterschiedliche Technologien …
Abhängigkeiten automatisch aktualisieren mit Dependabot
- Vor knapp eineinhalb Jahren haben wir gezeigt, wie man die Aktualisierung verwendeter Drittkomponenten mit GitHub Actions automatisieren kann. Zwischenzeitlich sind wir hierbei auf den Dependabot …
Hugo-Seiten im Netzwerk entwickeln und testen
- Hugo ist ein Generator für statische Seiten, welcher auf der Programmiersprache Go basiert. Die Inhalte werden mit Markdown verwaltet und dynamisch in HTML umgewandelt. Dies ist für die meisten …
SensioLabs Security Checker wurde eingestellt
- Zu den grundlegenden Aufgaben automatisierter Builds zählen unterschiedliche Prüfungen: so bietet es sich an, die Einhaltung der Coding-Styles zu überwachen, Qualitätsmetriken zu erheben und die …