Runner Selection

This skill helps you select the appropriate command runner based on your environment setup.

Environment Detection

The plugin automatically detects your environment:

1. Symfony Docker (FrankenPHP/Caddy)

   • Detected via compose.yaml with frankenphp/caddy references
   • Or presence of frankenphp/ directory or Caddyfile

2. Docker Compose Standard

   • Detected via docker-compose.yml or compose.yaml
   • Service name auto-detected (php, app, or first service)

3. Host Environment

   • Fallback when no Docker configuration found
   • Uses local PHP installation

Command Mapping

Symfony Docker

# PHP execution
docker compose exec php php script.php

# Symfony Console
docker compose exec php bin/console cache:clear

# Composer
docker compose exec php composer require package

# Tests
docker compose exec php ./vendor/bin/phpunit
docker compose exec php ./vendor/bin/pest

Docker Compose Standard

# PHP execution (service name may vary: php, app, etc.)
docker compose exec app php script.php

# Symfony Console
docker compose exec app bin/console cache:clear

# Composer
docker compose exec app composer require package

# Tests
docker compose exec app ./vendor/bin/phpunit

Host Environment

# PHP execution
php script.php

# Symfony Console
php bin/console cache:clear

# Composer
composer require package

# Tests
./vendor/bin/phpunit
./vendor/bin/pest

Switching Runners

If Docker is configured but not running, you have two options:

Option 1: Start Docker

# Symfony Docker
docker compose up -d --wait

# Docker Compose standard
docker compose up -d

Option 2: Use Host Tools

Continue with host PHP/Composer if available.

Best Practices

1. Consistency: Use the same runner throughout a session
2. Docker preference: Prefer Docker for reproducibility
3. Host for speed: Use host tools for quick iterations if Docker is slow
4. CI/CD: Always use Docker in CI for consistency

Troubleshooting

Docker not found

# Check Docker installation
docker --version
docker compose version

Service not running

# Check running containers
docker compose ps

# View logs
docker compose logs -f

Permission issues

# Fix file ownership (Symfony Docker)
docker compose exec php chown -R $(id -u):$(id -g) .