Download the PHP package hatchyu/laravel-pipeline-engine without Composer

Laravel Pipeline Engine

[!WARNING] Disclaimer & Notice for Public Users: This package is primarily developed and tailored for the author's personal, client projects, and proprietary Laravel products. While it is open-source, it is highly opinionated to fit specific workflow requirements.

If you choose to use this package in your own environments, please review its behaviors and defaults carefully. Use it at your own discretion.

A reusable, configurable, and highly extensible CI/CD pipeline engine for Laravel projects. It provides centralized shell scripts for linting, security checking, and testing, along with a custom interactive Laravel Artisan installer command to configure GitHub Actions workflows in seconds.

🚀 Why Use Laravel Pipeline Engine?

Instead of copy-pasting hundreds of lines of GitHub Actions YAML configurations across all your Laravel projects, this package centralizes your pipeline logic in a single dependency.

• Centralized Workflows: Keep your CI/CD runner logic inside the package. When you update the package, all your projects instantly inherit the updates.
• Interactive Scaffolding: Run a single command to generate a pre-configured, optimized .github/workflows/ci.yml file customized for your project.
• Zero-Configuration Fallbacks: Built-in scripts dynamically detect and run Pint, Larastan, Pest, or PHPUnit only if they are installed.
• Fast Testing: Defaults to SQLite in-memory databases to make test suite runs blazing fast without external Docker container requirements.

📦 Installation

Install the package via Composer as a dev dependency:

🛠️ Getting Started

1. Run the Interactive Installer

Configure and scaffold your GitHub Actions workflow file by running:

This interactive CLI will guide you through:

1. Selecting your PHP version.
2. Enabling/disabling frontend/Node.js asset building.
3. Deciding which checks (Quality, Security, Tests) to include in the pipeline.

The script creates/updates your .github/workflows/ci.yml file.

2. Push to GitHub

Commit the new workflow file and push to GitHub:

🔍 Core Runners

The package registers three binaries under vendor/bin/ which run automatically in CI, but can also be run locally:

1. vendor/bin/ci-lint

Checks code quality in three phases:

• Syntax Check: Parallel PHP syntax verification (php -l) across common source directories.
• Code Styling: Automatically runs Laravel Pint (vendor/bin/pint --test) or PHP-CS-Fixer if configured.
• Static Analysis: Runs Larastan/PHPStan (vendor/bin/phpstan analyse) if present.

2. vendor/bin/ci-security

Ensures dependency safety:

• Composer Audit: Runs native composer audit to scan dependencies for known vulnerabilities and stops deployment on failures.

3. vendor/bin/ci-test

Executes test suites seamlessly:

• Environment Fallbacks: Automatically configures DB_CONNECTION=sqlite and DB_DATABASE=:memory: for lightning-fast testing.
• Runner Detection: Detects whether to use Laravel's standard php artisan test, Pest (vendor/bin/pest), or PHPUnit (vendor/bin/phpunit).
• Command Arguments: Forwards any additional arguments (e.g. running specific tests or coverage reports) directly to the underlying runner.

🎛️ Customizations & Overrides

Environment Overrides

If your project requires a specific database (e.g. MySQL) or special env configurations for testing, configure them directly in your .github/workflows/ci.yml file or your .env.testing. The runners respect existing environment variables:

Adding Project-Specific Pipeline Steps

Since the GitHub Actions file lives in your project repository, you can seamlessly add custom actions (e.g. E2E tests, build steps, or boundary assertions) directly alongside the core runners:

Running Tests in Parallel

If your application has a large test suite, you can run tests in parallel to speed up execution. The test runner automatically forwards arguments to the underlying testing tool (like Pest or Artisan):

Testing Multiple PHP/Laravel Versions (Matrix Build)

If you are developing a package or need to ensure compatibility across multiple PHP versions, you can modify the scaffolded .github/workflows/ci.yml file to use a GitHub Actions matrix:

📄 License

The MIT License (MIT). Please see License File for more information.