Saltar al contenido

Acelere Laravel en GitHub Actions

Última actualización

Para acelerar Laravel en GitHub Actions, almacene en caché el directorio de descargas de Composer, ejecute las pruebas en paralelo con php artisan test --parallel y configure su servicio MySQL o Postgres con una comprobación de estado y ajustes de prueba rápidos. Las mejoras más importantes suelen ser las pruebas en paralelo y no instalar los mismos paquetes en cada ejecución.

Esta guía explica cada parte con un flujo de trabajo completo. Para el enfoque general, consulte nuestra guía para acelerar GitHub Actions.

Dónde se va el tiempo

Revise los tiempos de cada paso en una ejecución reciente. Un pipeline de Laravel normalmente dedica tiempo a: la configuración de PHP y sus extensiones, composer install, npm ci seguido de vite build, la migración de la base de datos y la ejecución de las pruebas. Las pruebas con RefreshDatabase y muchas pruebas de funcionalidad son habitualmente el cuello de botella.

Configuración de PHP y caché de Composer

shivammathur/setup-php instala PHP y sus extensiones con rapidez en los runners alojados. El README usa la etiqueta v2 y tiene las entradas php-version, extensions, coverage y tools. Establezca coverage: none salvo que necesite cobertura, porque Xdebug ralentiza mucho PHP.

La receta de caché de Composer del README almacena el directorio de caché de Composer, no vendor, y advierte que almacenar vendor con actions/cache puede causar efectos secundarios:

- 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

Use también --no-scripts si los scripts posteriores a la instalación realizan tareas que no necesita en CI, y ejecute php artisan package:discover manualmente solo si las pruebas lo necesitan. No elimine las dependencias de desarrollo con --dev en CI: las necesita para las pruebas.

Ejecución de pruebas en paralelo

php artisan test --parallel de Laravel utiliza el paquete brianium/paratest para ejecutar las pruebas en varios procesos. Instálelo como dependencia de desarrollo (composer require brianium/paratest --dev). Laravel crea una base de datos por proceso, con nombre derivado de su base de datos de pruebas más un sufijo, para que los procesos no entren en conflicto.

php artisan test --parallel --processes=4

Con Pest, ./vendor/bin/pest --parallel hace lo mismo. Sin --processes, usa el número de núcleos de CPU. Las pruebas en paralelo necesitan un estado aislado: nada de archivos compartidos en storage, nada de puertos fijos y nada de pruebas que dependan del orden de ejecución. Use RefreshDatabase o DatabaseTransactions en lugar de dejar datos residuales. Si una prueba falla solo en modo paralelo, el estado compartido es la primera sospecha.

Un servicio de base de datos optimizado

Utilice la misma base de datos que usa en producción. Para MySQL, un contenedor de servicio con comprobación de estado:

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

Ajustar MySQL para datos de prueba descartables es una compensación legítima solo para CI. La imagen del contenedor acepta flags del servidor como argumentos en docker run, pero el bloque services de GitHub no permite pasar un comando. Hay dos opciones prácticas: iniciar MySQL usted mismo con docker run en un paso y añadir flags como --innodb-flush-log-at-trx-commit=0 --sync-binlog=0, o montar la base de datos en tmpfs añadiendo --tmpfs /var/lib/mysql a options. El enfoque con tmpfs es sencillo y elimina por completo las esperas de disco. No utilice ninguno de los dos con datos reales.

SQLite en memoria es mucho más rápido, pero puede ocultar diferencias respecto a MySQL (funciones JSON, collation, comportamiento de claves foráneas). Úselo para trabajos unitarios rápidos si lo desea, y mantenga un trabajo con MySQL como puerta de control.

Recursos del frontend

Si alguna prueba renderiza páginas que necesitan recursos de Vite, compílelos una sola vez. Almacene en caché npm mediante actions/setup-node con cache: npm, ejecute npm ci y npm run build, y pase la carpeta public/build a los trabajos posteriores como artefacto en lugar de recompilar en cada fragmento. Los trabajos de pruebas solo de API deben omitir por completo los pasos de Node.

Análisis estático y estilo en trabajos separados

Larastan (PHPStan), Pint y Rector no dependen de la base de datos. Ejecútelos como trabajos separados para que se solapen con el trabajo de pruebas. Pint puede ejecutarse con --test para comprobar sin modificar archivos. PHPStan tiene un directorio de caché de resultados; almacenarlo con actions/cache acelera las ejecuciones repetidas.

Un flujo de trabajo completo

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

Lo que aportan más núcleos de CPU

--parallel usa por defecto el número de núcleos, así que un runner alojado de 2 vCPU lanza dos procesos y una máquina de 8 vCPU lanza ocho. MySQL se ejecuta en la misma máquina, por lo que compite por los núcleos; con tmpfs, la base de datos consume sobre todo CPU y memoria, lo que escala bien. No tenemos una fila de PHP o Laravel en nuestros benchmarks, así que no citamos ninguna cifra. La pila Turborepo + Next.js + tRPC + MySQL (de 3m29s a 1m53s, 1.9x, 8 de octubre de 2026) es un framework diferente, aunque también usaba MySQL.

Para probar su suite, cambie una línea a runs-on: [self-hosted, Linux, compiler-ci]; consulte precios y comparar. Relacionado: la plantilla de Laravel, caché en GitHub Actions y fragmentación de pruebas.

Preguntas frecuentes

¿Cómo ejecuto las pruebas de Laravel en paralelo?

Instale brianium/paratest como dependencia de desarrollo y ejecute php artisan test --parallel, o pest --parallel si usa Pest. Cada proceso obtiene su propia base de datos.

¿Debo almacenar vendor en caché en GitHub Actions?

No. Almacene en caché el directorio de descargas de Composer y ejecute composer install. El README de setup-php advierte que almacenar vendor puede tener efectos secundarios.

¿Xdebug ralentiza mi CI?

Sí, si está cargado. Establezca coverage: none en setup-php salvo que el trabajo genere cobertura, y use pcov cuando la necesite.

¿Por qué fallan las pruebas de Laravel en paralelo solo en CI?

Normalmente por estado compartido: archivos en storage, valores en caché o datos no limpiados entre pruebas. Ejecute la prueba que falla por separado y luego con --parallel para confirmarlo.

Ejecute este workflow en compiler.dev Sin tarjeta · 200 minutos gratuitos

Pruébelo gratis