Pour Hébergement ASP.NET (Hébergement Windows)

Le langage de programmation PHP est indispensable au fonctionnement de nombreux sites Web basés sur PHP, comme WordPress. Les packs d'hébergement ASP.NET de IONOS prennent en charge plusieurs versions de PHP. Dans cet article, nous vous montrons comment configurer la version de PHP pour votre site Web.

Versions de PHP disponibles

Sur la plate-forme Windows, les versions suivantes de PHP sont actuellement disponibles :

  • PHP 8.4 : La dernière version stable.
  • PHP 8.3 : À partir du 09 juillet 2025, ce sera la version standard sur la plateforme Windows (avant, c'était PHP 8.1).
  • PHP 8.1 : Cette version expirera le 31 décembre 2025 (fin de vie) et sera ensuite retirée de la plate-forme (probablement en janvier 2026). Nous recommandons de passer à temps à une version plus récente.


Par défaut, la plateforme d'hébergement ASP.NET est encore réglée sur PHP 8.1. À partir du 09 juillet 2025, PHP 8.3 sera le paramètre par défaut. Dans la suite de cet article, nous vous montrons comment sélectionner activement la version de PHP que vous souhaitez.
 

Résumé de la procédure

Le passage de votre hébergement Web ASP.NET à la version PHP souhaitée se fait en modifiant ou en créant le fichier de configuration web.config :

  • Téléchargez le fichier web.config depuis votre espace web ou créez un nouveau fichier s'il n'existe pas encore.
  • Complétez ou remplacez la section <handlers> dans le fichier comme décrit ci-dessous pour la version PHP concernée.
  • Téléchargez le fichier modifié ou nouveau sur votre espace Web. La version PHP sélectionnée est ainsi immédiatement activée.

Dans ce qui suit, nous vous guidons à travers les étapes nécessaires.

Modifier la version de PHP dans le fichier web.config existant

Si un fichier web.config existe déjà pour votre site Web, adaptez-le comme suit pour l'utilisation de la version PHP souhaitée :

  • Téléchargez le fichier web.config depuis le répertoire racine de votre espace Web sur votre ordinateur.

    Vous pouvez utiliser pour cela soit le gestionnaire de fichiers Webfiles de IONOS, soit votre accès FTP. Vous trouverez plus d'informations à ce sujet ici :
    Démarrer Webfiles dans le compte IONOS
    Transférer des fichiers par FTPS avec WinSCP
     
  • Faites une copie de sauvegarde du fichier web.config sur votre ordinateur.
  • Ouvrez le fichier web.config sur votre ordinateur à l'aide d'un simple éditeur de texte comme le Bloc-notes.
  • Recherchez dans le texte une section commençant par la ligne <system .webServer> et se terminant par la ligne </system .webServer>.

    <system.webServer>
    ...
    ...
    </system.webServer>.

  • Ajoutez le code suivant à la fin du paragraphe avant la ligne </system .webServer> :

    Pour PHP 8.4 :

    <handlers>
       <remove name="PHP83" />
       <remove name="PHP81" />
       <remove name="PHP8" />
    <add name="PHP84" path="*.php" verb="*" modules="FastCgiModule" scriptProcessor="C:\Services\PHP84\php-cgi.exe" resourceType="File" />
    </handlers>


    Pour PHP 8.3 (standard à partir du 09 juillet 2025) :

    <handlers>
       <remove name="PHP84" />
       <remove name="PHP81" />
       <remove name="PHP8" />
    <add name="PHP83" path="*.php" verb="*" modules="FastCgiModule" scriptProcessor="C:\Services\PHP83\php-cgi.exe" resourceType="File" />
    </handlers>


    Pour PHP 8.1 (EOL à partir du 31 décembre 2025) :

    <handlers>
       <remove name="PHP84" />
       <remove name="PHP83" />
       <remove name="PHP8" />
    <add name="PHP81" path="*.php" verb="*" modules="FastCgiModule" scriptProcessor="C:\Services\PHP81\php-cgi.exe" resourceType="File" />
    </handlers>

    Veuillez noter que l'expression <add name="PHPXX" ... /> (où XX représente la version) doit tenir sur une seule ligne. Le fait que la représentation dans notre exemple soit tronquée est uniquement dû à la mise en page. Le mieux est de copier le bloc <handlers> complet depuis le haut et de le coller dans le fichier web.config. Les instructions <remove> garantissent que les gestionnaires PHP précédemment actifs sont supprimés.

  • Enregistrez les modifications.
  • Téléchargez à nouveau le fichier web.config modifié sur votre espace Web.

Remarque

Les modifications apportées au fichier de configuration web.config se répercutent automatiquement sur tous les sous-répertoires. Si vous avez plusieurs sites Web avec PHP et que vous ne souhaitez activer la version PHP que pour un seul site Web dans un premier temps, téléchargez le web.config modifié dans le répertoire du site Web concerné.

La version de PHP sélectionnée est maintenant immédiatement active. Rechargez votre site Web dans le navigateur et vérifiez que tout fonctionne comme d'habitude.

Pour modifier ou supprimer à nouveau la configuration PHP si nécessaire, adaptez à nouveau les lignes correspondantes dans votre fichier web.config ou supprimez la section <handlers> pour PHP.

Définir la version de PHP par un nouveau fichier web.config

S'il n'y a pas de fichier web.config sur votre espace Web, il suffit d'en créer un.

  • Sur votre ordinateur, ouvrez un simple éditeur de texte comme Notepad.
  • Copiez le code du modèle de code approprié dans la section suivante (pour PHP 8.4, 8.3 ou 8.1) et collez-le dans l'éditeur de texte.
  • Enregistrez le fichier sous le nom web.config.
  • Téléchargez le web.config terminé sur votre espace Web.

Modèles : Fichier web.config pour les versions spécifiques de PHP

Le code suivant sert d'exemple pour un fichier web.config minimaliste. Il contient déjà les instructions pour le passage à la version PHP correspondante. Vous pouvez utiliser ce code comme modèle pour créer votre fichier web.config.

 

Modèle pour PHP 8.4
 

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <defaultDocument enabled="true">
      <files>
        <clear />
        <add value="index.aspx" />
        <add value="index.asp" />
        <add value="index.htm" />
        <add value="index.html" />
        <add value="home.aspx" />
        <add value="home.asp" />
        <add value="home.htm" />
        <add value="home.html" />
        <add value="default.aspx" />
        <add value="default.asp" />
        <add value="default.htm" />
        <add value="default.html" />
      </files>
    </defaultDocument>
        <handlers>
            <remove name="PHP83" />
            <remove name="PHP81" />
            <remove name="PHP8" />
            <add name="PHP84" path="*.php" verb="*" modules="FastCgiModule" scriptProcessor="C:\Services\PHP84\php-cgi.exe" resourceType="File" />
        </handlers>
  </system.webServer>
</configuration>


Modèle pour PHP 8.3 (standard à partir du 09 juillet 2025)

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <defaultDocument enabled="true">
      <files>
        <clear />
        <add value="index.aspx" />
        <add value="index.asp" />
        <add value="index.htm" />
        <add value="index.html" />
        <add value="home.aspx" />
        <add value="home.asp" />
        <add value="home.htm" />
        <add value="home.html" />
        <add value="default.aspx" />
        <add value="default.asp" />
        <add value="default.htm" />
        <add value="default.html" />
      </files>
    </defaultDocument>
        <handlers>
            <remove name="PHP84" />
            <remove name="PHP81" />
            <remove name="PHP8" />
            <add name="PHP83" path="*.php" verb="*" modules="FastCgiModule" scriptProcessor="C:\Services\PHP83\php-cgi.exe" resourceType="File" />
        </handlers>
  </system.webServer>
</configuration>

 

Modèle pour PHP 8.1 (EOL à partir du 31 décembre 2025)

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <defaultDocument enabled="true">
      <files>
        <clear />
        <add value="index.aspx" />
        <add value="index.asp" />
        <add value="index.htm" />
        <add value="index.html" />
        <add value="home.aspx" />
        <add value="home.asp" />
        <add value="home.htm" />
        <add value="home.html" />
        <add value="default.aspx" />
        <add value="default.asp" />
        <add value="default.htm" />
        <add value="default.html" />
      </files>
    </defaultDocument>
        <handlers>
            <remove name="PHP84" />
            <remove name="PHP83" />
            <remove name="PHP8" />
            <add name="PHP81" path="*.php" verb="*" modules="FastCgiModule" scriptProcessor="C:\Services\PHP81\php-cgi.exe" resourceType="File" />
        </handlers>
  </system.webServer>
</configuration>