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.
Relacionado
- Acelere un monorepo de TypeScript en GitHub ActionsAcelere la comprobación de tipos y el linting en un monorepo TypeScript con GitHub Actions: tsc incremental, referencias de proyecto y cachés.
- Acelere Playwright en un monorepo con GitHub ActionsAcelere las pruebas e2e de Playwright en un monorepo Node con GitHub Actions: compile la app una vez y omita e2e si no cambió.
- Añada una insignia de velocidad de CI a su READMEMuestre la velocidad de su CI con una insignia en el README: el tiempo mediano de ejecución en GitHub Actions, actualizado automáticamente. Gratis.
- Acelere .NET en GitHub ActionsAcelere las compilaciones de .NET en GitHub Actions: caché de NuGet con setup-dotnet, --no-restore, --no-build, dotnet test en paralelo y servicios SQL.