« Symfony Docker » : différence entre les versions

Pour pouvoir exécuter des commandes '''<code>composer</code>''', '''<code>symfony</code>''' et '''<code>bin/console</code>''' depuis votre machine locale tout en les faisant affecter le conteneur Docker, voici une approche optimale basée sur des '''volumes montés''' et des '''alias pratiques'''.

=== '''1. Montage des volumes pour synchroniser les fichiers''' ===

* <code>~/.composer:/tmp/composer</code> : Cache Composer pour éviter de retélécharger les dépendances.

* <code>working_dir</code> : S’assure que les commandes s’exécutent dans <code>/var/www/html</code>.

=== '''2. Exécuter des commandes dans le conteneur depuis l’hôte''' ===

dc-console make:migration

dc-symfony serve -d</syntaxhighlight>

=== '''3. Cas particulier : Développement d’un bundle local''' ===

       - ./:/var/www/html

       - ~/.composer:/tmp/composer</syntaxhighlight>

=== '''Récapitulatif des bonnes pratiques''' ===

| Alias shell + volumes montés + Xdebug

|}

==== '''Conclusion''' ====

La commande '''<code>composer dump-autoload</code>''' est une commande essentielle dans l’écosystème PHP/Composer. Elle régénère le fichier d’'''autoloading''' (chargement automatique des classes) sans réinstaller les dépendances. Voici ce qu’elle fait en détail :

=== '''À quoi sert <code>composer dump-autoload</code> ?''' ===

<li><p>La commande les intègre dans l’autoloader.</p></li></ul>

</li></ol>

=== '''Quand l’utiliser ?''' ===

| <code>composer dump-autoload</code>

|}

=== '''Différence avec <code>composer install</code> et <code>composer update</code>''' ===

* '''<code>composer dump-autoload</code>''' :<br />

'''Ne touche pas aux dépendances''' – ne fait que mettre à jour l’autoloader.

=== '''Exemple concret dans un projet Symfony''' ===

<syntaxhighlight lang="bash">composer dump-autoload</syntaxhighlight></li></ul>

</li></ol>

=== '''Bonnes pratiques''' ===

Si vous montez un volume (<code>./:/var/www/html</code>), exécutez la commande '''dans le conteneur''' :</p>

<syntaxhighlight lang="bash">docker-compose exec app composer dump-autoload</syntaxhighlight></li></ul>

=== '''Résumé''' ===

== '''Symfony cache et composer cache avec Docker''' : ==

=== '''1. Rôle du dossier <code>/var/cache</code> dans Symfony''' ===

'''Problème avec Docker :'''<br />

Par défaut, ce cache est régénéré à chaque démarrage du conteneur → '''ralentissements''' (surtout en dev).

=== '''2. Stratégies pour optimiser le cache avec Docker''' ===

'''Inconvénients :''' - Peut causer des problèmes de permissions (solved avec <code>chmod</code> ou <code>entrypoint.sh</code>).

==== '''B. Utiliser un volume Docker nommé (prod + dev)''' ====

exec "$@"</syntaxhighlight>

==== '''C. Cache warming en production''' ====

COPY --from=builder /app /var/www/html

RUN php bin/console cache:warmup  # ⚡ Pré-chauffe le cache</syntaxhighlight>

=== '''3. Gestion des environnements''' ===

| Cache éphémère (pas de montage)

|}

=== '''4. Exemple complet (docker-compose.yml)''' ===

       APP_ENV: dev

       COMPOSER_CACHE_DIR: /tmp/composer</syntaxhighlight>

=== '''5. Bonnes pratiques''' ===

<li><p>'''Permissions''' : Résolvez-les via <code>entrypoint.sh</code> ou <code>docker-compose</code> :</p>

<syntaxhighlight lang="yaml">user: "${UID:-1000}:${GID:-1000}"</syntaxhighlight></li></ol>

=== '''Différence avec Composer Cache''' ===

| Warming dans l’image + volume

|}

=== '''Résumé''' ===

</li></ul>

</li></ol>

=== 8. Avantages de cette configuration ===

exec docker-php-entrypoint "$@"</syntaxhighlight>

Cela signifie : 1. Votre script fait d’abord son travail personnalisé (vérifier/vendor et installer les dépendances si besoin) 2. Ensuite, il “passe la main” au processus PHP-FPM officiel, devenant ainsi le processus principal du container

=== Alternative sans <code>exec</code> ===

Voici une version complète optimisée avec '''un service Composer dédié''', tout en gardant la configuration pour vos bundles locaux et l’intégration avec PHPStorm.

=== Structure finale recommandée ===

#* Port : 8080

#* Path mappings comme ci-dessus

=== ✅ Points clés de cette configuration ===