Für ASP.NET Hosting (Windows Webhosting)

Die Skriptsprache PHP ist für den Betrieb vieler PHP-basierter Websites wie WordPress unerlässlich. Die ASP.NET-Hostingpakete von IONOS unterstützen mehrere PHP-Versionen. In diesem Artikel zeigen wir Ihnen, wie Sie die PHP-Version für Ihre Website konfigurieren können.

Verfügbare PHP-Versionen

Auf der Windows-Plattform stehen Ihnen aktuell die folgenden PHP-Versionen zur Verfügung:

  • PHP 8.4: die neueste stabile Version.
  • PHP 8.3: Ab dem 09.07.2025 wird es die Standardversion auf der Windows-Plattform sein (zuvor war es PHP 8.1).
  • PHP 8.1: Wird am 31.12.2025 auslaufen (End of Life) und danach (wahrscheinlich Januar 2026) von der Plattform entfernt. Wir empfehlen einen rechtzeitigen Wechsel auf eine neuere Version.


Standardmäßig ist die ASP.NET-Hostingplattform noch auf PHP 8.1 eingestellt. Ab dem 09.07.2025 wird PHP 8.3 die Standardeinstellung sein. Wir zeigen Ihnen, wie Sie Ihre gewünschte PHP-Version aktiv auswählen können.
 

Zusammenfassung der Vorgehensweise

Die Umstellung Ihres ASP.NET-Webhostings auf die gewünschte PHP-Version erfolgt durch Bearbeitung oder Erstellung der Konfigurationsdatei web.config:

  • Sie laden die Datei web.config von Ihrem Webspace herunter oder erstellen Sie eine neue Datei, falls diese noch nicht existiert.
  • Sie ergänzen oder ersetzen den Abschnitt <handlers> in der Datei wie unten für die jeweilige PHP-Version beschrieben.
  • Sie laden die geänderte oder neue Datei auf Ihren Webspace hoch. Damit wird die ausgewählte PHP-Version sofort aktiviert.

Im Folgenden führen wir Sie durch die notwendigen Schritte.

PHP-Version in bestehender web.config-Datei ändern

Wenn für Ihre Website bereits eine Datei web.config existiert, passen Sie diese wie folgt für die Verwendung der gewünschten PHP-Version an:

  • Laden Sie die Datei web.config aus dem Stammverzeichnis Ihres Webspace auf Ihren Computer herunter.

    Sie können dafür entweder den Dateimanager Webfiles von IONOS oder Ihren FTP-Zugang verwenden. Weitere Informationen dazu finden Sie hier:
    Webfiles im IONOS Konto starten
    Dateien per FTPS mit WinSCP übertragen
     
  • Erstellen Sie eine Sicherungskopie der Datei web.config auf Ihrem Computer.
  • Öffnen Sie die Datei web.config auf Ihrem Computer mit einem einfachen Texteditor wie Notepad.
  • Suchen Sie im Text nach einem Abschnitt, der mit der Zeile <system.webServer> beginnt und mit der Zeile </system.webServer> endet.

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

  • Fügen Sie am Ende des Abschnitts vor der Zeile </system.webServer> den folgenden Code hinzu:

    Für 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>


    Für PHP 8.3  (Standard ab 09.07.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>


    Für PHP 8.1 (EOL ab 31.12.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>

    Bitte beachten Sie, dass der Ausdruck <add name="PHPXX" ... /> (wobei XX für die Version steht) in einer Zeile stehen muss. Dass die Darstellung in unserem Beispiel umgebrochen wurde, ist nur dem Layout geschuldet. Am besten kopieren Sie den kompletten <handlers>-Block von oben und fügen ihn in die Datei web.config ein. Die <remove>-Anweisungen stellen sicher, dass zuvor aktive PHP-Handler entfernt werden.

  • Speichern Sie Änderungen.
  • Laden Sie die bearbeitete Datei web.config wieder auf Ihren Webspace hoch.

Hinweis

Änderungen an der Konfigurationsdatei web.config wirken sich automatisch auf alle Unterverzeichnisse aus. Wenn Sie mehrere PHP-Websites haben und die PHP-Version vorerst nur für eine Website aktivieren möchten, laden Sie die bearbeitete web.config in das Verzeichnis der betreffenden Website hoch.

Die ausgewählte PHP-Version ist nun sofort aktiv. Laden Sie Ihre Website im Browser neu und überprüfen Sie, ob alles wie gewohnt funktioniert.

Um die PHP-Konfiguration bei Bedarf wieder zu ändern oder zu entfernen, passen Sie die entsprechenden Zeilen in Ihrer web.config-Datei erneut an oder entfernen Sie den <handlers>-Abschnitt für PHP.

PHP-Version durch neue web.config-Datei festlegen

Wenn es auf Ihrem Webspace keine web.config-Datei gibt, erstellen Sie einfach eine:.

  • Öffnen Sie auf Ihrem Computer einen einfachen Texteditor wie z.B. Notepad.
  • Kopieren Sie den Code aus der passenden Codevorlage im nächsten Abschnitt (für PHP 8.4, 8.3 oder 8.1) und fügen Sie ihn in den Texteditor ein.
  • Speichern Sie die Datei unter dem Namen web.config.
  • Laden Sie die fertige web.config auf Ihrem Webspace hoch.

Vorlagen: web.config-Datei für spezifische PHP-Versionen

Der folgende Code dient als Beispiel für eine minimalistische web.config-Datei. Er enthält bereits die Anweisungen für die Umstellung auf die jeweilige PHP-Version. Sie können diesen Code als Kopiervorlage für das Erstellen Ihrer web.config-Datei nutzen.

 

Vorlage für 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>


Vorlage für PHP 8.3 (Standard ab 09.07.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>

 

Vorlage für PHP 8.1 (EOL ab 31.12.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>