Accessibilité

Déployer le portfolio sur AlwaysData (version PHP)

Mettre en ligne le site PHP et son tableau de bord sur l'offre gratuite d'AlwaysData : SSH, clone du dépôt, compte administrateur, racine public/ et tâche planifiée de supervision.

Type
Procédure
Niveau
Débutant
Durée
25 min
Système
AlwaysData (Linux)
Outil
AlwaysData
Versions testées
PHP 8.2 ou plus

Objectif

Publier le portfolio (pages publiques et tableau de bord /admin) sur une adresse en HTTPS du type https://<compte>.alwaysdata.net, gratuitement.

Prérequis

Remarque Remplacez <compte> par votre nom de compte AlwaysData et <utilisateur>/<depot> par l'adresse de votre dépôt GitHub.

Étapes

Étape 1 : choisir la version de PHP

Dans admin.alwaysdata.com, menu Environnement, partie PHP : choisissez 8.2 ou plus récent et enregistrez. Le code utilise des fonctions apparues avec PHP 8.1.

Étape 2 : se connecter au serveur

ssh <compte>@ssh-<compte>.alwaysdata.net

Résultat attendu L'invite affiche <compte>@ssh…:~$.

Étape 3 : copier le site sur le serveur

On met de côté la page par défaut d'AlwaysData (on la renomme, on ne supprime rien), puis on télécharge le dépôt dans le dossier www :

mv www www-ancien
git clone https://github.com/<utilisateur>/<depot>.git www

Résultat attendu Quelques lignes défilent et se terminent par « done ». La commande ls www affiche public, src, data, templates…

Étape 4 : créer le compte du tableau de bord

cd www
php bin/create-admin.php

Choisissez un identifiant, puis un mot de passe de 12 caractères minimum (rien ne s'affiche pendant la frappe). Le détail est dans Créer le compte administrateur et protéger /admin.

Résultat attendu « Compte administrateur enregistré. »

Étape 5 : faire pointer l'adresse vers le dossier public

  1. Menu Web › Sites, icône de modification sur la ligne <compte>.alwaysdata.net.
  2. Type : PHP.
  3. Répertoire racine : /www/public/
  4. Enregistrez.

Important Seul le dossier public/ doit être visible depuis Internet. Les données JSON (data/) et le code PHP (src/) restent ainsi hors de portée des visiteurs.

Étape 6 : lancer la supervision automatique

Ajoutez une tâche planifiée qui lance php $HOME/www/bin/monitor.php toutes les 15 minutes. La procédure complète est dans Planifier une tâche avec cron sur AlwaysData.

Vérification

  • https://<compte>.alwaysdata.net affiche la page d'accueil, avec le cadenas HTTPS.
  • https://<compte>.alwaysdata.net/sitemap.xml liste toutes les pages.
  • /admin demande un identifiant, puis affiche le tableau de bord.
  • Supervision › Vérifier maintenant affiche « En ligne ».
  • Une visite en navigation privée apparaît dans Audience.

Mise à jour

Les mises à jour suivantes se font avec git pull, en prenant une précaution pour ne pas perdre les modifications faites en ligne : voir Mettre à jour le site avec git pull.

Dépannage

SymptômeCause probableSolution
git clone demande un identifiantLe dépôt GitHub est privéLe passer en public (Settings › Danger Zone › Change visibility) : aucun secret n'y est enregistré
fatal: destination path 'www' already existsLe dossier www existe encoreFaire d'abord mv www www-ancien
Page blanche ou erreur 500Version de PHP trop ancienneRefaire l'étape 1 (PHP 8.2 ou plus)
La page par défaut d'AlwaysData s'afficheRépertoire racine mal régléMettre exactement /www/public/ à l'étape 5
/admin affiche « Page introuvable »Tableau de bord désactivéVérifier 'admin_enabled' => true dans config.php

Sécurité et bonnes pratiques

  • Le fichier du compte (data/admin.json) est exclu de Git par .gitignore : il n'est jamais envoyé sur GitHub.
  • Ne mettez jamais un mot de passe ou une clé dans le dépôt, même privé.

Pièges rencontrés

  • Mon dépôt était privé : AlwaysData ne pouvait pas le télécharger.
  • J'ai d'abord confondu les trois identifiants (compte AlwaysData, utilisateur SSH, compte du tableau de bord).
  • Le bouton de publication GitHub Pages hérité de l'ancienne version échouait : il a été retiré de cette copie, qui se publie seulement sur AlwaysData.