Décryptage des votes de l'Assemblée nationale — https://datan.fr. Symfony 8.1, PHP 8.4, MariaDB 11.4.13 — en local comme en production.
Conventions et pièges métier : CLAUDE.md. Mise en production : DEPLOIEMENT.md. Planification : CRON.md.
- PHP ≥ 8.4 avec
intl,mysqli,gd,mbstring,xml,curl,zip. Sous Debian/Ubuntu (dépôtondrej/php) :php8.4-{cli,fpm,mysql,intl,gd,mbstring,xml,curl,zip}.intln'est pas facultative : sans elle, les fiches de députés tombent. - Composer 2 et Git — Git sert aussi à l'exécution, pour moissonner les données.
- MariaDB 11.4.13, la version de la production : le script du §1 l'installe dans le dossier personnel, sans sudo. Aucun autre moteur n'est pris en charge — MySQL 8 a déjà laissé partir en production du SQL que MariaDB n'avait jamais exécuté.
- ~6 Go de disque : 1,7 Go de base, 1,8 Go de clones de données, 1,2 Go de binaires MariaDB.
git clone -b symfony git@github.com:datanfr/datan.git && cd datan
bin/mariadb-locale.sh installerLe script télécharge l'archive officielle (somme de contrôle épinglée), la pose
sous ~/.local/opt/, initialise les données sous ~/.local/share/mariadb-datan/
et crée la base datan_symfony (utf8mb4_unicode_ci) avec le compte
datan / datan. Le serveur écoute sur 127.0.0.1:3307 seulement, pour ne
gêner aucun autre moteur du poste. Il tourne en unité systemd utilisateur
(mariadb-datan.service) et repart donc avec le poste ; sans systemd
utilisateur, relancer bin/mariadb-locale.sh demarrer après chaque démarrage.
Rien n'est réglé qui change le résultat d'une requête : mode SQL et collations
sont les défauts de MariaDB 11.4, ceux de la production — strict, et sans
ONLY_FULL_GROUP_BY.
bin/mariadb-locale.sh etat # version, port, mode SQL, collation de la base
bin/mariadb-locale.sh console # client mariadb, compte datan, base datan_symfony
bin/mariadb-locale.sh admin # tous les droits, par la socket
bin/mariadb-locale.sh dump … # mariadb-dump, compte datan
bin/mariadb-locale.sh arreter # ou demarrer, redemarrerQui a déjà une MariaDB ≥ 11.4 système peut s'en servir : y créer la base
(CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci) et le compte, et adapter
port et serverVersion au §2.
Créer .env.local (non versionné) avant composer install, dont les
scripts démarrent le noyau. Sans lui, Symfony prend les valeurs de .env.dist —
production, base fictive — et toute page répond 500.
APP_ENV=dev
APP_SECRET= # php -r 'echo bin2hex(random_bytes(32));'
DATABASE_URL="mysqli://datan:datan@127.0.0.1:3307/datan_symfony?serverVersion=11.4.13-MariaDB&charset=utf8mb4"
DEFAULT_URI=http://127.0.0.1:8000serverVersion doit dire la version réelle du serveur, suffixe -MariaDB
compris (bin/mariadb-locale.sh etat), sinon Doctrine produit des diffs de
schéma fantômes. mysqli est le nom du pilote PHP, pas du moteur.
Ces quatre lignes suffisent. Toutes les autres variables ont une valeur par
défaut (config/services.yaml) et leur mode d'emploi dans .env.dist ; on ne
les pose dans .env.local que pour activer ce qu'elles règlent :
| Variable | Par défaut | Ce qu'elle règle |
|---|---|---|
MATOMO_URL |
vide | Suivi d'audience. Vide, aucun script n'est rendu : à ne remplir qu'en production. |
CORS_ALLOW_ORIGIN |
localhost et 127.0.0.1 |
Les sites autorisés à appeler /api depuis un navigateur. |
MAILER_DSN |
null://null |
L'envoi des courriels. Par défaut, rien ne part. |
MESSENGER_TRANSPORT_DSN |
doctrine://default?auto_setup=0 |
La file des tâches de fond (courriels, réchauffage du cache). |
MAILJET_API_KEY, MAILJET_API_SECRET, MJML_APP_ID, MJML_SECRET_KEY |
vides | La newsletter. Vides, les inscriptions restent en base et rien n'est envoyé. |
IA_MODELE, OLLAMA_URL, ANTHROPIC_API_KEY |
vide, http://localhost:11434, vide |
Le brouillon de décryptage par IA. IA_MODELE vide le désactive. |
IA_MODELE_RESUMES |
claude-haiku-5-5 |
Le modèle des résumés d'amendements ; demande ANTHROPIC_API_KEY. |
Deux pièges du chargement de ces fichiers :
- Pas de fichier
.env. Il n'est pas dans le dépôt. S'il en reste un d'une ancienne installation, Symfony le lit à la place de.env.dist: le supprimer. .env.devpasse après.env.localet l'emporte sur lui. Une valeur à régler pour le seul développement se pose dans.env.dev.local.
composer installDeux voies, au choix.
Demander un dump récent à l'équipe (fabriqué selon DEPLOIEMENT.md §2.a), puis :
zcat datan_2*.sql.gz | bin/mariadb-locale.sh console
php bin/console doctrine:migrations:migrate -n # migrations postérieures au dump
php bin/console messenger:setup-transports # le dump exclut messenger_messages
APP_ENV=prod php bin/console app:sync:quotidien # votes récents + portraits des députésLe dump vient du même moteur et se recharge tel quel, structure comprise
(~1 min pour 1 Go). Le premier app:sync:quotidien clone 1,8 Go de dépôts et
réimporte tout ; les suivants ne lisent que le delta (~50 s). Les portraits
(public/assets/imgs/deputes/) ne sont pas versionnés : c'est lui qui les
produit.
php bin/console doctrine:migrations:migrate -n
APP_ENV=prod php bin/console app:sync:quotidien --toutOn obtient la législature en cours. Pour les législatures 14 à 16 (facultatif) :
APP_ENV=prod php bin/console app:tricoteuses:sync --depot=scrutins-xiv --depot=scrutins-xv --depot=scrutins-xvi
for d in xiv xv xvi; do APP_ENV=prod php bin/console app:import:scrutins --depot=scrutins-$d --tout; done
for n in 14 15 16; do APP_ENV=prod php bin/console app:calcul:statistiques-deputes --legislature=$n; doneLe contenu éditorial — décryptages, explications de vote, blog — et la géographie électorale — communes, résultats des élections — ne sont pas dans l'open data : seul le dump les apporte.
php bin/console sass:build --watch # compile la feuille de style (cf. plus bas)
symfony server:start # ou : php -S 127.0.0.1:8000 -t publicSite sur http://127.0.0.1:8000. Pour accéder à la rédaction (/login) :
php bin/console app:utilisateur:creer moi "Mon Nom" --admin| Quoi | Où | Appel dans un gabarit |
|---|---|---|
| Styles du site | assets/styles/main.scss |
asset('styles/main.scss') (déjà dans base.html.twig) |
| Styles de la rédaction | assets/styles/admin/*.css |
asset('styles/admin/….css') |
| Scripts du site | assets/scripts/*.js |
asset('scripts/….js') |
| CSS critique (généré) | assets/styles/critical/ |
bloc css_critique (cf. plus bas) |
| Bibliothèques tierces, images, polices, documents | public/assets/ |
asset('assets/…') |
Tout ce qui est dans assets/ passe par AssetMapper : servi sous /build/,
avec un condensat du contenu dans le nom (main-lkKi-Il.css). Le navigateur
peut donc le garder un an, et une modification change l'adresse. Ce qui est
dans public/assets/ garde le chemin qu'il a depuis toujours, et asset() lui
ajoute le condensat de son contenu en paramètre (logo.png?v=3f9a1c07b2) : on
n'y écrit pas de code, seulement des fichiers tiers ou binaires.
- Bootstrap 4.6.2 vient de Composer (
twbs/bootstrap) et non de npm.main.scssl'importe avec@import "bootstrap", et ses variables se surchargent en tête du fichier. La version est figée : la 5 casserait toutes les classes du site. - Dans le SCSS, les
url()vers les images s'écrivent en absolu (/assets/imgs/…). La feuille est servie depuis/build/styles/, si bien qu'un chemin relatif ne retombe plus surpublic/assets/. Ces adresses-là n'ont pas de version : une image citée dans une feuille de style ne change pas de contenu sans changer de nom (cf. « Cache »). - Les scripts sont des scripts classiques, pas des modules ES : ils
s'appuient sur le jQuery global chargé par
base.html.twig. Pas d'import, donc. AssetMapper analyse lesimportet refuserait un paquet absent deimportmap.php. - Exception : les scripts de la rédaction (
public/assets/js/dashboard/).init-ckeditor.jsest un module qui importeckeditor5par l'importmap écrit à la main dans les formulaires d'administration. Il reste où il est. public/assets/js/dist/chart.min.jsest un paquet figé (Chart.js 4.4.1 et le greffon datalabels 2.2.0), construit autrefois par le rollup du legacy à partir depublic/assets/js/custom/import_chartjs.js. On ne le retouche pas, on le remplace.
En développement, seul le SCSS se compile ; les scripts sont servis
directement depuis assets/scripts/, lisibles et non minifiés :
php bin/console sass:build --watch # recompile main.scss à chaque enregistrementSans cette compilation, toute page répond 500 avec un message explicite
(« var/sass/main-….output.css doesn't exist, run php bin/console sass:build »).
dart-sass est téléchargé dans var/dart-sass/ au premier lancement ; ni Node ni
npm ne sont nécessaires.
En production, le workflow de déploiement exécute :
php bin/console sass:build # assets/styles/main.scss → var/sass/
php bin/console asset-map:compile # tout assets/ → public/build/, minifiéLa minification (CSS et JS) est faite au moment d'asset-map:compile par
sensiolabs/minify-bundle, qui télécharge son binaire dans var/minify/. Elle
est coupée en dev.
Ne pas lancer asset-map:compile en local, ou bien supprimer public/build/
juste après. Tant que public/build/manifest.json existe, le mode dev sert ces
fichiers figés au lieu de vos sources, sans le signaler.
Sur trois pages, l'accueil, la ville et le groupe (comme sur datan.fr), le
<head> ne charge d'abord qu'un extrait de main.css : ce qu'il faut pour
afficher le premier écran. La feuille complète arrive ensuite sans bloquer le
rendu. Une page s'y inscrit par un bloc :
{% block css_critique %}city{% endblock %} {# → assets/styles/critical/city.css et city-mobile.css #}Les extraits se mesurent dans un vrai navigateur, sur une page réellement servie. C'est la seule étape qui demande Node (≥ 22) :
npm ci && npx playwright install chromium # une fois
BASE_URL=https://datan.fr npm run critiqueBASE_URL doit pointer sur un site aux données complètes et qui sert la
même version des gabarits. Une base locale incomplète raccourcit les pages,
et l'extrait omet alors des blocs que la production affiche au premier écran.
Pour mesurer le HTML de la production avec un main.css compilé sur votre
poste, ajouter CSS_URL=http://127.0.0.1:8000/build/styles/main-….css.
À relancer quand le haut de l'une de ces trois pages change de mise en page,
ou qu'une modification de main.scss touche à ce qui s'y affiche. Puis
committer assets/styles/critical/. Un extrait périmé ne casse rien, puisque
main.css arrive juste après et a le dernier mot, mais la page « saute » au
moment où la feuille complète s'applique. Pages, adresses et dimensions sont
déclarées en tête de bin/css-critique.mjs.
Un extrait s'applique à toute la page, pas au seul premier écran. Une règle
gardée pour un élément du haut vaut aussi pour ceux qu'elle désigne plus bas,
dont les autres règles, elles, sont restées dans main.css. C'est sans effet,
sauf pour un élément en position: absolute dont l'ancêtre a perdu son
position: relative : il s'ancre sur <body> et recouvre le premier écran
jusqu'à l'arrivée de la feuille complète. Rien ne se voit, mais le navigateur
compte un décalage de mise en page maximal (CLS de 1,0 sur l'accueil le
16/11/2026, par le ::after de .stretched-link). Le script garde donc tout
position qui sert de repère, où qu'il soit dans la page ; l'accueil porte en
plus la feuille en ligne du site d'origine (home/index.html.twig).
| Gruntfile | Aujourd'hui |
|---|---|
sass (main.scss, bootstrap.scss) |
sass:build (main.scss seul) |
purifycss + concat |
supprimés : main.scss importait déjà Bootstrap en entier, le Bootstrap purifié mis devant n'était qu'un doublon (98 Ko sur 315) |
babel (ES5) |
supprimé : tous les navigateurs lisent l'ES2015 |
uglify |
minify-bundle, pendant asset-map:compile |
rollup (Chart.js) |
paquet figé public/assets/js/dist/chart.min.js |
critical |
npm run critique |
?v=<version> dans les adresses |
condensat dans le nom du fichier |
Trois étages, tous inactifs en APP_ENV=dev sauf le premier :
- Les fichiers statiques sont gardés un an par le navigateur et le CDN,
sans jamais être revalidés. C'est sans risque parce que leur adresse change
avec leur contenu : condensat dans le nom sous
/build/, paramètre?v=…sous/assets/(App\Asset\VersionParContenu,public/assets/.htaccess). - Les pages sont rendues une fois, puis servies depuis un cache HTTP sur
disque (
App\Http\CacheAvecSession). Les pages vivantes — accueil, députés en exercice, scrutins — sont vidées après chaque synchronisation et chaque publication de la rédaction, puis les 2 500 plus lues sont remises en cache (app:cache:rechauffer). Les pages figées — élections, communes, législatures closes, anciens députés — n'expirent pas et ne sont vidées que lorsque les données qu'elles affichent ont changé (App\Http\EmpreinteFigee) ;app:cache:rechauffer --toutles vide à la main. Un déploiement repart de deux magasins vides. - Le navigateur ne garde jamais une page sans la vérifier, car on ne peut
pas la purger chez le visiteur : il la revalide par son
ETaget reçoit un304sans corps tant qu'elle n'a pas changé.
- Imports toujours en
APP_ENV=prod. En dev, Doctrine garde chaque requête en mémoire et l'import échoue. - Le conteneur prod ne voit pas les changements de code. Après une
modification,
rm -rf var/cache/prodavant la prochaine commande enAPP_ENV=prod— jamais pendant qu'une synchronisation tourne. - Un 404 sur une route neuve : vérifier
.env.local. EnAPP_ENV=prod, le site passe par le cache HTTP et le conteneur compilé ; une page de dev porte l'en-têteX-Debug-Token, une page de prod l'en-têteAge. - Une migration se joue ici avant de partir : la base locale est la version
de la production, c'est tout le contrôle. Un
CREATE TABLEécrit à la main précise sa collation —CHARACTER SET utf8mb4seul donneutf8mb4_general_cisous MariaDB 11.4, et non celle de la base. ÉcrireDEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci, comme Doctrine le génère :doctrine:schema:updatene voit pas l'écart.