Files

T

cedricAbonnel 53dbce5bb0 fix : gardes session OIDC + règle PHP-FPM www-data (v1.6.2)

- oidc/start.php : arrêt immédiat (500) si session_start() échoue, évite
  un flux OIDC condamné à l'échec silencieux (ex. session.save_path absent)
- oidc/callback.php : même garde + error_log sur échec du contrôle de state
  pour faciliter le diagnostic (STATE absent/présent + session_id)
- consignes.md : règle PHP-FPM — toujours user=www-data, pas le compte admin

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-15 14:34:39 +02:00

4.1 KiB

Raw Blame History

Consignes — Folio

Architecture

Folio est un moteur de blog PHP.

Dépôts et rôles

Répertoire local	Rôle	Remote Gitea
`~/Projects/folio/`	Copie du moteur Folio, branche `dev`. Tout le développement se fait ici.	`git.abonnel.fr/cedricAbonnel/folio`
`~/Projects/varlog/`	Workspace du site varlog (scripts, config).	—
`~/Projects/varlog-data/`	Articles de varlog.a5l.fr. Sync bidirectionnelle.	`cedricAbonnel/varlog`
`~/Projects/fr.abonnel.www/`	Workspace du site abonnel.fr (scripts, config).	—
`~/Projects/fr.abonnel.www-data/`	Articles de www.abonnel.fr. Sync bidirectionnelle.	`cedricAbonnel/abonnel-www`

Environnements

Site	Rôle	Mise à jour moteur	Articles
varlog.a5l.fr	Test	rsync depuis `~/Projects/folio/`	`varlog-data/` ↔ `varlog:/srv/data/folio`
www.abonnel.fr	Production	Auto (UpdateChecker vérifie `version.txt` sur Gitea)	`fr.abonnel.www-data/` ↔ `abonnel-wiki:/srv/data/folio`

Articles (`DATA_PATH`)

Les articles ne sont jamais dans le dépôt folio. Ils vivent dans un répertoire séparé, configurable via DATA_PATH dans le .env de chaque instance.

Serveur varlog : DATA_PATH=/srv/data/folio
Serveur abonnel.fr : DATA_PATH=/srv/data/folio
En local pour tester : pointer DATA_PATH vers ~/Projects/varlog-data/

La sync des articles se fait via git (pas rsync) avec les scripts pull-data.sh et push-data.sh.

Workflow moteur

Travailler sur dev dans ~/Projects/folio/

Tester sur varlog.a5l.fr :

~/Projects/varlog/scripts/sync.sh
# puis vérifier sur http://varlog.acegrp.lan (ou varlog.a5l.fr)

Quand dev est stable :
- Bumper public/version.txt (semver)
- Ajouter une entrée dans CHANGELOG.md
- Ouvrir une PR dev → main sur Gitea
Merger la PR → abonnel.fr se met à jour automatiquement.

Règle absolue : jamais de commit direct sur main.

Mise à jour du moteur (varlog)

Le poste local n'a pas de base de données. Tout ce qui touche à la DB ou au contenu s'exécute sur le serveur varlog via SSH — les scripts locaux ne font qu'ouvrir une connexion SSH et lancer le PHP distant.

Cycle de développement :

Modifier le code dans ~/Projects/folio/ (local)
Déployer et tester :

# Rsync moteur (folio → varlog) + sync articles bidirectionnel
~/Projects/varlog/scripts/sync.sh
# puis tester sur http://varlog.acegrp.lan

Si des migrations de schéma BDD sont nécessaires :

~/Projects/varlog/scripts/db-migrate.sh      # exécute le PHP sur varlog via SSH

Si des migrations de contenu sont nécessaires :

~/Projects/varlog/scripts/content-migrate.sh # exécute le PHP sur varlog via SSH

Déploiement complet en une commande (lint + rsync + DB + contenu + commit serveur) :

~/Projects/varlog/scripts/deploy.sh "message de commit"

Chemin serveur : varlog:/var/www/lan.acegrp.varlog/

Mise à jour manuelle du moteur (abonnel.fr)

À utiliser uniquement si l'UpdateChecker échoue :

cp /var/www/lan.acegrp.abonnel-www/.env /tmp/.env.bak
sudo rm -rf /var/www/lan.acegrp.abonnel-www
git clone --depth=1 https://git.abonnel.fr/cedricAbonnel/folio.git /var/www/lan.acegrp.abonnel-www
cp /tmp/.env.bak /var/www/lan.acegrp.abonnel-www/.env
cd /var/www/lan.acegrp.abonnel-www && composer install --no-dev --optimize-autoloader
php database/migrate.php
git -C /var/www/lan.acegrp.abonnel-www config user.email 'cedric@abonnel.fr'
git -C /var/www/lan.acegrp.abonnel-www config user.name 'Cédrix'

Règles à respecter

Ne jamais écraser le .env serveur (ni scp, ni réécriture). Indiquer les variables à l'utilisateur pour qu'il les saisisse lui-même.
Ne jamais versionner data/, .env, ou vendor/ dans le dépôt folio.
Toujours bumper la version et mettre à jour le changelog dans le même commit que la PR.
Dans les pools PHP-FPM, toujours utiliser user = www-data / group = www-data. cedrix est un admin ordinaire, pas un compte de service.

4.1 KiB Raw Blame History