Ce guide explique à quoi sert l'option "Préfixe MySQL" dans les paramètres d'un site et quelles sont ses implications pour le fonctionnement de vos applications Web (CMS) et scripts PHP.

Préambule

• Lorsque l'option "Préfixe MySQL" est activée pour un site, il n'est plus nécessaire d'ajouter le préfixe "wxyz_" devant le nom et les utilisateurs de vos bases de données MySQL.
• Un script PHP pourra ainsi se connecter à MySQL avec l'utilisateur "monuser" et une base de données "mabase" et l'accès se fera automatiquement avec l'utilisateur "wxyz_monuser" et la base de données "wxyz_mabase".
• ⚠ S‍i vous effectuez une migration depuis une ancienne offre Infomaniak:
  • Après avoir migré un site de l'ancienne console, l'option "Préfixe MySQL" est activée par défaut afin de maintenir automatiquement la connexion de vos applications Web (WordPress, Joomla, Drupal, etc.) et scripts PHP avec vos bases de données MySQL.
  • Afin d'assurer le bon fonctionnement de vos sites en cas de migration de votre hébergement sur un autre serveur, il est fortement recommandé de désactiver cette fonction et d'effectuer les ajustements que cela implique.‍

Gérer l'option Préfixe MySQL

Aller plus loin avec les variables d'environnement

Il est possible de configurer des variables d'environnement directement depuis le Manager pour l'ensemble de votre site Web:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné:
3. Cliquez sur Gérer sous Paramètres avancés:
   
4. Cliquez sur l'onglet PHP / Apache.
5. Activer ou désactiver le bouton à bascule (toggle switch) Préfixe MySQL.
6. Cliquez sur le bouton Enregistrer:
   
7. Effectuez les ajustements nécessaires dans les fichiers de configuration de vos applications Web et scripts PHP…

Implications et ajustements à effectuer

Après avoir désactivé l'option Préfixe MySQL pour un site, certains scripts PHP ou CMS risquent de ne plus fonctionner. Afin de rétablir la connexion à vos bases de données, vous devrez impérativement mettre à jour les informations suivantes dans le(s) fichier(s) de configuration des scripts concernés:

• le nom de la base de données MySQL: il faudra y ajouter le préfixe de votre serveur
  • avant: mabase
  • après: wxyz_mabase
• l'utilisateur de la base de données MySQL: il faudra y ajouter le préfixe de votre serveur
  • avant: monuser
  • après: wxyz_monuser

Ce guide concerne Laravel, un framework Web open-source écrit en PHP respectant le principe modèle-vue-contrôleur (MVC). Prenez également connaissance de leur documentation.

Prérequis

• Posséder un Hébergement Web mutualisé ou Serveur Cloud avec MySQL/MariaDB le plus récent.
• Site sous PHP 8.2.
• Créer un accès SSH.
• Créer une base de données.

Installation de Laravel 11

Pour cela:

1. Connectez-vous sur le serveur en SSH (besoin d'aide ?).
2. Placez-vous dans le répertoire du site en exécutant la commande “cd chemin-vers-le-site” (par exemple cd sites/laravel.domain.xyz).
3. Créez un nouveau projet en exécutant la commande composer create-project laravel/laravel example-app.
4. Modifiez le fichier .env à la racine de l’hébergement pour mettre à jour les paramètres de connexion à la nouvelle base de données:
   • DB_CONNECTION=mysql
   • DB_HOST=xxxx.myd.infomaniak.com
   • DB_PORT=3306
   • DB_DATABASE= le nom de la base de données MySQL (xxxx_newbdd)
   • DB_USERNAME= l’utilisateur MySQL avec les droits sur cette base
   • DB_PASSWORD= son mot de passe
5. Placez-vous dans le répertoire du projet et publier via SSH:
   cd example-app
php artisan migrate
6. Modifiez le répertoire cible pour le faire pointer dans le sous-répertoire «public» du projet, ici /sites/laravel.domain.xyz/example-app/public.

Ce guide concerne MySQL/MariaDB et plus particulièrement les analyses d'index et requêtes avec les Hébergement Web.

Slowlog pour les requêtes longues

Le slowlog MySQL est activé sur tous les serveurs MySQL et regroupe les requêtes qui prennent plus de 5 secondes* à s'exécuter. Si vos requêtes sont bien construites, vous ne verrez jamais ces fichiers. Sinon, consultez régulièrement afin de corriger les éventuels défauts et garantir ainsi le bon fonctionnement de votre site.

Contactez le support Infomaniak par écrit afin de les obtenir (sauf pour les anciens hébergements v1 directement consultables depuis le gestionnaire de fichiers FTP Manager un niveau au-dessus de /web dans le répertoire /logs).

Et les logs ?

Aucun log MySQL n'est créé (à part les slowlogs) car les serveurs MySQL ne supporteraient absolument pas la charge des millions de logs simultanés à enregistrer. En cas de besoin, Infomaniak peut activer ce log MySQL pendant 5 minutes afin de vous permettre de les analyser avec EXPLAIN et de déterminer les index utiles par exemple. Pour cela, contactez le support Infomaniak par écrit.

* de temps écoulé. Et concernant les verrous, la documentation apporte la précision suivante: "The time to acquire the initial locks is not counted as execution time"

Ce guide explique comment ajouter un domaine synonyme à un nom de domaine.

Préambule

• Un domaine synonyme est un nom de domaine pouvant servir de nom secondaire à un autre domaine.
• Lorsqu’un domaine synonyme est ajouté, il hérite automatiquement du contenu de la zone DNS du domaine principal (y compris les enregistrements MX, A, etc.), ainsi que de son hébergement Web et Mail.
• En lieu et place, vous pouvez également ajouter un (domaine) alias à un site Web ou ajouter un (domaine) alias à un Service Mail.

Ajouter un domaine synonyme à un domaine

Prérequis

• Le nom de domaine du futur synonyme ou la gestion de sa zone DNS…
  • … doit être réservé auprès d'Infomaniak,
  • … doit être configuré avec les DNS Infomaniak,
  • … ne doit être encore lié à aucun produit.
• Le nom de domaine sur lequel sera placé le synonyme…
  • … ne doit pas être associé au produit Newsletter Infomaniak.

Afin d'accéder à vos noms de domaine :

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur Domaines synonymes dans le menu latéral gauche.
4. Choisissez d'ajouter un synonyme.
5. Cliquez sur Suivant:
   
6. Choisissez un domaine existant sur la présente Organisation, ou commander un nouveau domaine au préalable, et cliquez sur le bouton pour Confirmer:
   

Prenez connaissance de cet autre guide si vous recherchez des informations pour dissocier un nom de domaine synonyme.

Ce guide explique comment modifier le mot de passe d'un compte FTP ou FTP / SSH pour le site d'un Hébergement Web Infomaniak. 

Changer le mot de passe d'un utilisateur FTP existant

Afin d'accéder au site sur un Hébergement Web pour y modifier ses accès FTP:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur FTP / SSH dans le menu latéral gauche.
4. Cliquez sur le menu d'action ⋮ à droite de l'utilisateur concerné dans le tableau qui s'affiche.
5. Cliquez sur Modifier:
   
6. Entrez directement le nouveau mot de passe qui sera utilisé lors de vos accès par FTP ou accès SSH.
7. Si nécessaire vous pouvez générer un mot de passe fort.
8. Confirmez les changements:
   

Ce guide permet de résoudre une éventuelle erreur 530 en réduisant le nombre de connexions FTP simultanées aux Hébergements Web.

Résoudre une erreur 530

Le message d'erreur 530 Sorry, the maximum number of clients (25) for this user are already connected apparait en général à la suite de connexions multiples et simultanées avec un logiciel/client FTP qui gère mal les déconnexions ou qui essaye d'ouvrir plusieurs connexions en même temps en pensant accélérer le téléchargement.

Une fois que vous avez obtenu cette erreur, il faut fermer le programme FTP puis attendre 30 minutes afin que le serveur coupe les connexions actives et que vous puissiez vous reconnecter.

Vous pouvez également créer un nouvel utilisateur FTP et vous connecter avec.

Pour éviter cette situation avec FileZilla, se rendre dans le menu Édition -> Configuration puis sous l'onglet Transferts et régler le nombre de transferts simultanés à 2.

Il est recommandé d'utiliser le gestionnaire de fichiers FTP Manager.

Ce guide explique comment supprimer un domaine alias d'un hébergement Web Infomaniak. Le nom de domaine principal du site ne sera alors plus lié à un quelconque autre nom de domaine.

Cela permet notamment de pouvoir créer par la suite un nouvel hébergement Web ou site distinct pour le nom de domaine ainsi délié.

Prérequis

• Avoir dissocié le nom de domaine synonyme du nom de domaine principal s'il y avait association auparavant.

Retirer le domaine alias

Afin de retirer un nom de domaine alias de votre site:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné:
   
3. Cliquez ensuite sur le chevron ‍ pour développer la partie Domaines de ce site.
4. Cliquez sur le menu d'action ⋮ à droite du domaine à retirer.
5. Choisissez Délier:
   
6. Confirmez la suppression de l'alias.

Ce guide explique comment protéger une partie d'un site sur un Hébergement Web en rendant obligatoire la saisie d'un mot de passe avant de consulter un répertoire (sous-répertoires inclus) depuis un navigateur.

Méthode simple

Protéger par mot de passe (authentification Digest) un répertoire en utilisant l'outil "Protection de dossiers":

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur Sécurité dans le menu latéral gauche.
4. Cliquez sur Protection de dossiers dans le menu latéral gauche.
5. Cliquez sur le répertoire à protéger.
6. Activez la protection par le bouton à bascule (toggle switch) puis créez un ou plusieurs utilisateurs*:
   
   • * Les utilisateurs sont définis par répertoire ; l'outil ne permet pas de gérer des groupes d'utilisateurs:
     
7. Cliquez sur le bouton Ajouter.
8. Cliquez sur le bouton pour Ajouter un accès d'un utilisateur supplémentaire si nécessaire.
9. Cliquez sur le menu d'action ⋮ situé à droite de l'utilisateur concerné pour le modifier ou le retirer.
10. Cliquez à nouveau sur le bouton à bascule (toggle switch) afin de désactiver complètement la protection du répertoire:
    

Méthode manuelle via .htaccess

Afin de protéger un dossier par un mot de passe en utilisant le fichier .htaccess de votre site:

1. Connectez-vous à votre hébergement via un logiciel/client FTP ou le FTP Manager.

2. Dans le dossier à protéger, créez un fichier appelé password.php et adaptez le contenu suivant à l'intérieur en remplaçant 12345 par le mot de passe désiré:

   <?php
   $pass = "12345";
   echo password_hash($pass, PASSWORD_DEFAULT);  // Affiche le mot de passe chiffré
   ?>

3. Ouvrez un navigateur Web et affichez le fichier password.php (exemple: domain.xyz/dossier-à-protéger/password.php).
4. Le navigateur Web affiche votre mot de passe chiffré ; copiez le mot de passe chiffré, il y en aura besoin par la suite…

Dans le dossier à protéger, créez un fichier appelé .htaccess et adaptez le contenu suivant à l'intérieur:

AuthName "Page d'administration protégée"
AuthType Basic
AuthUserFile "/exemple/.htpasswd"
Require valid-user

Remplacez /exemple/ par le chemin absolu du dossier à protéger. Exemple:

AuthUserFile "/home/clients/0f83c7afb710e5ae2645a1b704d8772f/web/dossier_a_proteger/.htpasswd"

Dans le dossier à protéger, créez un fichier appelé htpasswd.txt et adaptez le contenu suivant à l'intérieur:

login:password_chiffré

• Remplacez login par le login souhaité.
• Remplacez password_chiffré par le mot de passe chiffré copié à l'étape 1 de ce guide.

Une fois le fichier htpasswd.txt sauvegardé, renommez-le comme suit: .htpasswd.

Ouvrez un navigateur Web et essayez d'afficher l'une des pages contenues dans le dossier protégé. Si le guide a bien été suivi, le login et le mot de passe (non chiffré) choisis permettent d'accéder au dossier protégé.

D'autres restrictions peuvent également être apportées par .htaccess.

Ce guide détaille comment, lors de l'activation d'un nouveau thème WordPress, la mise en forme et le contenu des articles et pages peuvent être altérés, ceci si le nouveau thème n'utilise pas les mêmes shortcodes et/ou le même page builder (constructeur de pages).

Problèmes de mise en page

Voici par exemple comment peuvent apparaître vos articles et pages après avoir changé de thème WordPress:

Il n'existe malheureusement pas de solution automatique pour corriger ce problème: vous devrez:

• soit revenir à l'ancien thème que vous utilisiez
• soit manuellement adapter le contenu de votre site avec les outils prévus par votre nouveau thème WordPress.

Évidemment, vous pouvez également désinstaller et réinstaller WordPress, le contenu du site sera effacé et vous repartirez sur de bonnes bases.

Réduire les problèmes à l'avenir

Voici quelques conseils qui vous éviteront de devoir remettre en forme tout le contenu de votre site en cas de changement de thème:

• Utilisez le moins possible les shortcodes propres à votre thème WordPress.
• Utilisez un page builder universel qui est compatible avec tous les thèmes WordPress (par exemple Visual Composer ou Thrive Content Builder).
• Prenez le temps de tester et évaluer la qualité d'un thème, en comparant avec 2-3 autres thèmes similaires, avant de l'utiliser et d'adapter tout le contenu de votre site.

Ressources utiles

• Trouver et supprimer automatiquement tous les shortcodes inutilisés (article en anglais)…

Ce guide explique comment visualiser un site Web hébergé par Infomaniak même si aucun nom de domaine / URL n'est actuellement configuré correctement pour diriger le visiteur vers ce site.

Préambule

• Grâce à l'URL de prévisualisation de votre site Web, obtenez dans un navigateur la version actuelle de votre contenu peu importe si le futur nom de domaine correspondant n'est pas encore configuré correctement.
• Cet aperçu du site peut se faire grâce à une URL de prévisualisation et permet notamment de tester un site avant de faire pointer un nom de domaine qui p.ex pointerait actuellement ailleurs.
• Cette URL temporaire fournie par Infomaniak est susceptible de changer en tout temps et n'est disponible qu'avec les offres payantes.

Obtenir l'URL de prévisualisation de votre site

Pour cela:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur ‍ Plus d'informations.
4. L'adresse de prévisualisation est indiquée sous URL de prévisualisation (ex.: XXX.preview.infomaniak.website):
   
    

En cas de problème…

Si en visitant votre adresse de prévisualisation, l'URL change immédiatement pour une autre, il peut s'agir d'un fichier .htaccess que vous avez modifié pour y inclure des règles de réécriture. Il faut le désactiver puis tester à nouveau.

… sur WordPress

Si l'URL de prévisualisation s'affiche tout le temps alors que vous avez pourtant fait le nécessaire au niveau du nom de domaine, il faut lui attribuer l'adresse définitive en tant qu'adresse principale dans les options de votre site Web.

Alternatives pour prévisualiser votre site

Si vous souhaitez procéder différemment qu'avec l'adresse de prévisualisation fournie par Infomaniak (voir ci-dessus), vous pouvez modifier le fichier hosts de votre ordinateur (y compris avec des extensions de navigateur comme celle-ci pour Firefox). Vous aurez besoin pour cela de l'adresse IP de votre site.

Lorsque vos test sont terminés ou que les DNS du nom de domaine sont à jour, n'oubliez pas d'effacer vos éventuelles modifications sinon il sera impossible d'afficher votre site si l'adresse IP du serveur est modifiée ou que le site est migré sur un autre hébergement Web.