init

docs/existing-project.md

@@ -0,0 +1,81 @@
+# Installing on an Existing Project
+
+It's also possible to use Symfony Docker with existing projects!
+
+First, [download this skeleton](https://github.com/dunglas/symfony-docker).
+
+If you cloned the Git repository, be sure to not copy the `.git` directory
+to prevent conflicts with the `.git` directory already in your existing project.
+
+You can copy the contents of the repository using Git and tar.
+This will not contain `.git` or any uncommitted changes.
+
+```console
+git archive --format=tar HEAD | tar -xC my-existing-project/
+```
+
+If you downloaded the skeleton as a ZIP you can just copy the extracted files:
+
+```console
+cp -Rp symfony-docker/. my-existing-project/
+```
+
+Enable the Docker support of Symfony Flex:
+
+```console
+composer config --json extra.symfony.docker 'true'
+```
+
+The [worker mode of FrankenPHP](https://frankenphp.dev/docs/worker/) is enabled by default.
+To use it with Symfony ≤ 7.3, install the FrankenPHP runtime:
+
+```console
+composer require runtime/frankenphp-symfony
+```
+
+Then update worker configuration:
+
+<!-- markdownlint-disable MD010 -->
+
+```diff
+ worker {
+ 	file ./public/index.php
++	env APP_RUNTIME Runtime\FrankenPhpSymfony\Runtime
+ 	{$FRANKENPHP_WORKER_CONFIG}
+ }
+```
+
+<!-- markdownlint-enable MD010 -->
+
+> [!TIP]
+>
+> You can disable worker mode by removing the `worker` directive from the `frankenphp`
+> global option in your `Caddyfile`.
+
+Re-execute the recipes to update the Docker-related files according to
+the packages you use:
+
+```console
+rm symfony.lock
+composer recipes:install --force --verbose
+```
+
+Double-check the changes, revert the changes that you don't want to keep:
+
+```console
+git diff
+```
+
+Build the Docker images:
+
+```console
+docker compose build --pull --no-cache
+```
+
+Start the project!
+
+```console
+docker compose up --wait
+```
+
+Browse `https://localhost`, your Docker configuration is ready!