Installation

Apsionyx a été conçu pour pouvoir être installé sur un hébergement PHP classique sans imposer une infrastructure complexe.

L’installation se déroule directement depuis votre navigateur et ne demande que quelques informations essentielles concernant votre site, votre base de données et votre compte administrateur.

Avant de commencer

Avant d’installer Apsionyx, assurez-vous de disposer :

• d’un hébergement compatible avec PHP ;

• d’une base de données MariaDB ou MySQL ;

• d’un nom de domaine ou d’un sous-domaine ;

• des informations de connexion à votre base de données ;

• des droits nécessaires pour envoyer les fichiers sur votre hébergement.

Apsionyx ne nécessite ni Docker, ni Node.js, ni environnement de compilation pour fonctionner sur un serveur classique.

Prérequis

Apsionyx nécessite au minimum :

• PHP 8.3 ou une version plus récente ;

• MariaDB ou MySQL ;

• l’extension PDO pour MySQL ;

• le support des sessions PHP ;

• le support JSON ;

• un serveur web compatible avec PHP.

HTTPS est fortement recommandé pour protéger les connexions et les données échangées avec votre site.

Certaines fonctionnalités facultatives peuvent utiliser des extensions PHP supplémentaires lorsqu’elles sont disponibles.

Organisation des fichiers

Apsionyx sépare volontairement les fichiers accessibles depuis Internet du reste du CMS.

Une installation classique ressemble à ceci :

• public contient les fichiers accessibles depuis le web ;

• config contient la configuration du site ;

• var contient les données de fonctionnement, journaux, caches et fichiers propres à l’installation ;

• src contient le cœur d’Apsionyx ;

• themes contient les thèmes ;

• extensions contient les extensions.

Lorsque votre hébergeur le permet, la racine web du domaine doit pointer directement vers le dossier public.

Cette organisation évite d’exposer inutilement les fichiers internes du CMS.

Installation sur un hébergement mutualisé

Sur un hébergement mutualisé, envoyez les fichiers Apsionyx à l’aide du gestionnaire de fichiers de votre hébergeur, FTP ou SFTP.

Selon la configuration proposée par votre hébergeur, deux situations sont possibles.

La racine web peut être choisie

Si votre hébergeur permet de choisir le dossier utilisé par votre domaine, configurez-le pour qu’il pointe vers :

public

C’est la configuration recommandée.

La racine web est imposée

Certains hébergeurs imposent un dossier comme public_html, www ou htdocs.

Apsionyx peut également fonctionner dans cette configuration en séparant les fichiers publics des fichiers privés.

Consultez la documentation de votre hébergeur pour connaître la méthode adaptée à votre espace.

Installation sur un VPS ou un serveur dédié

Sur un serveur que vous administrez vous-même, installez Apsionyx dans un dossier dédié.

Par exemple :

/var/www/apsionyx

La racine web d’Apache, Nginx ou d’un autre serveur compatible doit ensuite pointer vers :

/var/www/apsionyx/public

Cette organisation permet de garder le cœur, la configuration et les données privées hors de la racine publique.

Créer la base de données

Avant de lancer l’installation, créez une base MariaDB ou MySQL ainsi qu’un utilisateur disposant des droits nécessaires sur cette base.

Vous aurez besoin de quatre informations :

• le serveur de base de données ;

• le nom de la base ;

• le nom de l’utilisateur ;

• son mot de passe.

Dans de nombreux hébergements, le serveur de base de données est simplement :

localhost

Votre hébergeur peut cependant utiliser une autre adresse.

Droits d’écriture

Pendant l’installation, Apsionyx doit pouvoir écrire dans les dossiers nécessaires à son fonctionnement.

Les dossiers concernés sont principalement :

• config pendant l’installation ;

• var pendant l’installation et le fonctionnement normal du site.

Il n’est pas nécessaire de rendre l’ensemble du CMS modifiable par le serveur web.
Évitez notamment d’attribuer des permissions excessives à tous les fichiers.

Après l’installation, le dossier config peut être rendu à nouveau non modifiable par le serveur web.

Le dossier var doit rester accessible en écriture pour permettre le fonctionnement des journaux, caches, sessions, médias internes et autres données du CMS.

Lancer l’assistant

Une fois les fichiers en place, ouvrez simplement l’adresse de votre site dans votre navigateur.

Si Apsionyx n’est pas encore installé, l’assistant d’installation s’ouvre automatiquement.

Il vous guidera à travers les principales étapes.

Étape 1 — Votre site

Renseignez les informations générales de votre site.

Vous pourrez notamment définir :

• le nom du site ;

• son adresse ;

• sa langue principale ;

• son fuseau horaire.

Les éléments de personnalisation comme le logo, l’icône, la phrase d’accroche ou les descriptions peuvent être configurés plus tard depuis l’administration.

L’installation reste ainsi volontairement courte.

Étape 2 — Base de données

Renseignez les informations correspondant à la base créée précédemment :

• serveur ;

• nom de la base ;

• utilisateur ;

• mot de passe.

Apsionyx tente alors d’établir la connexion et prépare automatiquement les données nécessaires au fonctionnement du CMS.

Si une erreur survient, un message doit vous permettre d’identifier le problème sans afficher d’informations sensibles aux visiteurs.

Étape 3 — Compte administrateur

Créez ensuite votre premier compte administrateur.

Ce compte dispose des droits nécessaires pour gérer le site.

Choisissez :

• votre nom ;

• votre adresse électronique ;

• un mot de passe robuste.

Votre adresse électronique pourra notamment être utilisée pour la gestion de votre compte et la récupération de votre accès.

Fin de l’installation

Une fois les étapes validées, Apsionyx :

• crée sa structure de données ;

• enregistre la configuration du site ;

• crée le compte administrateur ;

• verrouille l’assistant d’installation ;

• prépare le site pour sa première utilisation.

Vous pouvez ensuite accéder directement au tableau de bord.

Après l’installation

Une fois connecté, vous pouvez commencer par personnaliser l’identité du site.

Dans les réglages, vous pourrez notamment définir :

• la phrase d’accroche ;

• la description courte ;

• la description complète ;

• le logo ;

• le texte alternatif du logo ;

• l’icône du site.

Vous pouvez ensuite créer vos premières pages, publier vos premiers articles et choisir les fonctionnalités dont votre projet a réellement besoin.

URLs simplifiées

Apsionyx peut utiliser des adresses lisibles comme :

/account/login

ou :

/a-propos

Sur Apache, cette fonctionnalité utilise le fichier .htaccess fourni dans le dossier public ainsi que le module de réécriture d’URL.

Veillez donc à conserver les fichiers cachés lors du transfert ou de l’extraction de l’archive.

Si ce fichier manque, certaines adresses peuvent retourner une erreur 404 alors que le CMS fonctionne correctement.

HTTPS

Un site public devrait utiliser HTTPS.

Sur un hébergement mutualisé, votre fournisseur propose généralement l’activation automatique d’un certificat.

Sur un VPS ou un serveur dédié, vous pouvez utiliser une solution comme Let’s Encrypt.

Une fois HTTPS activé, utilisez systématiquement l’adresse sécurisée de votre site.

En cas de problème

Apsionyx conserve les détails techniques nécessaires au diagnostic dans ses journaux internes sans les afficher directement aux visiteurs.

En cas d’erreur, une référence peut être affichée afin de retrouver l’événement correspondant dans les journaux.

Cette séparation permet d’obtenir des informations utiles pour l’administrateur sans exposer publiquement les chemins du serveur, les requêtes SQL ou les traces techniques.

Sauvegardez votre installation

Après avoir terminé la configuration initiale, il est recommandé de réaliser une première sauvegarde.
Une sauvegarde complète doit idéalement inclure :

• la base de données ;

• le dossier config ;

• le dossier var ;

• vos thèmes personnalisés ;

• vos extensions personnalisées.

Les sauvegardes réalisées au niveau de l’hébergement restent également recommandées.

Et maintenant ?

Votre installation Apsionyx est prête.

Vous pouvez désormais :

• personnaliser l’identité du site ;

• créer vos pages ;

• rédiger vos premiers articles ;

• gérer les membres ;

• choisir un thème ;

• activer des extensions ;

• importer de nouvelles langues ;

• adapter progressivement le site à votre projet.

---

Quelques étapes suffisent pour installer Apsionyx. Le reste peut évoluer tranquillement avec votre site.