Accessibilité

Compter les visites d'un site en PHP sans cookie

Mettre en place et vérifier la mesure d'audience du portfolio : un script JavaScript envoie la page vue, PHP incrémente des compteurs JSON verrouillés, sans cookie ni adresse IP.

Type
Procédure
Niveau
Intermédiaire
Durée
20 min
Système
AlwaysData (Linux), macOS
Outil
PHP
Versions testées
PHP 8.2 ou plus

Objectif

Afficher dans le tableau de bord les visites, les pages vues, la provenance des visiteurs et le type d'écran, sans aucune donnée personnelle.

Prérequis

Comment ça marche

  1. Sur chaque page, le script public/assets/js/audience.js envoie au serveur un petit message JSON : la page, le site d'origine, la largeur de l'écran et « nouvelle visite : oui / non ».
  2. Ce message arrive à l'adresse /api/visite, traitée par public/index.php.
  3. La classe src/Audience.php ignore les robots, puis ajoute 1 aux compteurs du jour dans data/audience-AAAA-MM.json (un fichier par mois).
  4. Le tableau de bord (Audience) lit ces fichiers et dessine les graphiques.

Étapes

Étape 1 : vérifier que la mesure est activée

Dans config.php :

'audience_enabled' => true,
'audience_keep_months' => 13,

Étape 2 : générer une visite

Ouvrez le site dans une fenêtre de navigation privée (Cmd + Maj + N dans Chrome ou Safari), puis cliquez sur deux ou trois pages.

Attention Si « Ne pas me pister » (Do Not Track) ou Global Privacy Control est activé dans votre navigateur, vos visites ne sont volontairement pas comptées. Testez avec un autre navigateur.

Étape 3 : regarder le fichier de données

Sur le serveur (en SSH), ou dans le dossier du projet en local :

cd ~/www
cat data/audience-$(date +%Y-%m).json

Résultat attendu Un fichier JSON du type "jours": { "2026-11-04": { "vues": 3, "visites": 1, "pages": { "/": 1, "/realisations": 2 }, … } }. Aucune adresse IP, aucun identifiant.

Étape 4 : vérifier que les robots sont ignorés

On simule un robot avec curl, en se présentant comme Googlebot :

curl -i -X POST https://<compte>.alwaysdata.net/api/visite \
  -A "Googlebot/2.1" \
  -H "Content-Type: application/json" \
  -d '{"p":"/test-robot","r":"","v":1,"w":1200}'

Résultat attendu La première ligne de la réponse se termine par 204 (réponse vide, toujours la même pour ne rien révéler). En relançant l'étape 3, la page /test-robot n'apparaît pas.

Étape 5 : consulter le tableau de bord

Ouvrez /admin, rubrique Audience : vous voyez les visites, les pages vues par visite, les pages les plus lues, la provenance et le type d'appareil, sur 7, 30, 90 ou 365 jours.

Les points techniques importants

  • Verrouillage : deux visites qui arrivent en même temps pourraient s'écraser. JsonStore::update() verrouille le fichier avec flock pendant la lecture et l'écriture.
  • Écriture atomique : le JSON est écrit dans un fichier temporaire puis renommé, pour ne jamais laisser un fichier à moitié écrit.
  • Limites : au plus 200 pages différentes par jour et des adresses de 120 caractères maximum, pour qu'un robot ne puisse pas remplir le disque.
  • Purge : les fichiers de plus de 13 mois sont supprimés automatiquement.

Vérification

  • Une visite en navigation privée apparaît dans Audience en moins d'une minute.
  • Le faux robot de l'étape 4 n'est pas compté.
  • Les pages /admin ne sont jamais comptées.

Dépannage

SymptômeCause probableSolution
Aucune visite comptéeDo Not Track ou bloqueur de publicité actifTester dans un autre navigateur, en navigation privée
Aucune visite comptée, même ailleursaudience_enabled à falseLe passer à true dans config.php
Permission denied dans les journauxLe dossier data/ n'est pas accessible en écriturechmod 755 data sur le serveur
Les fichiers audience-*.json apparaissent dans git statusLigne manquante dans .gitignoreAjouter data/audience-*.json : ces données restent sur le serveur

Pour aller plus loin