Zum Inhalt springen

Laravel in GitHub Actions beschleunigen

Zuletzt aktualisiert am

Um Laravel in GitHub Actions zu beschleunigen, cachen Sie das Download-Verzeichnis von Composer, führen Sie Tests mit php artisan test --parallel parallel aus und geben Sie Ihrem MySQL- oder Postgres-Service einen Health Check sowie schnelle Testeinstellungen. Die größten Effekte bringen meist parallele Tests und das Vermeiden, dieselben Pakete bei jedem Run erneut zu installieren.

Dieser Leitfaden behandelt jeden Baustein anhand eines vollständigen Workflows. Den allgemeinen Ansatz finden Sie in unserem Leitfaden zur Beschleunigung von GitHub Actions.

Wo die Zeit verloren geht

Lesen Sie die Schrittzeiten aus einem aktuellen Run. Eine Laravel-Pipeline verbraucht üblicherweise Zeit für: PHP- und Extension-Setup, composer install, npm ci plus vite build, die Datenbankmigration und den Testlauf. Tests mit RefreshDatabase und viele Feature-Tests sind meist der längste Engpass.

PHP-Setup und der Composer-Cache

shivammathur/setup-php installiert PHP und Extensions auf gehosteten Runnern schnell. Die README verwendet den Tag v2 und besitzt die Inputs php-version, extensions, coverage und tools. Setzen Sie coverage: none, sofern Sie keine Coverage benötigen, da Xdebug PHP stark verlangsamt.

Das Composer-Caching-Rezept der README speichert das Cache-Verzeichnis von Composer, nicht vendor, und warnt, dass das Cachen von vendor mit actions/cache Nebenwirkungen verursachen kann:

- uses: shivammathur/setup-php@v2
  with:
    php-version: "8.4"
    extensions: mbstring, pdo_mysql, bcmath
    coverage: none
- name: Get Composer cache directory
  id: composer-cache
  run: echo "dir=$(composer config cache-files-dir)" >> "$GITHUB_OUTPUT"
- uses: actions/cache@v6
  with:
    path: ${{ steps.composer-cache.outputs.dir }}
    key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
    restore-keys: ${{ runner.os }}-composer-
- run: composer install --prefer-dist --no-progress --no-interaction

Übergeben Sie außerdem --no-scripts, wenn Post-Install-Skripte in der CI Arbeit verrichten, die Sie nicht benötigen, und führen Sie php artisan package:discover nur selbst aus, wenn die Tests es brauchen. Verzichten Sie in der CI auf das Entfernen von --dev, denn für die Tests benötigen Sie die Dev-Pakete.

Tests parallel ausführen

Laravels php artisan test --parallel verwendet das Paket brianium/paratest, um Tests in mehreren Prozessen auszuführen. Installieren Sie es als Dev-Abhängigkeit (composer require brianium/paratest --dev). Laravel legt pro Prozess eine eigene Datenbank an, deren Name aus Ihrer Test-Datenbank mit einem Token-Suffix gebildet wird, sodass sich die Prozesse nicht in die Quere kommen.

php artisan test --parallel --processes=4

Mit Pest erreicht ./vendor/bin/pest --parallel dasselbe. Ohne --processes richtet sich die Anzahl nach den CPU-Kernen. Parallele Tests brauchen isolierten Zustand: keine gemeinsam genutzten Dateien in storage, keine festen Ports und keine Tests, die von der Reihenfolge abhängen. Verwenden Sie RefreshDatabase oder DatabaseTransactions, statt Daten liegen zu lassen. Schlägt ein Test nur im Parallelmodus fehl, ist gemeinsamer Zustand der erste Verdacht.

Ein abgestimmter Datenbank-Service

Verwenden Sie dieselbe Datenbank wie in der Produktion. Für MySQL ein Service-Container mit Health Check:

services:
  mysql:
    image: mysql:8.4
    env:
      MYSQL_ROOT_PASSWORD: password
      MYSQL_DATABASE: laravel
    ports: ["3306:3306"]
    options: >-
      --health-cmd "mysqladmin ping -h 127.0.0.1 -ppassword"
      --health-interval 5s --health-timeout 5s --health-retries 15

Die Optimierung von MySQL für Wegwerf-Testdaten ist ein legitimer Kompromiss, der nur in der CI gilt. Das Container-Image akzeptiert Serverflags als Argumente in docker run, der services-Block von GitHub unterstützt jedoch keine Angabe eines Befehls. Zwei praktikable Optionen: Starten Sie MySQL in einem Schritt selbst mit docker run und fügen Sie Flags wie --innodb-flush-log-at-trx-commit=0 --sync-binlog=0 hinzu, oder legen Sie die Datenbank per --tmpfs /var/lib/mysql in options auf tmpfs. Der tmpfs-Ansatz ist einfach und beseitigt Wartezeiten auf die Festplatte vollständig. Verwenden Sie keine der beiden Varianten mit echten Daten.

SQLite im Speicher ist deutlich schneller, kann aber Unterschiede zu MySQL verbergen (JSON-Funktionen, Collation, Verhalten bei Fremdschlüsseln). Nutzen Sie es für schnelle Unit-Jobs, falls gewünscht, und behalten Sie einen MySQL-Job als maßgebliche Prüfung.

Frontend-Assets

Wenn Tests Seiten rendern, die Vite-Assets benötigen, bauen Sie diese einmal. Cachen Sie npm über actions/setup-node mit cache: npm, führen Sie npm ci und npm run build aus und übergeben Sie den Ordner public/build als Artefakt an spätere Jobs, anstatt ihn in jedem Shard neu zu bauen. Reine API-Testjobs sollten die Node-Schritte komplett überspringen.

Statische Analyse und Stilprüfung in eigenen Jobs

Larastan (PHPStan), Pint und Rector hängen nicht von der Datenbank ab. Führen Sie sie als separate Jobs aus, damit sie sich mit dem Test-Job überschneiden. Pint kann mit --test prüfen, ohne Dateien zu verändern. PHPStan besitzt ein Ergebnis-Cache-Verzeichnis; dessen Caching mit actions/cache beschleunigt wiederholte Läufe.

Ein vollständiger Workflow

name: tests
on:
  pull_request:
  push:
    branches: [main]

concurrency:
  group: tests-${{ github.ref }}
  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}

jobs:
  test:
    runs-on: ubuntu-latest
    timeout-minutes: 20
    services:
      mysql:
        image: mysql:8.4
        env:
          MYSQL_ROOT_PASSWORD: password
          MYSQL_DATABASE: laravel
        ports: ["3306:3306"]
        options: >-
          --tmpfs /var/lib/mysql
          --health-cmd "mysqladmin ping -h 127.0.0.1 -ppassword"
          --health-interval 5s --health-timeout 5s --health-retries 15
    env:
      DB_CONNECTION: mysql
      DB_HOST: 127.0.0.1
      DB_DATABASE: laravel
      DB_USERNAME: root
      DB_PASSWORD: password
    steps:
      - uses: actions/checkout@v7
      - uses: shivammathur/setup-php@v2
        with:
          php-version: "8.4"
          extensions: mbstring, pdo_mysql, bcmath
          coverage: none
      - id: composer-cache
        run: echo "dir=$(composer config cache-files-dir)" >> "$GITHUB_OUTPUT"
      - uses: actions/cache@v6
        with:
          path: ${{ steps.composer-cache.outputs.dir }}
          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
          restore-keys: ${{ runner.os }}-composer-
      - run: composer install --prefer-dist --no-progress --no-interaction
      - run: cp .env.example .env && php artisan key:generate
      - run: php artisan test --parallel

Was mehr CPU-Kerne bringen

--parallel richtet sich standardmäßig nach der Anzahl Ihrer Kerne, daher erzeugt ein gehosteter Runner mit 2 vCPUs zwei Prozesse und eine Maschine mit 8 vCPUs acht. MySQL läuft auf derselben Maschine und konkurriert deshalb um Kerne; mit tmpfs nutzt die Datenbank vor allem CPU und Arbeitsspeicher, was sich gut skaliert. In unseren Benchmarks gibt es keine Zeile für PHP oder Laravel, daher nennen wir keine Zahl. Der Stack aus Turborepo, Next.js, tRPC und MySQL (3m29s auf 1m53s, 1.9x, 8. Oktober 2026) ist ein anderes Framework, nutzt aber ebenfalls MySQL.

Um Ihre Suite zu testen, ändern Sie eine Zeile zu runs-on: [self-hosted, Linux, compiler-ci]; siehe Preise und Vergleich. Verwandt: die Laravel-Vorlage, Caching in GitHub Actions und Test-Sharding.

FAQ

Wie führe ich Laravel-Tests parallel aus?

Installieren Sie brianium/paratest als Dev-Abhängigkeit und führen Sie php artisan test --parallel aus, bzw. mit Pest pest --parallel. Jeder Prozess erhält seine eigene Datenbank.

Sollte ich vendor in GitHub Actions cachen?

Nein. Cachen Sie den Download-Cache von Composer und führen Sie composer install aus. Die README von setup-php warnt, dass das Cachen von vendor Nebenwirkungen haben kann.

Verlangsamt Xdebug meine CI?

Ja, sofern es geladen ist. Setzen Sie coverage: none in setup-php, sofern der Job keine Coverage erzeugt, und verwenden Sie pcov, wenn Sie sie benötigen.

Warum schlagen parallele Laravel-Tests nur in der CI fehl?

Meist wegen gemeinsam genutztem Zustand: Dateien in storage, zwischengespeicherte Werte oder Daten, die zwischen Tests nicht bereinigt werden. Führen Sie den fehlschlagenden Test allein und dann mit --parallel aus, um es zu bestätigen.

Diesen Workflow auf compiler.dev ausführen Keine Karte nötig · 200 kostenlose Minuten

Kostenlos testen