Configurer le fichier .ovhconfig de son hébergement web
Découvrez le fichier .ovhconfig et apprenez à le modifier
Dernière mise à jour le 05/05/2020
Objectif
Diverses raisons peuvent vous amener à vouloir modifier la configuration de votre hébergement web. Pour cela, OVHcloud a mis en place un fichier permettant de changer certains paramètres : le .ovhconfig.
Découvrez le fichier .ovhconfig et apprenez à le configurer.
Prérequis
- Disposer d’une offre d’hébergement web OVHcloud (sauf Cloud Web).
- Disposer du mot de passe de l’utilisateur FTP vous permettant d’accéder à votre espace de stockage.
En pratique
Lorsque vous modifiez le fichier .ovhconfig de votre hébergement web, vous changez la configuration de ce dernier et, par dépendance, celle utilisée par votre site internet. Effectuer une modification inopportune pourrait alors rendre l'accès à votre site impossible. Veillez donc à ce que la configuration renseignée dans le fichier .ovhconfig soit techniquement compatible avec votre site internet.
La modification du fichier .ovhconfig peut se réaliser de deux manières :
-
en modifiant manuellement le fichier .ovhconfig : cette solution est technique et nécessite d'être connecté à votre espace de stockage. Dans cette documentation, nous aborderons exclusivement cette méthode ;
-
via un assistant de configuration depuis votre espace client OVHcloud : cette solution est moins technique et nécessite d'être connecté à votre espace client, où vous pourrez choisir les changements à réaliser. Reportez-vous aux instructions décrites dans notre documentation « Modifier la configuration de son hébergement web ».
Poursuivez la lecture de cette documentation si vous souhaitez modifier manuellement le fichier .ovhconfig.
Modifier le fichier .ovhconfig
Étape 1 : se connecter à l'espace de stockage
Munissez-vous de votre identifiant FTP principal, de son mot de passe, ainsi que de l'adresse du serveur FTP. Une fois tous ces éléments en votre possession, connectez-vous à votre espace de stockage. Aidez-vous de la documentation intitulée « Se connecter à l’espace de stockage » si cela est nécessaire.
Si vous n'êtes plus en possession de ces informations, connectez-vous à votre espace client OVHcloud, puis cliquez sur Hébergements-. Choisissez le nom de l'hébergement concerné et positionnez-vous enfin sur l'onglet FTP - SSH. Vous y retrouverez les informations vous permettant de vous connecter. Concernant le mot de passe de l'utilisateur FTP, reportez-vous aux instructions décrites dans notre documentation « Modifier le mot de passe d’un utilisateur FTP » si cela est nécessaire.
Étape 2 : récupérer ou créer le fichier .ovhconfig
Une fois connecté à votre espace de stockage, vous pouvez visualiser l'ensemble des fichiers actuellement hébergés sur ce dernier. Restez positionné sur la racine de votre hébergement (que l'on peut symboliser par un « / »). Vous devrez y trouver le fichier .ovhconfig.
Dès lors, deux possibilités :
- le fichier .ovhconfig est présent : récupérez-le sur votre propre machine. Nous vous recommandons d'en faire une copie avant de le modifier. Cette dernière vous permettra de remettre le fichier d'origine en cas de nécessité.
- le fichier .ovhconfig n'est pas présent : le fichier n'existant pas, créez ce dernier sur votre propre machine et nommez-le « .ovhconfig ».
Étape 3 : modifier le fichier .ovhconfig
Une fois en possession du fichier .ovhconfig, vous pouvez l'éditer. Pour cela, utilisez un logiciel comme un éditeur de texte. Votre fichier .ovhconfig doit contenir un code ressemblant à :
app.engine=php
app.engine.version=8.0
http.firewall=none
environment=production
container.image=stable64
Personnalisez les valeurs des variables selon la configuration que vous souhaitez utiliser avec votre hébergement web.
| Variables | Détail |
|---|---|
| app.engine | Permet de modifier le moteur PHP utilisé par l'hébergement. Renseignez « php » pour activer l'accélérateur PHP-FPM et « phpcgi » pour le désactiver. |
| app.engine.version | Permet de définir la version de PHP utilisée par l'hébergement parmi celles qu'OVHcloud propose. Renseignez la version de votre choix. |
| http.firewall | Permet d'activer ou de désactiver le firewall fourni avec les hébergements web OVHcloud. Renseignez « security » pour l'activer ou « none » pour le désactiver. |
| environment | Permet de gérer le comportement du cache des fichiers statiques de votre site internet ainsi que le traitement des erreurs PHP. Renseignez « production » pour maximiser la mise en cache et masquer les erreurs PHP ou « development » pour qu'aucun cache ne soit appliqué et que les erreurs PHP s'affichent. |
| container.image | Permet de modifier l'environnement d'exécution utilisé par l'hébergement. Renseignez le moteur de votre choix. Vous pouvez les retrouver depuis notre documentation : « Découvrir les configurations disponibles ». |
Lorsque vous choisissez l'environement d'éxecution « stable64», vérifiez que votre site est compatible avec l'environement 64 bits.
Vous trouverez ci-dessous le détail d'application complet du fichier .ovhconfig :
; ovhconfig
;
; this file must be placed in $HOME/.ovhconfig or in $DOCUMENT_ROOT/.ovhconfig
; __app.engine__
;
; values: php (php engine + opcache accelerator)
; notice: if php, a phpcgi engine will be activated as fallback (if previous engine crash)
;
; php:
; IMPORTANT: register_globals and magic_quotes_gpc are off for security
; php optiones .htaccess (like php version) are ignored
; phpcgi:
; IMPORTANT this is a fallback to previous system
; in this case __app.engine.version__ will be considerated as AUTO and php version will be old system
; (meaning depending .htaccess or .phpX extension)
;
app.engine=php
; __app.engine.version__ specify version of your engine
;
; for php:
; default: 8.0
; for phpcgi:
; this options is ignored (= fallback in AUTO)
;
app.engine.version=8.0
; __http.firewall__ used to add application firewall (filter http requests)
;
; values: none | security
; default: none
;
http.firewall=none
; __environment__
;
; values: production | development
;
; production:
; apache will maximise local cache
; mod_expires will grow up TTL of js, css, pdf, images, video, audio
; you can override it changing expiration explicitly in your .htaccess
; feel free to look on our guide.
; development:
; no expiration is added, files are not locally in cache,
; will speed up tests but decrease performances
;
; choosen environment will also be available in your variable ENVIRONMENT unix env
;
; default: production
;
environment=production
; __container.image__
;
; values: legacy | stable | stable64
;
container.image=stable64
Étape 4 : télécharger le fichier .ovhconfig sur l'espace de stockage
Une fois le fichier .ovhconfig modifié, il ne vous reste plus qu'à le télécharger sur votre espace de stockage. Pour cela, toujours connecté et positionné à la racine votre espace de stockage (que l'on peut symboliser par un « / »), téléchargez le fichier .ovhconfig que vous venez de modifier. Si un fichier existe déjà, remplacez-le.
Utiliser de manière avancée les fichiers ovhconfig
Si vous utilisez votre hébergement web pour y héberger plusieurs sites internet, vous avez sûrement configuré des Multisites. Diverses raisons peuvent vous amener à vouloir bénéficier d'une version de PHP différente pour certains de vos Multisites.
Pour cela, vous devez créer un fichier .ovhconfig pour le ou les Multisites concernés contenant la version de PHP souhaitée. Aidez-vous des manipulations décrites dans la section « Modifier le fichier .ovhconfig » de cette documentation si nécessaire. Lorsque vous devrez télécharger le fichier .ovhconfig sur votre espace de stockage, prenez soin de le faire dans le dossier racine du Multisite. Vous pouvez retrouver le dossier racine de vos Multisites depuis votre espace client dans l'onglet Multisite de l'hébergement concerné.
Il n'est pas possible de spécifier un second environnement d'exécution. Seul celui renseigné dans le fichier .ovhconfig se trouvant à la racine de votre espace de stockage est pris en compte.
Aller plus loin
Échangez avec notre communauté d'utilisateurs sur https://community.ovh.com.
Did you find this guide useful?
Please feel free to give any suggestions in order to improve this documentation.
Whether your feedback is about images, content, or structure, please share it, so that we can improve it together.
Your support requests will not be processed via this form. To do this, please use the "Create a ticket" .
Thank you. Your feedback has been received.