FastCGI <fastCgi>

Artikel
04/12/2024

Übersicht

Das <fastCgi>-Element enthält eine Sammlung von <application>-Elementen, die jeweils eine FastCGI-Anwendungspooldefinition erstellen. Internetinformationsdienste 7 (Internet Information Services, IIS) enthält die FastCGI-Komponente. Diese Komponente bietet eine höhere Zuverlässigkeit sowie eine bessere Leistung und ermöglicht die Ausführung des PHP-Anwendungsframeworks und anderer Webanwendungsframeworks in IIS 7.

Bei der einfachsten FastCGI-Anwendungspooldefinition müssen Sie das fullPath-Attribut in ein <application>-Element einschließen, um die Binärdateien zu definieren, die für das spezifische Anwendungsframework verwendet werden sollen. Legen Sie für das PHP-Framework das fullPath-Attribut auf das Verzeichnis und den Dateinamen der PHP-Binärdateien fest.

Andere Attribute sind optional und ermöglichen es Ihnen, eine Reihe weiterer Parameter zu konfigurieren. Dazu gehören die maximale Anzahl von Anforderungen, die ein FastCGI-Arbeitsprozess verarbeiten kann, bevor er neu gestartet wird, sowie die maximale Anzahl von Arbeitsprozessen für einen Anwendungspool und die maximale Dauer einer FastCGI-Anforderung.

Hinweis

Um Anforderungen mithilfe von FastCGI zu verarbeiten, müssen Sie zuerst dem FastCGI-Modul den Pfad und die spezifischen Dateinamenerweiterungen zuordnen und den FastCGI-Zielprozess als Skriptprozessor angeben.

Neu in IIS 7.5

In IIS 7.5 wurden dem <fastCgi>/<application>-Element folgende Attribute hinzugefügt:

Mit dem monitorChangesTo-Attribut können Sie eine Datei angeben, die auf Änderungen überwacht werden soll, die sich ggf. auf das Verhalten einer FastCGI-Anwendung auswirken. Wenn Sie beispielsweise das PHP-Framework verwenden, können Sie IIS so konfigurieren, dass die Datei „PHP.INI“ auf Änderungen überwacht wird, indem Sie den vollständigen Pfad der Datei im monitorChangesTo-Attribut angeben.
Das stderrMode-Attribut gibt an, wie IIS 7 Fehler behandelt, die von einer FastCGI-Anwendung über den STDERR-Stream zurückgegeben werden.
Mit dem signalBeforeTerminateSeconds-Attribut können Sie IIS so konfigurieren, dass eine gewisse Zeit gewartet wird, nachdem IIS einer FastCGI-Anwendung signalisiert hat, dass sie heruntergefahren werden muss. Dadurch hat eine FastCGI-Anwendung Gelegenheit, alle Einstellungen zu bereinigen, bevor IIS den Prozess beendet.

Kompatibilität

Version	Hinweise
IIS 10.0	Das `<fastCgi>`-Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das `<fastCgi>`-Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Das `<fastCgi>`-Element wurde in IIS 8.0 nicht geändert.
IIS 7.5	Das `<application>`-Element der `<fastCgi>`-Sammlung wurde in IIS 7.5 mit den Attributen monitorChangesTo, stderrMode und signalBeforeTerminateSeconds aktualisiert.
IIS 7.0	Das `<fastCgi>` Element wurde in IIS 7.0 eingeführt.
IIS 6.0	N/V

Setup

Um die FastCGI-Umgebung verwenden zu können, müssen Sie zuerst den CGI-Rollendienst installieren. Der Installationsprozess registriert den CGI-Rollendienst (Common Gateway Interface, gemeinsame Gatewayschnittstelle) sowohl im <globalModules>-Element als auch im <modules>-Element. Sie müssen keine weiteren Schritte ausführen, um die FastCGI-Umgebung zu installieren.

Windows Server 2012 oder Windows Server 2012 R2

Klicken Sie auf der Taskleiste auf Server-Manager.
Klicken Sie im Server-Manager auf Verwalten und dann auf Rollen und Features hinzufügen.
Klicken Sie im Assistenten zum Hinzufügen von Rollen und Features auf Weiter. Wählen Sie den Installationstyp aus, und klicken Sie auf Weiter. Wählen Sie den Zielserver aus, und klicken Sie auf Weiter.
Erweitern Sie auf der Seite Serverrollen die Option Webserver (IIS), erweitern Sie Webserver, erweitern Sie Anwendungsentwicklung, und wählen Sie dann CGI aus. Klicken Sie auf Weiter.
Klicken Sie auf der Seite Features auswählen auf Weiter.
Klicken Sie auf der Seite Installationsauswahl bestätigen auf Installieren.
Klicken Sie auf der Seite Ergebnisse auf Schließen.

Windows 8 oder Windows 8.1

Bewegen Sie auf dem Startbildschirm den Mauszeiger ganz nach links unten, klicken Sie mit der rechten Maustaste auf die Starttaste und klicken Sie dann auf Systemsteuerung.
Klicken Sie in der Systemsteuerung auf Programme und Features und dann auf Windows-Features aktivieren oder deaktivieren.
Erweitern Sie Internetinformationsdienste > WWW-Dienste > Anwendungsentwicklungsfeatures, und wählen Sie anschließend CGI aus.
Klicken Sie auf OK.
Klicken Sie auf Schließen.

Windows Server 2008 oder Windows Server 2008 R2

Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungstools, und klicken Sie dann auf Server-Manager.
Erweitern Sie im Hierarchiebereich des Server-Managers die Rollenund klicken Sie dann auf den Webserver (IIS) .
Scrollen Sie im Bereich Webserver (IIS) zum Abschnitt Rollendienste, und klicken Sie dann auf Rollendienste hinzufügen.
Wählen Sie auf der Seite Rollendienste auswählen des Assistenten zum Hinzufügen von Rollendiensten die Option CGI aus, und klicken Sie dann auf Weiter.
Klicken Sie auf der Seite Installationsauswahl bestätigen auf Installieren.
Klicken Sie auf der Seite Ergebnisse auf Schließen.

Windows Vista oder Windows 7

Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
Klicken Sie in der Systemsteuerung auf Programme und Features und dann auf Windows-Features aktivieren oder deaktivieren.
Erweitern Sie Internetinformationsdienste, wählen Sie CGI aus, und klicken Sie anschließend auf OK.

Gewusst wie

Hinweis für IIS 7.0-Benutzer: Einige der Schritte in diesem Abschnitt erfordern möglicherweise die Installation des Microsoft Administration Pack für IIS 7, das eine Benutzeroberfläche für FastCGI-Einstellungen enthält. Informationen zum Installieren des Microsoft Administration Pack für IIS 7 finden Sie unter der folgenden URL:

https://www.iis.net/downloads/microsoft/administration-pack

Erstellen einer globalen FastCGI-Handlerzuordnung für PHP

Hinweis

Damit das folgende Verfahren funktioniert, müssen Sie bereits Binärdateien installiert haben, die den von Ihnen angegebenen Dateipfad oder die von Ihnen angegebene Dateinamenerweiterung ausführen. In diesem Beispiel wird eine PHP-Implementierung verwendet, die unter https://www.php.net/ verfügbar ist.

Öffnen Sie Internetinformationsdienste-Manager (IIS-Manager):
- Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Server-Managerdann auf Toolsund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows 8 oder Windows 8.1 verwenden:
  - Halten Sie die Windows-Taste gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf "Systemsteuerung".
  - Klicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Server 2008 oder Windows Server 2008 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Vista oder Windows 7 verwenden:
  - Klicken Sie auf der Taskleiste auf "Start" und dann auf "Systemsteuerung".
  - Doppelklicken Sie auf Verwaltung, und doppelklicken Sie dann auf Internetinformationsdienste-Manager (IIS-Manager).
Klicken Sie im Bereich Verbindungen auf den Servernamen, für den Sie FastCGI-Handlerzuordnungen konfigurieren möchten.
Doppelklicken Sie im Bereich Start auf Handlerzuordnungen.
Klicken Sie im Bereich Aktionen auf Modulzuordnung hinzufügen.
Geben Sie die folgenden Informationen ein:
- Geben Sie die Dateinamenerweiterung in das Textfeld Anforderungspfad ein. Beispiel: „*.php“.
- Klicken Sie in der Dropdownliste Modul auf FastCgiModule.
- Geben Sie den Pfad zur Skript-Engine in das Feld Ausführbare Datei ein. Beispiel: „C:\PHP\php-cgi.exe“.
- Geben Sie einen eindeutigen Namen für die Handlerzuordnung in das Feld Name ein. Beispiel: „PHP-FastCGI“.
- Klicken Sie auf Anforderungseinschränkungen.
- Aktivieren Sie das Kontrollkästchen Handler nur aufrufen, wenn die Anforderung Folgendem zugeordnet ist.
- Klicken Sie auf die Option Datei oder Ordner, um sie auszuwählen.
- Klicken Sie auf OK.
Klicken Sie auf OK.
Wenn Sie im Dialogfeld Modulzuordnung hinzufügen zum Erstellen einer FastCGI-Anwendung aufgefordert werden, klicken Sie auf Ja.

Hinweis

Dadurch wird automatisch eine FastCGI-Anwendung für die soeben erstellte Handlerzuordnung erstellt. Wenn Sie Nein auswählen, können Sie später manuell eine FastCGI-Anwendung erstellen.

Erstellen einer FastCGI-Anwendung für PHP

Hinweis

Durch Hinzufügen einer FastCGI-Anwendung wird nicht automatisch eine Handlerzuordnung hinzugefügt. Hierzu müssen die Schritte ausgeführt werden, die in diesem Artikel im Abschnitt Erstellen einer FastCGI-Handlerzuordnung für PHP] beschrieben sind.

Öffnen Sie Internetinformationsdienste-Manager (IIS-Manager):
- Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Server-Managerdann auf Toolsund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows 8 oder Windows 8.1 verwenden:
  - Halten Sie die Windows-Taste gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf "Systemsteuerung".
  - Klicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Server 2008 oder Windows Server 2008 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Vista oder Windows 7 verwenden:
  - Klicken Sie auf der Taskleiste auf "Start" und dann auf "Systemsteuerung".
  - Doppelklicken Sie auf Verwaltung, und doppelklicken Sie dann auf Internetinformationsdienste-Manager (IIS-Manager).
Klicken Sie im Bereich Verbindungen auf den Servernamen, für den Sie FastCGI-Einstellungen konfigurieren möchten.
Doppelklicken Sie im Bereich Start auf FastCGI-Einstellungen.
Klicken Sie im Bereich Aktionen auf Anwendung hinzufügen.
Geben Sie im Dialogfeld FastCGI-Anwendung hinzufügen folgende Informationen ein:
- Geben Sie den Pfad zur Skript-Engine in das Feld Vollständiger Pfad ein. Beispiel: „C:\PHP\php-cgi.exe“.
- Geben Sie die maximale Anzahl von Anforderungen für die FastCGI-Anwendung ein.
  
  Hinweis
  
  Für PHP muss dieser Wert kleiner oder gleich der maximalen Anzahl von Anforderungen für die PHP-Umgebung sein, die mithilfe der Umgebungsvariablen PHP_FCGI_MAX_REQUESTS konfiguriert wird.
Klicken Sie neben EnvironmentVariables auf die Auslassungspunkte (...), um den Auflistungs-Editor für Umgebungsvariablen zu öffnen.
Klicken Sie im Dialogfeld Auflistungs-Editor – EnvironmentVariables auf Hinzufügen.
Geben Sie die folgenden Informationen ein, und klicken Sie dann auf OK.
- Geben Sie „PHP_FCGI_MAX_REQUESTS“ als Name ein.
- Geben Sie „10.000“ als Wert ein.
Klicken Sie auf OK, um das Dialogfeld FastCGI-Anwendung hinzufügen zu schließen.

Hinzufügen einer FastCGI-Umgebungsvariablen für PHP

Hinweis

Öffnen Sie Internetinformationsdienste-Manager (IIS-Manager):
- Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Server-Managerdann auf Toolsund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows 8 oder Windows 8.1 verwenden:
  - Halten Sie die Windows-Taste gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf "Systemsteuerung".
  - Klicken Sie auf Verwaltungund doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Server 2008 oder Windows Server 2008 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltungund dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Vista oder Windows 7 verwenden:
  - Klicken Sie auf der Taskleiste auf "Start" und dann auf "Systemsteuerung".
  - Doppelklicken Sie auf Verwaltung, und doppelklicken Sie dann auf Internetinformationsdienste-Manager (IIS-Manager).
Klicken Sie im Bereich Verbindungen auf den Servernamen, für den Sie FastCGI-Einstellungen konfigurieren möchten.
Doppelklicken Sie im Bereich Start auf FastCGI-Einstellungen.
Markieren Sie die PHP-Anwendung im Bereich FastCGI-Einstellungen, und klicken Sie dann im Bereich Aktionen auf Bearbeiten.
Klicken Sie im Dialogfeld FastCGI-Anwendung bearbeiten neben EnvironmentVariables auf die Auslassungspunkte (...), um den Auflistungs-Editor für Umgebungsvariablen zu öffnen.
Klicken Sie im Dialogfeld Auflistungs-Editor – EnvironmentVariables auf Hinzufügen.
Geben Sie die folgenden Informationen ein, und klicken Sie dann auf OK.
- Geben Sie „PHP_FCGI_MAX_REQUESTS“ als Name ein.
- Geben Sie „10.000“ als Wert ein.
Klicken Sie auf OK, um das Dialogfeld FastCGI-Anwendung hinzufügen zu schließen.

Konfiguration

Das <fastCgi>-Element kann auf der Serverebene in der Datei „ApplicationHost.config“ oder auf der Site-, Anwendungs- oder Verzeichnisebene in einer Datei vom Typ „Web.config“ konfiguriert werden.

Attribute

Keine

Untergeordnete Elemente

Element	Beschreibung
`application`	Optionales Element. Fügt der Sammlung von FastCGI-Prozesspooldefinitionen eine FastCGI-Prozesspooldefinition hinzu.

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel wird eine FastCGI-Anwendung für PHP hinzugefügt, das Attribut instanceMaxRequests wird auf „10.000“ festgelegt, und die Umgebungsvariable PHP_FCGI_MAX_REQUESTS wird auf „10.000“ festgelegt.

<fastCgi>
   <application fullPath="C:\PHP\php-cgi.exe"
         arguments=""
         maxInstances="4"
         idleTimeout="300"
         activityTimeout="30"
         requestTimeout="90"
         instanceMaxRequests="10000"
         protocol="NamedPipe"
         flushNamedPipe="false">
      <environmentVariables>
         <environmentVariable
            name="PHP_FCGI_MAX_REQUESTS"
            value="10000" />
      </environmentVariables>
   </application>
</fastCgi>

Hinweis

Für PHP muss der Wert der Umgebungsvariablen PHP_FCGI_MAX_REQUESTS eine Zahl sein, die kleiner oder gleich dem Wert ist, der durch das instanceMaxRequests-Attribut des FastCGI-<application>-Elements angegeben ist.

Im folgenden Konfigurationsbeispiel wird eine globale FastCGI-Handlerzuordnung für PHP-Dateien zu IIS hinzugefügt und der vollständige Pfad zu einer ausführbaren FastCGI-Datei angegeben.

<configuration>
   <location path="" overrideMode="Allow">
      <system.webServer>
         <handlers>
            <add name="PHP-FastCGI"
                path="*.php"
                verb="GET,HEAD,POST"
                modules="FastCgiModule"
                scriptProcessor="C:\PHP\php-cgi.exe"
                resourceType="Either"
                requireAccess="Script" />
         </handlers>
      </system.webServer>
   </location>
</configuration>

Hinweis

FastCGI-Einstellungen können pro Site konfiguriert werden. Hierzu werden eine speziell formatierte FastCGI-Anwendung und Handlerzuordnungen verwendet, die unterschieden werden, indem die Attribute fullPath und arguments für ein <application>-Element mit dem entsprechenden scriptProcessor-Attribut in der <handlers>-Zuordnung für den FastCGI-Prozess abgeglichen werden. Um diese Zuordnungen zu erstellen, müssen die Einstellungen in den Attributen fullPath und arguments für ein <application>-Element dem scriptProcessor-Attribut in der <handlers>-Zuordnung für den FastCGI-Prozess hinzugefügt und durch einen senkrechten Strich („|“) getrennt werden. Diese Kombination fungiert als eindeutiger Schlüssel für jede FastCGI-Anwendung. Der folgende Konfigurationsauszug zeigt z. B. zwei exemplarische Elemente vom Typ „<fastCgi>“/„<application>“ und die entsprechenden Zuordnungen vom Typ „<handlers>“ für zwei websitespezifische PHP-Handler:

<fastCgi>
   <application fullPath="C:\PHP\php-cgi.exe"
      arguments="-d open_basedir=C:\Websites\Website1" />
   <application fullPath="C:\PHP\php-cgi.exe"
      arguments="-d open_basedir=C:\Websites\Website2" />
</fastCgi>

<system.webServer>
   <handlers accessPolicy="Read, Script"> 
      <add name="PHP via FastCGI 1"
         path="*.php"
         verb="*"
         modules="FastCgiModule"
         scriptProcessor="C:\PHP\php-cgi.exe|-d open_basedir=C:\Websites\Website1"
         resourceType="Unspecified"
         requireAccess="Script" />
      <add name="PHP via FastCGI 2"
         path="*.php"
         verb="*"
         modules="FastCgiModule"
         scriptProcessor="C:\PHP\php-cgi.exe|-d open_basedir=C:\Websites\Website2"
         resourceType="Unspecified"
         requireAccess="Script" />
</handlers>
</system.webServer>

Beispielcode

In den folgenden Codebeispielen wird eine FastCGI-Anwendung für PHP hinzugefügt, das Attribut instanceMaxRequests wird auf „10.000“ festgelegt, und die Umgebungsvariable PHP_FCGI_MAX_REQUESTS wird auf „10.000“ festgelegt. In den Beispielen wird auch jeweils eine globale FastCGI-Handlerzuordnung für PHP-Dateien zu IIS hinzugefügt und der vollständige Pfad zu einer ausführbaren FastCGI-Datei angegeben.

AppCmd.exe

appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='C:\PHP\php-cgi.exe',arguments='',maxInstances='4',idleTimeout='300',activityTimeout='30',requestTimeout='90',instanceMaxRequests='10000',protocol='NamedPipe',flushNamedPipe='False']" /commit:apphost

appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='C:\PHP\php-cgi.exe'].environmentVariables.[name='PHP_FCGI_MAX_REQUESTS',value='10000']" /commit:apphost

appcmd.exe set config -section:system.webServer/handlers /+"[name='PHP-FastCGI',path='*.php',verb='GET,HEAD,POST',modules='FastCgiModule',scriptProcessor='C:\PHP\php-cgi.exe',resourceType='Either',requireAccess='Script']" /commit:apphost

Hinweis

Sie müssen unbedingt den Commitparameterapphost festlegen, wenn Sie AppCmd.exe verwenden, um diese Einstellungen zu konfigurieren. Dadurch werden die Konfigurationseinstellungen auf den entsprechenden Speicherortabschnitt in der Datei ApplicationHost.config festgelegt.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();

         ConfigurationSection fastCgiSection = config.GetSection("system.webServer/fastCgi");
         ConfigurationElementCollection fastCgiCollection = fastCgiSection.GetCollection();
         ConfigurationElement applicationElement = fastCgiCollection.CreateElement("application");
         applicationElement["fullPath"] = @"C:\PHP\php-cgi.exe";
         applicationElement["arguments"] = @"";
         applicationElement["maxInstances"] = 4;
         applicationElement["idleTimeout"] = 300;
         applicationElement["activityTimeout"] = 30;
         applicationElement["requestTimeout"] = 90;
         applicationElement["instanceMaxRequests"] = 10000;
         applicationElement["protocol"] = @"NamedPipe";
         applicationElement["flushNamedPipe"] = false;

         ConfigurationElementCollection environmentVariablesCollection = applicationElement.GetCollection("environmentVariables");
         ConfigurationElement environmentVariableElement = environmentVariablesCollection.CreateElement("environmentVariable");
         environmentVariableElement["name"] = @"PHP_FCGI_MAX_REQUESTS";
         environmentVariableElement["value"] = @"10000";
         environmentVariablesCollection.Add(environmentVariableElement);
         fastCgiCollection.Add(applicationElement);

         ConfigurationSection handlersSection = config.GetSection("system.webServer/handlers");
         ConfigurationElementCollection handlersCollection = handlersSection.GetCollection();
         ConfigurationElement addElement = handlersCollection.CreateElement("add");
         addElement["name"] = @"PHP-FastCGI";
         addElement["path"] = @"*.php";
         addElement["verb"] = @"GET,HEAD,POST";
         addElement["modules"] = @"FastCgiModule";
         addElement["scriptProcessor"] = @"C:\PHP\php-cgi.exe";
         addElement["resourceType"] = @"Either";
         addElement["requireAccess"] = @"Script";
         handlersCollection.AddAt(0, addElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration

      Dim fastCgiSection As ConfigurationSection = config.GetSection("system.webServer/fastCgi")
      Dim fastCgiCollection As ConfigurationElementCollection = fastCgiSection.GetCollection
      Dim applicationElement As ConfigurationElement = fastCgiCollection.CreateElement("application")
      applicationElement("fullPath") = "C:\PHP\php-cgi.exe"
      applicationElement("arguments") = ""
      applicationElement("maxInstances") = 4
      applicationElement("idleTimeout") = 300
      applicationElement("activityTimeout") = 30
      applicationElement("requestTimeout") = 90
      applicationElement("instanceMaxRequests") = 10000
      applicationElement("protocol") = "NamedPipe"
      applicationElement("flushNamedPipe") = False

      Dim environmentVariablesCollection As ConfigurationElementCollection = applicationElement.GetCollection("environmentVariables")
      Dim environmentVariableElement As ConfigurationElement = environmentVariablesCollection.CreateElement("environmentVariable")
      environmentVariableElement("name") = "PHP_FCGI_MAX_REQUESTS"
      environmentVariableElement("value") = "10000"
      environmentVariablesCollection.Add(environmentVariableElement)
      fastCgiCollection.Add(applicationElement)

      Dim handlersSection As ConfigurationSection = config.GetSection("system.webServer/handlers")
      Dim handlersCollection As ConfigurationElementCollection = handlersSection.GetCollection
      Dim addElement As ConfigurationElement = handlersCollection.CreateElement("add")
      addElement("name") = "PHP-FastCGI"
      addElement("path") = "*.php"
      addElement("verb") = "GET,HEAD,POST"
      addElement("modules") = "FastCgiModule"
      addElement("scriptProcessor") = "C:\PHP\php-cgi.exe"
      addElement("resourceType") = "Either"
      addElement("requireAccess") = "Script"
      handlersCollection.AddAt(0, addElement)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var fastCgiSection = adminManager.GetAdminSection("system.webServer/fastCgi", "MACHINE/WEBROOT/APPHOST");
var fastCgiCollection = fastCgiSection.Collection;
var applicationElement = fastCgiCollection.CreateNewElement("application");
applicationElement.Properties.Item("fullPath").Value = "C:\\PHP\\php-cgi.exe";
applicationElement.Properties.Item("arguments").Value = "";
applicationElement.Properties.Item("maxInstances").Value = 4;
applicationElement.Properties.Item("idleTimeout").Value = 300;
applicationElement.Properties.Item("activityTimeout").Value = 30;
applicationElement.Properties.Item("requestTimeout").Value = 90;
applicationElement.Properties.Item("instanceMaxRequests").Value = 10000;
applicationElement.Properties.Item("protocol").Value = "NamedPipe";
applicationElement.Properties.Item("queueLength").Value = 1000;
applicationElement.Properties.Item("flushNamedPipe").Value = false;
applicationElement.Properties.Item("rapidFailsPerMinute").Value = 10;

var environmentVariablesCollection = applicationElement.ChildElements.Item("environmentVariables").Collection;
var environmentVariableElement = environmentVariablesCollection.CreateNewElement("environmentVariable");
environmentVariableElement.Properties.Item("name").Value = "PHP_FCGI_MAX_REQUESTS";
environmentVariableElement.Properties.Item("value").Value = "10000";
environmentVariablesCollection.AddElement(environmentVariableElement);
fastCgiCollection.AddElement(applicationElement);

var handlersSection = adminManager.GetAdminSection("system.webServer/handlers", "MACHINE/WEBROOT/APPHOST");
var handlersCollection = handlersSection.Collection;
var addElement = handlersCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "PHP-FastCGI";
addElement.Properties.Item("path").Value = "*.php";
addElement.Properties.Item("verb").Value = "GET,HEAD,POST";
addElement.Properties.Item("modules").Value = "FastCgiModule";
addElement.Properties.Item("scriptProcessor").Value = "C:\\PHP\\php-cgi.exe";
addElement.Properties.Item("resourceType").Value = "Either";
addElement.Properties.Item("requireAccess").Value = "Script";
handlersCollection.AddElement(addElement, 0);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set fastCgiSection = adminManager.GetAdminSection("system.webServer/fastCgi", "MACHINE/WEBROOT/APPHOST")
Set fastCgiCollection = fastCgiSection.Collection
Set applicationElement = fastCgiCollection.CreateNewElement("application")
applicationElement.Properties.Item("fullPath").Value = "C:\PHP\php-cgi.exe"
applicationElement.Properties.Item("arguments").Value = ""
applicationElement.Properties.Item("maxInstances").Value = 4
applicationElement.Properties.Item("idleTimeout").Value = 300
applicationElement.Properties.Item("activityTimeout").Value = 30
applicationElement.Properties.Item("requestTimeout").Value = 90
applicationElement.Properties.Item("instanceMaxRequests").Value = 10000
applicationElement.Properties.Item("protocol").Value = "NamedPipe"
applicationElement.Properties.Item("queueLength").Value = 1000
applicationElement.Properties.Item("flushNamedPipe").Value = false
applicationElement.Properties.Item("rapidFailsPerMinute").Value = 10

Set environmentVariablesCollection = applicationElement.ChildElements.Item("environmentVariables").Collection
Set environmentVariableElement = environmentVariablesCollection.CreateNewElement("environmentVariable")
environmentVariableElement.Properties.Item("name").Value = "PHP_FCGI_MAX_REQUESTS"
environmentVariableElement.Properties.Item("value").Value = "10000"
environmentVariablesCollection.AddElement(environmentVariableElement)
Call fastCgiCollection.AddElement(applicationElement)

Set handlersSection = adminManager.GetAdminSection("system.webServer/handlers", "MACHINE/WEBROOT/APPHOST")
Set handlersCollection = handlersSection.Collection
Set addElement = handlersCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "PHP-FastCGI"
addElement.Properties.Item("path").Value = "*.php"
addElement.Properties.Item("verb").Value = "GET,HEAD,POST"
addElement.Properties.Item("modules").Value = "FastCgiModule"
addElement.Properties.Item("scriptProcessor").Value = "C:\PHP\php-cgi.exe"
addElement.Properties.Item("resourceType").Value = "Either"
addElement.Properties.Item("requireAccess").Value = "Script"
Call handlersCollection.AddElement(addElement, 0)

adminManager.CommitChanges()

FastCGI <fastCgi>

Übersicht

Neu in IIS 7.5

Kompatibilität

Setup

Windows Server 2012 oder Windows Server 2012 R2

Windows 8 oder Windows 8.1

Windows Server 2008 oder Windows Server 2008 R2

Windows Vista oder Windows 7

Gewusst wie

Erstellen einer globalen FastCGI-Handlerzuordnung für PHP

Erstellen einer FastCGI-Anwendung für PHP

Hinzufügen einer FastCGI-Umgebungsvariablen für PHP

Konfiguration

Attribute

Untergeordnete Elemente

Konfigurationsbeispiel

Beispielcode

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Feedback

Feedback

Zusätzliche Ressourcen