monolog-gdpr-filter/docs/docker-development.md

Docker Development Environment

This guide explains how to set up a Docker development environment for working with the Monolog GDPR Filter library.

Quick Start

Using Docker Compose

# Clone the repository
git clone https://github.com/ivuorinen/monolog-gdpr-filter.git
cd monolog-gdpr-filter

# Start the development environment
docker compose up -d

# Run tests
docker compose exec php composer test

# Run linting
docker compose exec php composer lint

Docker Configuration Files

docker/Dockerfile

FROM php:8.4-cli-alpine

# Install system dependencies
RUN apk add --no-cache \
    git \
    unzip \
    curl \
    libzip-dev \
    icu-dev \
    && docker-php-ext-install \
    zip \
    intl \
    pcntl

# Install Composer
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer

# Install Xdebug for code coverage
RUN apk add --no-cache $PHPIZE_DEPS \
    && pecl install xdebug \
    && docker-php-ext-enable xdebug

# Configure Xdebug
RUN echo "xdebug.mode=coverage,debug" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini \
    && echo "xdebug.client_host=host.docker.internal" >> /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini

# Set working directory
WORKDIR /app

# Set recommended PHP settings for development
RUN echo "memory_limit=512M" >> /usr/local/etc/php/conf.d/docker-php-memory.ini \
    && echo "error_reporting=E_ALL" >> /usr/local/etc/php/conf.d/docker-php-errors.ini \
    && echo "display_errors=On" >> /usr/local/etc/php/conf.d/docker-php-errors.ini

# Create non-root user
RUN addgroup -g 1000 developer \
    && adduser -D -u 1000 -G developer developer

USER developer

CMD ["php", "-v"]

docker/docker-compose.yml

version: '3.8'

services:
  php:
    build:
      context: .
      dockerfile: Dockerfile
    volumes:
      - ..:/app
      - composer-cache:/home/developer/.composer/cache
    working_dir: /app
    environment:
      - COMPOSER_HOME=/home/developer/.composer
      - XDEBUG_MODE=coverage
    stdin_open: true
    tty: true
    command: tail -f /dev/null

  # Optional: PHP 8.5 for testing compatibility
  php83:
    image: php:8.5-cli-alpine
    volumes:
      - ..:/app
    working_dir: /app
    profiles:
      - testing
    command: php -v

volumes:
  composer-cache:

Running Tests

All Tests

docker compose exec php composer test

With Coverage Report

docker compose exec php composer test:coverage

Specific Test File

docker compose exec php ./vendor/bin/phpunit tests/GdprProcessorTest.php

Specific Test Method

docker compose exec php ./vendor/bin/phpunit --filter testEmailMasking

Running Linting Tools

All Linting

docker compose exec php composer lint

Individual Tools

# PHP CodeSniffer
docker compose exec php ./vendor/bin/phpcs

# Auto-fix with PHPCBF
docker compose exec php ./vendor/bin/phpcbf

# Psalm
docker compose exec php ./vendor/bin/psalm

# PHPStan
docker compose exec php ./vendor/bin/phpstan analyse

# Rector (dry-run)
docker compose exec php ./vendor/bin/rector --dry-run

Development Workflow

Initial Setup

# Build containers
docker compose build

# Start services
docker compose up -d

# Install dependencies
docker compose exec php composer install

# Run initial checks
docker compose exec php composer lint
docker compose exec php composer test

Daily Development

# Start environment
docker compose up -d

# Make changes...

# Run tests
docker compose exec php composer test

# Run linting
docker compose exec php composer lint

# Auto-fix issues
docker compose exec php composer lint:fix

Testing Multiple PHP Versions

# Test with PHP 8.3
docker compose --profile testing run php83 php -v
docker compose --profile testing run php83 ./vendor/bin/phpunit

Debugging

Enable Xdebug

The Docker configuration includes Xdebug. Configure your IDE to listen on port 9003.

For VS Code, add to .vscode/launch.json:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003,
            "pathMappings": {
                "/app": "${workspaceFolder}"
            }
        }
    ]
}

Interactive Shell

docker compose exec php sh

View Logs

docker compose logs -f php

CI/CD Integration

GitHub Actions Example

name: Tests

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        php: ['8.4', '8.5']

    steps:
      - uses: actions/checkout@v4

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: ${{ matrix.php }}
          extensions: intl, zip
          coverage: xdebug

      - name: Install dependencies
        run: composer install --prefer-dist --no-progress

      - name: Run linting
        run: composer lint

      - name: Run tests
        run: composer test:coverage

Troubleshooting

Permission Issues

If you encounter permission issues:

# Fix ownership
docker compose exec -u root php chown -R developer:developer /app

# Or run as root temporarily
docker compose exec -u root php composer install

Composer Memory Limit

docker compose exec php php -d memory_limit=-1 /usr/bin/composer install

Clear Caches

# Clear composer cache
docker compose exec php composer clear-cache

# Clear Psalm cache
docker compose exec php ./vendor/bin/psalm --clear-cache

# Clear PHPStan cache
docker compose exec php ./vendor/bin/phpstan clear-result-cache

See Also

• Symfony Integration
• PSR-3 Decorator
• Framework Examples