Installation de Portix 3

Portix 3 s’installe directement depuis un navigateur. Il n’est pas nécessaire de créer manuellement une base de données : le programme d’installation crée automatiquement la base SQLite et les fichiers de configuration nécessaires.

1. Prérequis

Avant l’installation, vérifiez que votre hébergement dispose de :

  • PHP 8.2 ou plus récent ;
  • SQLite pour PHP (pdo_sqlite) ;
  • les extensions PHP : session, dom, gd avec support WebP, iconv, fileinfo, mbstring et zip ;
  • la réécriture d’adresses activée :
  • mod_rewrite avec Apache ;
  • URL Rewrite avec IIS ;
  • ou une configuration équivalente avec Nginx.

La majorité des hébergements PHP récents disposent déjà de ces fonctions.

2. Copier Portix 3 sur le serveur

Décompressez l’archive de distribution de Portix 3.

Copiez ensuite l’ensemble de son contenu dans le dossier destiné à recevoir votre site.

Par exemple, avec XAMPP sous Windows :

C:\xampp\htdocs\monsite\

Sur un hébergement Internet, il s’agira généralement d’un dossier comme :

public_html/

ou :

www/

3. Vérifier les droits d’écriture

PHP doit pouvoir écrire dans les dossiers suivants :

  • database/
  • sessions/
  • tmp/
  • var/sys/
  • var/private/
  • var/uploads/images/

Sous Windows/XAMPP, aucune modification particulière n’est normalement nécessaire.

Sur un serveur Linux, vérifiez que ces dossiers sont accessibles en écriture par PHP ou par l’utilisateur utilisé par le serveur Web.

Il n’est pas nécessaire de créer vous-même une base de données MySQL ou MariaDB : Portix 3 utilise sa propre base SQLite.

4. Lancer l’installation

Ouvrez votre navigateur et rendez-vous à l’adresse :

https://votresite/install.php

Pour une installation locale avec XAMPP, par exemple :

http://localhost/monsite/install.php

L’installateur vous demande trois informations principales :

Nom du site

Indiquez le titre qui sera utilisé pour votre site.

Vous pourrez le modifier ultérieurement dans la configuration de Portix 3.

Pseudonyme de l’administrateur

Choisissez le nom avec lequel vous vous connecterez à Portix 3.

Le pseudonyme doit contenir entre 2 et 64 caractères et peut utiliser des lettres, chiffres ainsi que les caractères :

_ . -

Adresse e-mail

Indiquez une adresse e-mail valide pour le premier compte administrateur.

Mot de passe

Choisissez un mot de passe comportant au minimum 12 caractères.

Une fois ces informations renseignées, lancez l’installation.

Portix 3 crée alors automatiquement :

  • la base de données SQLite ;
  • les tables nécessaires ;
  • les modules fournis avec la distribution ;
  • le premier compte administrateur ;
  • les réglages de base du site ;
  • un premier contenu permettant de commencer la personnalisation.

5. Première connexion

Une fois l’installation terminée, ouvrez le site :

https://votresite/accueil.html

Pour vous connecter à l’administration, utilisez :

https://votresite/login.html

Un lien discret ☠ situé dans le pied de page permet également d’accéder à cette page lorsque vous n’êtes pas connecté.

Utilisez le pseudonyme et le mot de passe définis pendant l’installation.

Après connexion, Portix 3 affiche les outils correspondant à vos droits.

L’administration générale est accessible depuis :

Admin.html

Mot de passe oublié

Le lien « Mot de passe oublié » de la page login.html ouvre forgot-password.html. Après saisie de l’adresse du compte, Portix envoie un lien valable une heure et utilisable une seule fois. L’adresse publique du site et l’identité d’expédition des messages système doivent avoir été renseignées dans la configuration générale.

La connexion et la récupération du mot de passe utilisent une limitation persistante côté serveur. Changer ou supprimer le cookie du navigateur ne supprime pas le délai. Les échecs de connexion entraînent une attente progressive ; les demandes valides de récupération sont limitées à une par minute.

6. Premiers réglages conseillés

Après votre première connexion, commencez par ouvrir le Tableau de bord.

Il distingue deux types de fonctions :

  • Gestion de contenu, en bleu : rédaction et gestion des contenus du site ;
  • Administration et configuration, en rouge : réglages généraux et fonctions réservées à l’administrateur.

Il est conseillé de vérifier en priorité :

Configuration générale

Renseignez notamment :

  • le nom du site ;
  • son adresse publique ;
  • sa description ;
  • la page à utiliser comme page d’accueil.

Utilisateurs

Créez éventuellement d’autres comptes et attribuez-leur les droits appropriés :

  • Administrateur : accès à la configuration et à l’administration du site ;
  • Rédacteur : accès aux fonctions de gestion de contenu.

Contact

Si vous utilisez le formulaire de contact, configurez l’adresse utilisée pour recevoir les notifications et l’identité d’expédition du site.

L’adresse de notification reçoit les nouveaux messages. L’adresse d’expédition est l’identité générique utilisée pour envoyer les réponses et ne doit pas être remplacée par l’adresse privée de la personne qui répond.

Modules

Activez uniquement les modules dont vous avez besoin.

Les modules désactivés ne sont pas accessibles depuis le site public.

7. Sécuriser l’installation

Après une installation réussie, Portix 3 crée son fichier de configuration et empêche automatiquement de recommencer une nouvelle installation par-dessus le site existant.

Pour un site en production, il est néanmoins recommandé de supprimer le fichier :

install.php

Conservez également une sauvegarde régulière des dossiers contenant vos données :

database/

var/sys/

var/private/

var/uploads/images/

8. Mettre à jour un site en production

Une mise à jour ne doit pas être traitée comme une installation neuve. Ne supprimez pas le site existant avant de copier la nouvelle version.

Copiez les fichiers de la nouvelle distribution par-dessus l’installation existante en conservant database/, var/sys/, var/private/ et var/uploads/images/.

Depuis la racine du site, lancez ensuite :

php tools/update_portix3.php

Avec XAMPP sous Windows :

& "C:\xampp\php\php.exe" tools\update_portix3.php

Avant toute migration, Portix place brièvement le site en mode maintenance HTTP 503 puis crée une sauvegarde horodatée dans var/private/update-backups/. Elle contient un snapshot cohérent de la base SQLite, la configuration, les images importées et les fichiers privés. Si cette sauvegarde échoue, aucune migration n’est lancée.

À partir de la 0.7.2, la version installée est suivie dans var/sys/release.json. Une rétrogradation vers une version plus ancienne est refusée.

Après une mise à jour réussie, le mode maintenance est retiré et il faut relancer le validateur complet sur l’adresse du site. Si une erreur survient après le début des migrations, le verrou var/sys/maintenance.lock reste volontairement actif jusqu’au contrôle ou à la restauration de la sauvegarde.

9. Vérifier l’installation

Si vous disposez d’un accès à la ligne de commande, Portix 3 fournit son propre outil de vérification.

Depuis le dossier racine du site :

php tools/validate_release.php --http=https://votresite

Avec XAMPP sous Windows, par exemple :

& "C:\xampp\php\php.exe" tools\validate_release.php --http=http://localhost/monsite

Le programme vérifie notamment :

  • la version et les extensions PHP ;
  • la syntaxe des fichiers ;
  • la base de données ;
  • les modules ;
  • le moteur de templates ;
  • la sécurité ;
  • l’accessibilité automatisable ;
  • les principales pages du site.

Une installation correcte se termine par :

Validation automatisée de Portix 3 0.7.09 : OK

Installation terminée

Portix 3 est maintenant prêt à être utilisé.

Connectez-vous à login.html (cliquez sur ☠ en bas de page), ouvrez le Tableau de bord et commencez par configurer votre site avant de créer et publier vos premiers contenus.

Installation initiale et documentation

L’installateur crée automatiquement les trois catégories de documentation, les sept articles de référence et les deux actualités de démarrage distribués avec Portix 3.

Le fichier source de ce contenu est src/Installation/default-content.json. Une release doit conserver ce fichier synchronisé avec la documentation réellement livrée.

Versions des modules

Un module distribué doit déclarer sa version dans son manifeste desc.xml avec une balise <Version>. Le gestionnaire de modules peut ainsi afficher la version installée. Lorsqu’un fichier MODULE-VERSION est présent, il doit rester cohérent avec le manifeste.

Intégration continue

Le dépôt P3 peut exécuter automatiquement la validation de release sous PHP 8.2, 8.3 et 8.4. Le workflow vérifie les extensions requises puis lance tools/validate_release.php.

Cette automatisation complète les tests locaux : elle ne remplace pas les contrôles réels dans le navigateur ni les vérifications propres à l’hébergement.