emiliechnvt/frankenphp

A minimal Symfony project recommended to create bare bones applications

dev-main 2025-10-27 16:57 UTC

Requires

• php: >=8.4.14
• ext-ctype: *
• ext-iconv: *
• doctrine/dbal: ^3.10.3
• doctrine/doctrine-bundle: ^2.18
• doctrine/doctrine-migrations-bundle: ^3.5
• doctrine/orm: ^3.5.2
• phpdocumentor/reflection-docblock: ^5.6.3
• phpstan/phpdoc-parser: ^2.3
• runtime/frankenphp-symfony: ^0.2.0
• symfony/asset: 7.3.*
• symfony/asset-mapper: 7.3.*
• symfony/console: 7.3.*
• symfony/doctrine-messenger: 7.3.*
• symfony/dotenv: 7.3.*
• symfony/expression-language: 7.3.*
• symfony/flex: ^2.8.2
• symfony/form: 7.3.*
• symfony/framework-bundle: 7.3.*
• symfony/http-client: 7.3.*
• symfony/intl: 7.3.*
• symfony/mailer: 7.3.*
• symfony/mime: 7.3.*
• symfony/monolog-bundle: ^3.10
• symfony/notifier: 7.3.*
• symfony/process: 7.3.*
• symfony/property-access: 7.3.*
• symfony/property-info: 7.3.*
• symfony/runtime: 7.3.*
• symfony/security-bundle: 7.3.*
• symfony/serializer: 7.3.*
• symfony/stimulus-bundle: ^2.31
• symfony/string: 7.3.*
• symfony/translation: 7.3.*
• symfony/twig-bundle: 7.3.*
• symfony/ux-turbo: ^2.31
• symfony/validator: 7.3.*
• symfony/web-link: 7.3.*
• symfony/yaml: 7.3.*
• twig/extra-bundle: ^2.12|^3.21
• twig/twig: ^2.12|^3.21.1

Requires (Dev)

• phpunit/phpunit: ^12.4.1
• symfony/browser-kit: 7.3.*
• symfony/css-selector: 7.3.*
• symfony/debug-bundle: 7.3.*
• symfony/maker-bundle: ^1.64
• symfony/stopwatch: 7.3.*
• symfony/web-profiler-bundle: 7.3.*

Conflicts

• symfony/symfony: *

Replaces

• symfony/polyfill-ctype: *
• symfony/polyfill-iconv: *
• symfony/polyfill-php72: *
• symfony/polyfill-php73: *
• symfony/polyfill-php74: *
• symfony/polyfill-php80: *
• symfony/polyfill-php81: *
• symfony/polyfill-php82: *

MIT

README

A Docker-based installer and runtime for the Symfony web framework, with FrankenPHP and Caddy inside!

Getting Started

1. If not already done, install Docker Compose (v2.10+)
2. Run docker compose build --pull --no-cache to build fresh images
3. Run docker compose up --wait to set up and start a fresh Symfony project
4. Open https://localhost in your favorite web browser and accept the auto-generated TLS certificate
5. Run docker compose down --remove-orphans to stop the Docker containers.

Features

• Production, development and CI ready
• Just 1 service by default
• Blazing-fast performance thanks to the worker mode of FrankenPHP
• Installation of extra Docker Compose services with Symfony Flex
• Automatic HTTPS (in dev and prod)
• HTTP/3 and Early Hints support
• Real-time messaging thanks to a built-in Mercure hub
• Vulcain support
• Native XDebug integration
• Super-readable configuration

Enjoy!

Docs

1. Options available
2. Using Symfony Docker with an existing project
3. Support for extra services
4. Deploying in production
5. Debugging with Xdebug
6. TLS Certificates
7. Using MySQL instead of PostgreSQL
8. Using Alpine Linux instead of Debian
9. Using a Makefile
10. Updating the template
11. Troubleshooting

License

Symfony Docker is available under the MIT License.

Credits

Created by Kévin Dunglas, co-maintained by Maxime Helias and sponsored by Les-Tilleuls.coop.