AlexBa16
82 lines
1.8 KiB
Markdown
82 lines
1.8 KiB
Markdown
# 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!
|