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
- Un compte AlwaysData (offre gratuite, environ 100 Mo)
- Le code du portfolio sur un dépôt GitHub public (par exemple une copie de portfolio-dashboard)
- Savoir ouvrir une connexion SSH : voir Se connecter en SSH à AlwaysData
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
- Menu Web › Sites, icône de modification sur la ligne
<compte>.alwaysdata.net. - Type : PHP.
- Répertoire racine :
/www/public/ - 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.netaffiche la page d'accueil, avec le cadenas HTTPS.https://<compte>.alwaysdata.net/sitemap.xmlliste toutes les pages./admindemande 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ôme | Cause probable | Solution |
|---|---|---|
git clone demande un identifiant | Le 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 exists | Le dossier www existe encore | Faire d'abord mv www www-ancien |
| Page blanche ou erreur 500 | Version de PHP trop ancienne | Refaire l'étape 1 (PHP 8.2 ou plus) |
| La page par défaut d'AlwaysData s'affiche | Ré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.