# Partagez des données entre votre container Docker en cours d'exécution et votre ordinateur > Activez la persistance des données dans Docker ! Découvrez comment utiliser les volumes (-v) pour partager et gérer efficacement des fichiers entre votre machine hôte et vos containers en cours d'exécution. ---  **TL;DR** Cet article explique les volumes Docker : sans `-v`, tout ce que le container écrit reste uniquement dans sa propre mémoire et disparaît quand le container est supprimé (pratique pour exécuter sans risque des scripts non fiables) ; ajouter `-v $(pwd):/var/www/html` synchronise dans les deux sens un dossier de l'host avec un dossier du container, et ajouter `-u ${UID}:${GID}` garantit que les fichiers créés dans le container vous appartiennent au lieu d'appartenir à `root`. > Si vous n'avez pas encore Docker, consultez d'abord mon article [Install Docker and play with PHP](/blog/install-docker). Quand vous lancez Docker sans spécifier de volume, tout ce qui se passe pendant l'exécution se passe en mémoire. Autrement dit : si le script PHP que vous exécutez depuis Docker crée des dossiers ou des fichiers, ils ne seront pas créés sur votre disque. Ils seront créés exclusivement en mémoire. ## Ce que `-v` fait pour vous {#what--v-does-for-you} Démarrez un container PHP + Apache en partageant votre dossier courant avec le dossier servi par Apache : ```bash $ docker run --detach --name step_1_2 -p 81:80 -v $(pwd):/var/www/html php:8.3-apache ``` Créez maintenant un fichier `index.php` dans ce dossier. Sur votre disque, dans votre éditeur, pas dans le container : **index.php** ```php Hello world! I'm a shared script"; ``` Rendez-vous sur `http://127.0.0.1 : 81 /` et le container le sert déjà : > Screenshot — http\://127.0.0.1:81/ > >  Pas de copie, pas de rebuild, pas de `docker cp`. Vous avez enregistré un fichier et le container l'a vu. ## Pourquoi ça marche {#why-it-works} * Sans `-v`, tout ce que le container écrit ne vit qu'en mémoire : supprimez le container et c'est perdu. C'est le comportement par défaut, et c'est une fonctionnalité (voir *Sous le capot* plus bas). * Avec `-v`, le partage est **bi-directionnel** : votre éditeur écrit un fichier, le container le voit ; le script PHP écrit un fichier dans `/var/www/html`, il apparaît sur votre disque. * Le flag `-u` décide *à qui appartiennent* les fichiers que le container crée sur votre disque. Oubliez-le et vous récupérerez des fichiers appartenant à `root` dans votre propre projet. ## À vous de jouer {#doing-it-yourself} Pour cet article, créons un dossier temporaire dans votre dossier `/tmp` : démarrez une console Linux et exécutez `mkdir /tmp/docker-volume && cd /tmp/docker-volume`, puis lancez la commande `docker run` montrée plus haut. > **Information:** > > Si vous utilisez Windows (MS DOS), remplacez `$(pwd)` par `%CD%` dans l'instruction ci-dessus. Explication des arguments utilisés dans cette commande : * `--name` step\_1\_2 : pour plus de clarté, nous utilisons un autre nom, * `-p 81 :80` : cette fois, nous utilisons le port 81 sur notre ordinateur et nous le mappons sur le port `80` du container, * `-v $(pwd):/var/www/html` : l'instruction `-v` sert à définir un volume. Ici, nous synchronisons le dossier `/var/www/html` du container avec `$(pwd)` (ou `${PWD}` en notation Linux), qui correspond au dossier courant sur notre ordinateur. Pour créer le fichier `index.php`, si vous avez Visual Studio Code sur votre machine, exécutez ceci dans la console Linux : `cd /tmp/docker-volume && code index.php`. Cela démarre vscode et vous pourrez créer le script. ## Le même container, avant que le fichier existe {#the-same-container-before-the-file-existed} Si vous vous rendez sur `http://127.0.0.1 : 81 /` *avant* de créer `index.php`, vous obtenez plutôt ceci : > Screenshot — http\://127.0.0.1:81/ > >  Comme vous le savez probablement, Apache affiche par défaut le contenu du dossier `/var/www/html`. Et, à ce moment-là, nous n'avons pas de fichier `index.php` dans notre container, donc nous obtenons la page **Forbidden**. Même container, même commande ; la seule chose qui a changé entre cette capture et la précédente, c'est un fichier que vous avez enregistré sur votre propre disque. *Ce que nous avons utilisé ici est un **bind mount** : un de vos dossiers, monté dans le container. Docker propose aussi des volumes *gérés*, qu'il stocke lui-même quelque part en dehors de votre projet ; [Using volumes with Docker, use cases](/blog/docker-volumes) compare les deux et explique quand préférer l'un à l'autre.* ## Sous le capot (passez cette section si vous voulez juste l'utiliser) {#under-the-hood-skip-this-if-you-just-want-to-use-it} > **Note:** > > Imaginez que vous vouliez jouer avec un script PHP malveillant. Exécuter le script *sur* votre ordinateur est vraiment dangereux puisque vous ne savez pas ce que le virus va faire ; où il va créer des fichiers. Mais si vous exécutez le script du virus dans un container Docker **sans volume attaché** (ce qui est le comportement par défaut), rien sur votre ordinateur ne sera modifié. Tout reste en mémoire (RAM). En supprimant le container Docker, tout sera supprimé. C'est une excellente fonctionnalité de sécurité. Passons maintenant à la question de la propriété des fichiers : > **Caution:** > > Les fichiers ou dossiers créés dans le container Docker appartiendront à l'utilisateur courant utilisé dans le container ; le plus souvent l'utilisateur `root`. Ces fichiers/dossiers seront donc aussi créés / mis à jour par l'utilisateur `root` sur votre disque. Pour être sûr que les fichiers/dossiers créés dans le container vous appartiennent et n'appartiennent pas à `root`, modifiez la ligne de commande comme ceci : ```bash `$ docker run --detach --name step_1_2 -p 81:80 -v $(pwd):/var/www/html -u \${UID}:\${GID} php:8.3-apache` ``` Le nouveau flag `-u ${UID}:${GID}` réutilise votre id utilisateur et votre id de groupe courants et transmet cette information à Docker. Désormais, l'utilisateur courant dans le container Docker ne sera plus `root` mais un utilisateur avec vos uid/gid locaux. Les fichiers/dossiers créés dans le container Docker vous appartiendront donc, sur votre disque. ## Conclusion {#conclusion} Un seul flag, `-v host_folder:container_folder`, et votre éditeur devient l'éditeur du container. Les deux choses à retenir dans trois mois : la synchronisation va dans les deux sens, et `-u ${UID}:${GID}` est ce qui empêche `root` de s'approprier vos fichiers. Un bind mount n'est qu'un des deux types de volume proposés par Docker. Quand les données appartiennent au container plutôt qu'à vous (une base de données, un cache), un volume géré est le bon outil : [Using volumes with Docker, use cases](/blog/docker-volumes) passe en revue les trois stratégies.