Développer un thème Wordpress avec Docker

Installation et configuration

Au préalable, installer Git, Docker et Docker-Compose sur votre machine de développement
- Vous pouvez suivre la procédure d'installation de Docker et Docker-Compose sous Debian 10
Commencer par cloner en local le dépôt cbn-alpin/sinp-paca-srv : git clone git@github.com:cbn-alpin/sinp-paca-srv.git
En ligne de commande, se placer dans le dossier suivant : cd sinp-paca-srv/web-srv/docker/cms.silene.eu
Créer un fichier .env adapté à votre environnement en se basant sur .env.sample : cp .env.sample .env
- Utiliser la commande id dans un terminal pour afficher vos identifiants numériques correspondant à votre utilisateur (=UID) et groupe (=GID). Renseigner la propriété WP_DEV_FPM_USER avec au format UID:GID.
- Si vous n'avez pas la possibilité de créer le lien symbolique comme indiqué ci-dessous, vous pouvez indiquer le chemin vers le dossier local de votre thème en cours de création dans la propriété WP_DEV_THEME_PATH.
- Enfin, la propriété WP_DEV_THEME_NAME permet d'indiquer le nom du dossier du thème (par défaut "silene") qui sera placé dans le dossier /var/www/html/wp-content/themes/ du container cms-wordpress.
Dans le dossier wordpress créer un lien symbolique vers le dossier hébergeant votre thème en cours de création : ln -s <mon-chemin-vers-theme> wordpress/theme
Il est maintenant temps de construire les containers :
- Créer le réseau Docker utilisé par nos "stack" : docker network create nginx-proxy
- Construire la stack "cms.silene.eu" normalement : docker-compose up –build
- Une fois la construction achevé, arrêter tout : CTRL+C
- Relancer mais en mode DEV cette fois : docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d
- Se connecter au container cms-wordpress en tant que root : docker exec -it –user root cms-wordpress /bin/bash
  - Changer le propriétaire et groupe du contenu du dossier "/var/www/html" récursivement pour lui donner le même utilisateur et groupe que celui utilisé par FPM dans le container Worpdress en mode DEV (c'est à dire les votre sur l'hôte) : cd /var/www/html ; chown -R <votre-uid>:<votre-gid> .
  - Vérifier aussi que tout les dossiers ont bien les droits 755 et les fichiers 644 sinon cela risque de poser problème avec le container Nginx (erreur 403). Au besoin, utiliser les commandes suivantes :
    - Changer les droits des dossiers : cd /var/www/html ; find . -type d -exec chmod 755 {} \;
    - Changer les droits des fichiers : cd /var/www/html ; find . -type d -exec chmod 755 {} \;
  - Les commandes précédentes peuvent afficher des erreurs qui sont dues au montage du dossier du thème Silene en lecture seule. Ils peuvent être ignoré.
- Finaliser en arrêtant puis relançant la stack : docker-compose down ; docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d
Pour lancer localement en mode développement le CMS Worpdress utiliser la commande suivante (l'ordre d'appel des fichiers .yml est important) : docker-compose -f docker-compose.yml -f docker-compose.dev.yml up
- Le CMS devrait être accessible sur l'adresse locale : http://127.0.0.1:50080
- Note : l'option -d permet de lancer la "stack" en tant que "daemon" et de ne plus voir les logs des services dans le terminal : docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d

Commandes utiles

Pour accéder au container Nginx en tant que root : docker exec -it --user root cms-nginx /bin/bash
Pour accéder au container Wordpress en tant que root : docker exec -it cms-wordpress --user root /bin/bash
Effacer tous les volumes (ATTENTION : supprime toutes les données !) : docker-compose down --volumes
Pour voir si tout vos paramètres sont correctement pris en compte par Docker Compose : docker-compose -f docker-compose.yml -f docker-compose.dev.yml config

Notes sur la gestion des permissions

Le dossier de travail local du thème est partagé avec 2 containers (cms-nginx, cms-wordpress). Afin qu'il soit accessible par les utilisateurs de ces containers, il est nécessaire de s'assurer que les dossiers qu'il contient ont bien les droits 755 et les fichiers 644 (au moins durant la phase de développement). Lorsque c'est possible, il est aussi plus pratique que l'utilisateur de l'application du container (PHP-FPM ou Nginx) utilise le même UID et GID que votre utilisateur local.
Pour le container cms-wordpress (basé sur l'image PHP officiel - variante FPM), il est nécessaire de le lancer avec un utilisateur dont l'id est identique à celui de votre utilisateur local (généralement 1000). C'est ce que permet de faire l'attribut "user:" du service cms-wordpress dans le fichier docker-compose.dev.yml. De cette façon, toute modification effectuée sur les fichiers locaux sera répercuté dans le container et restera accessible par l'utilisateur de PHP-FPM. Voir la section "Running as an arbitrary user" dans la documentation concernant l'image Wordpress et la même dans la documentation de l'image PHP.
Concernant le container cms-nginx, le changement d'utilisateur n'étant pas évidant, il suffit de s'assurer pour le dossier de travail local que :
- les dossiers aient des droits en lecture et exécution pour "les autres" (=5).
- les fichiers aient des droits en lecture pour "les autres" (=4).