Runner Selection (Symfony)

Use when

• Before the first PHP, console, composer or test command of a session.
• A command fails with a missing PHP, extension or database that the container provides.
• The project uses Docker Compose, Symfony Docker (FrankenPHP), DDEV or the host and the right prefix is unclear.
• The containers may be stopped and the commands must not silently run on the host.

Default workflow

1. Run the library's runtime context CLI with --format=markdown (or --format=env for scripts).
2. Read the detected Docker type (ddev, symfony-docker, a Compose file, or none) and whether the containers are running.
3. Use the prefixed console, composer and test commands it prints, such as docker compose exec php bin/console.
4. If the containers are stopped, start them with the guidance it prints (ddev start or docker compose up -d), then run it again.
5. Reuse the same prefix for every command in the session.