Running the demo

The bundle includes three independent demo applications — one for each supported Symfony version. Each runs with FrankenPHP and Caddy inside Docker and can be started independently.

The demo/ folder is not included when you install the bundle via Composer. It exists only in the source repository. To run the demos, clone the repository first.

Demo applications

Demo	Directory	Default port
Symfony 6.4	`demo/symfony6/`	`8001`
Symfony 7.0	`demo/symfony7/`	`8001`
Symfony 8.0	`demo/symfony8/`	`8001`

Each demo includes:

Independent docker-compose.yml for easy setup
Complete test suite to verify bundle integration
Example controller and Twig templates
Web Profiler integration
100% code coverage for demo code

To run multiple demos at once, set a different PORT in each demo’s .env file (for example, 8006, 8007, 8008).

Starting a demo

Symfony 6
Symfony 7
Symfony 8

Start the container and install dependencies

From the bundle root:

make -C demo/symfony6 up

This builds the image, installs Composer dependencies, clears the Symfony cache, and starts the server.

Open the demo

Navigate to http://localhost:8001 in your browser.The Twig Inspector toolbar appears at the bottom of the page.

Alternatively, use docker-compose directly:

cd demo/symfony6
docker-compose up -d
docker-compose exec php composer install

Start the container and install dependencies

From the bundle root:

make -C demo/symfony7 up

Open the demo

Navigate to http://localhost:8001 in your browser.

Alternatively, use docker-compose directly:

cd demo/symfony7
docker-compose up -d
docker-compose exec php composer install

Start the container and install dependencies

From the bundle root:

make -C demo/symfony8 up

Open the demo

Navigate to http://localhost:8001 in your browser.

Alternatively, use docker-compose directly:

cd demo/symfony8
docker-compose up -d
docker-compose exec php composer install

Makefile helpers

You can also use the demo/ Makefile to manage all demos from one place:

cd demo

# Start each demo
make up-symfony6
make up-symfony7
make up-symfony8

# Install dependencies
make install-symfony6
make install-symfony7
make install-symfony8

Running demo tests

Each demo has its own test suite with code coverage:

cd demo

# Run tests for each demo
make test-symfony6
make test-symfony7
make test-symfony8

# Run with coverage
make test-coverage-symfony6
make test-coverage-symfony7
make test-coverage-symfony8

# Run coverage for all demos
make test-coverage-all

Or run directly inside a demo directory:

cd demo/symfony8
docker-compose exec php composer test
docker-compose exec php composer test-coverage

FrankenPHP configuration

Each demo runs FrankenPHP (Caddy + PHP in a single container) with two Caddyfile configurations:

Aspect	Development (default)	Production
Worker mode	Off — one PHP process per request	On — workers keep app in memory
Twig cache	Off (`twig.cache: false`)	On (default)
OPcache revalidation	Every request	Default interval
HTTP cache headers	`no-store, no-cache`	Omitted
`APP_ENV`	`dev`	`prod`

The demos run in development mode by default. The Docker entrypoint detects APP_ENV=dev and copies Caddyfile.dev (no worker, cache-busting headers) over the default Caddyfile before starting FrankenPHP.

Development Caddyfile

{
  skip_install_trust
}

:80 {
  root * /app/public
  encode zstd br gzip
  header Cache-Control "no-store, no-cache, must-revalidate, max-age=0"
  header Pragma "no-cache"
  php_server
}

Do not add a worker directive inside php_server in the dev Caddyfile. With worker mode enabled, template changes won’t appear until the workers are restarted.

Production Caddyfile

{
  skip_install_trust
}

:80 {
  root * /app/public
  encode zstd br gzip
  php_server {
    worker /app/public/index.php
  }
}

To run a demo in production mode, set APP_ENV=prod and APP_DEBUG=0 in the container environment and restart:

docker-compose restart
# or from the bundle root:
make -C demo/symfony8 restart

Troubleshooting

Changes to Twig or PHP don't appear on refresh

Verify worker mode is off in the active Caddyfile (Caddyfile.dev has no worker inside php_server).
Check that config/packages/dev/twig.yaml sets twig.cache: false.
Check that docker/php-dev.ini is mounted and sets opcache.revalidate_freq=0.
Restart the container after changing the Caddyfile: docker-compose restart or make -C demo/symfony8 restart.
Hard-refresh the browser (Ctrl+Shift+R) or try a private window.

Web Profiler or Twig Inspector not visible

Confirm APP_ENV=dev and APP_DEBUG=1 are set in the container.
Ensure WebProfilerBundle, DebugBundle, and NowoTwigInspectorBundle are enabled for dev in config/bundles.php.

Clear the Symfony cache:

docker-compose exec php php bin/console cache:clear
# or
make -C demo/symfony8 cache-clear

Demo doesn't respond or 'make up' times out

The Makefile runs composer install and cache:clear in one-off containers before starting the server, then waits for an HTTP response on the configured port. Check that:

The port in .env (default PORT=8001) is not already in use.
The container started successfully: docker-compose logs php.
Required env vars such as APP_SECRET are set.

Caddyfile changes have no effect

The Caddyfile is read when FrankenPHP starts. Restart the container after any changes:

docker-compose restart
# or
make -C demo/symfony8 restart

In dev mode, the entrypoint copies Caddyfile.dev over the default. Make sure you edited Caddyfile.dev and that it is mounted correctly.

Get Started

Guides

How It Works

Contributing

Demo applications

Starting a demo

Makefile helpers

Running demo tests

FrankenPHP configuration

Development Caddyfile

Production Caddyfile

Troubleshooting

​Demo applications

​Starting a demo

​Makefile helpers

​Running demo tests

​FrankenPHP configuration

​Development Caddyfile

​Production Caddyfile

​Troubleshooting

Demo applications

Starting a demo

Makefile helpers

Running demo tests

FrankenPHP configuration

Development Caddyfile

Production Caddyfile

Troubleshooting