drahosistvan/laravel-ci-tools repository overview

⁠Laravel CI Tools

Docker images for building, testing, and deploying Laravel applications in CI/CD pipelines. Supports multiple PHP and Node.js version combinations with all essential Laravel tools pre-installed.

Docker Hub: drahosistvan/laravel-ci-tools⁠

⁠🚀 Quick Start

# Pull the latest image
docker pull drahosistvan/laravel-ci-tools:latest

# Or use in your CI/CD pipeline
image: drahosistvan/laravel-ci-tools:php8.5-node24

⁠📦 What's Included

• PHP: 8.2, 8.3, 8.4, 8.5
• Node.js: 24 (Active LTS), 25 (Latest)
• Package Managers: Composer (latest), NPM (bundled), Yarn (latest)
• Laravel Tools: Envoy, Vapor CLI (on PATH, installed in ~/.composer/vendor/bin)
• PHP Extensions: zip, gd (JPEG, PNG, WebP, FreeType), exif, sodium, intl, bcmath, pcntl, pdo_mysql, pdo_pgsql, mcrypt
• System Tools: Git, rsync, SSH client

⁠🏷️ Available Tags

⁠Latest (Newest Versions)

• latest → PHP 8.5 + Node 25

⁠PHP Version Tags (with Node 24, Active LTS)

• php8 → PHP 8.5 + Node 24
• php8.2 → PHP 8.2 + Node 24
• php8.3 → PHP 8.3 + Node 24
• php8.4 → PHP 8.4 + Node 24
• php8.5 → PHP 8.5 + Node 24

⁠Node Version Tags (with PHP 8.5, Latest)

• node24 → PHP 8.5 + Node 24
• node25 → PHP 8.5 + Node 25

⁠Specific Combinations

Format: php{VERSION}-node{VERSION}

All 8 combinations available:

• PHP 8.2: php8.2-node24, php8.2-node25
• PHP 8.3: php8.3-node24, php8.3-node25
• PHP 8.4: php8.4-node24, php8.4-node25
• PHP 8.5: php8.5-node24, php8.5-node25

⁠💻 Usage Examples

⁠GitLab CI/CD

image: drahosistvan/laravel-ci-tools:php8.5-node24

stages:
  - build
  - test
  - deploy

build:
  stage: build
  script:
    - composer install --no-interaction --prefer-dist --optimize-autoloader
    - npm install
    - npm run build

test:
  stage: test
  script:
    - php artisan test

deploy:
  stage: deploy
  script:
    - ~/.composer/vendor/bin/vapor deploy production
  only:
    - main

⁠GitHub Actions

jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: drahosistvan/laravel-ci-tools:php8.5-node24
    steps:
      - uses: actions/checkout@v4
      
      - name: Install dependencies
        run: |
          composer install
          npm ci
      
      - name: Build assets
        run: npm run build
      
      - name: Run tests
        run: php artisan test

⁠Bitbucket Pipelines

image: drahosistvan/laravel-ci-tools:php8.5-node24

pipelines:
  default:
    - step:
        name: Build and Test
        caches:
          - composer
          - node
        script:
          - composer install
          - npm ci
          - npm run build
          - php artisan test

⁠🛠️ Local Development

⁠Pull and Use an Image

# Pull specific version
docker pull drahosistvan/laravel-ci-tools:php8.5-node24

# Run interactive shell
docker run -it --rm drahosistvan/laravel-ci-tools:latest bash

# Run specific commands
docker run --rm drahosistvan/laravel-ci-tools:latest php -v
docker run --rm drahosistvan/laravel-ci-tools:latest node -v
docker run --rm drahosistvan/laravel-ci-tools:latest composer --version

⁠Build Custom Image Locally

# Using the build script
./build/build.sh 8.5 24

# Or manually with Docker
docker build \
  --build-arg PHP_VERSION=8.5 \
  --build-arg NODE_VERSION=24 \
  -t laravel-ci-tools:php8.5-node24 \
  -f src/Dockerfile \
  .

# Build all combinations
./build/build-all.sh

# Build and push to Docker Hub
./build/build-all.sh --push

⁠Test an Image

# Test a specific combination
./build/test.sh 8.5 24

⁠🔄 Automated Builds

All images are automatically rebuilt:

• ✅ On push to main branch - Triggered by code changes
• ✅ On tagged releases - Version-specific builds
• ✅ Monthly schedule - 1st of every month at 2 AM UTC for security updates
• ✅ Manual dispatch - On-demand builds via GitHub Actions

⁠Manual Workflow Trigger

1. Go to the repository's Actions tab
2. Select "Build and Push Docker Images"
3. Click Run workflow
4. Optionally specify PHP and Node versions
5. Click Run workflow

⁠📊 Support Matrix

Total Combinations: 8 images (4 PHP × 2 Node.js versions)

⁠📚 Examples

More CI/CD examples available in the examples/ folder:

• GitLab CI - Laravel Vapor deployment
• GitHub Actions - Complete workflow with testing
• Bitbucket Pipelines - Pipeline configuration

⁠🤝 Contributing

Contributions are welcome! You can help by:

• Adding new tools to the Docker image
• Providing CI/CD templates for other platforms
• Reporting issues or suggesting improvements
• Improving documentation

See CONTRIBUTING.md⁠ for guidelines.

⁠📄 License

This project is free and unencumbered software released into the public domain. See the LICENSE⁠ file for details.