Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP: Unterschied zwischen den Versionen

Version vom 9. März 2022, 12:06 Uhr

	Der Quelltext von BlueSpice basiert auf der Scriptsprache "PHP". Dies muss auf Ihrem Server installiert werden, um BlueSpice betreiben zu können. Die hier aufgeführten Schritte sind zwingend erforderlich.

	PHP wird nicht mit einem "klassischen Installationspaket" installiert sondern die Sourcen werden heruntergeladen und über den im vorhergehenden Schritt installierten PHP Manager in IIS eingebunden.

Download

	Der Inhalt dieses Abschnitts verweist auf externe Quellen und ist zum Zeitpunkt der Erstellung dieser Dokumentation aktuell. Wir können nicht garantieren, wie lange diese Quellen in Ihrer Form so Bestand haben. Informieren Sie uns gerne, wenn Sie hier Abweichungen feststellen.

Öffnen Sie in Ihrem Browser die offizielle Download-Seite für Windows auf php.net (1). Suchen Sie hier die derzeit aktuellste Version 7.4.x (2) 64-bit Non Thread Safe (3) und laden diese herunter (4):

Folgen Sie den weiteren Download-Anweisungen.

	Beachten Sie bitte, dass BlueSpice derzeit nicht mit PHP 8.x kompatibel ist.

	Im Folgenden wird die PHP-Version 7.4.28 verwendet und dient nur beispielhaft für die aktuellste Version 7.4.x, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.

Entpacken des ZIP-Archivs

Entpacken Sie das soeben heruntergeladene ZIP-Archiv in einen sinnvollen Systempfad auf Ihrer Festplatte.

	Diese Dokumentation geht von der von uns empfohlenen Ordnerstruktur aus. Aus diesem Grund wird an dieser Stelle PHP in den Ordner C:\bluespice\bin\php-7.4.28 entpackt. Haben Sie individuelle Wünsche, so passen Sie diese Pfade nach eigenem Verständnis an.

Umgebungsvariable setzen

Um PHP problemlos auf der Kommandozeile von Windows nutzen zu können, ist es nötig, entsprechend eine Umgebungsvariable in Windows zu konfigurieren. Führen Sie hierzu folgende Schritte durch:

Geben Sie die Tastenkombination Windows + R ein.

Im folgenden Dialog tragen Sie "SystemPropertiesAdvanced.exe" ein (1) und bestätigen mit OK (2):

Klicken Sie auf "Umgebungsvariablen":

Im unteren Bereich des jetzt geöffneten Fensters führen Sie einen Doppelklick auf die Zeile "Path" aus:

Klicken Sie auf "Neu":

Fügen Sie den Pfad zu Ihrer entpackten PHP-Version hinzu, in dem sich die Datei php.exe befindet.

Schließen Sie alle soeben geöffneten Fenster nacheinander wieder mit Klick auf "OK".

Überprüfung der Umgebungsvariable

Um sicherzustellen, dass die Umgebungsvariable richtig gesetzt wurde, führen Sie folgende Schritte durch:

Geben Sie die Tastenkombination Windows + R ein.

Im folgenden Dialog tragen Sie "cmd" ein (1) und bestätigen mit OK (2):

In der jetzt geöffneten Eingabeaufforderung geben Sie "php -v" (1) und drücken die Enter-Taste. Die gefundene PHP-Version wird Ihnen angezeigt (2).

Ist dies nicht der Fall, so wurde der Pfad zur Datei php.exe in den Umgebungsvariablen falsch angegeben.

Einbinden von PHP in IIS

In den folgenden Schritten wird PHP in IIS eingebunden und IIS so konfiguriert, dass ein funktionierendes Basis-Setup entsteht.

Rufen Sie zunächst den IIS-Manager auf. Geben Sie hierzu die Tastenkombination Windows + R ein.

Im folgenden Dialog tragen Sie "inetmgr" ein (1) und bestätigen mit OK (2):

Wählen Sie im linken Bereich Ihren Servernamen aus (1) und führen Sie anschließend einen Doppelklick auf "PHP Manager" (2) durch:

Klicken Sie "Register new PHP version":

Im folgenden Fenster wählen Sie den Durchsuchen-Button:

Wechseln Sie zum Pfad, in den Sie zuvor PHP entpackt haben (1), markieren dort die "php-cgi.exe" (2) und bestätigen den Dialog mit "Open" (3):

Klicken Sie auf "Configure error reporting":

Aktivieren Sie den Punkt "Production machine" (1) und wählen Sie einen Pfad und eine Datei Ihrer Wahl, wo PHP sein Log ablegen soll (2). Bestätigen Sie mit "Apply" (3):

Aktivieren Sie den Punkt "Production machine" (1) und wählen Sie einen Pfad und eine Datei Ihrer Wahl, wo PHP sein Log ablegen soll (2). Bestätigen Sie mit "Apply" (3):

	Auch hier wird von der empfohlenen Ordnerstruktur ausgegangen. Sollte der Pfad, den Sie hier angeben, noch nicht existieren, so legen Sie diesen bitte vor dem Klick auf "Apply" an.

Klicken Sie auf "Manage all settings":

PHP 17

Folgende Optionen passen Sie hier bitte wie folgt an:

Name	Value	Section
date.timezone	"Europe/Berlin" oder entsprechend Ihrer Zeitzone	Date
max_execution_time	600	PHP
post_max_size	128M	PHP
upload_max_filesize	128M	PHP

Zum schnelleren Auffinden dieser Optionen können Sie sich auch dem Filter (1) bedienen. Gehen Sie im Anschluss zurück (2):

PHP 18

Klicken Sie im Hauptfenster auf "Enable or disable an extension":

Achten Sie darauf, dass folgende Erweiterungen aktiviert sind:

Um eine Erweiterung zu aktivieren, suchen Sie diese im Bereich "Disabled" heraus (1) und aktivieren diese durch Klick auf "Enable" (2):

Nächster Schritt

Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt MariaDB.

Feedback zur Dokumentation ist im Community-Forum möglich.

@@ Zeile 114: / Zeile 114: @@
 [[File:Setup:systempreparation_php_15.png|border|600px|center|PHP 15]]
+Aktivieren Sie den Punkt "Production machine" (1) und wählen Sie einen Pfad und eine Datei Ihrer Wahl, wo PHP sein Log ablegen soll (2). Bestätigen Sie mit "Apply" (3):
+[[File:Setup:systempreparation_php_16.png|border|600px|center|PHP 16]]
 {{Hint|file=hint.png|text=Auch hier wird von der [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur_unter_Windows|empfohlenen Ordnerstruktur]] ausgegangen. Sollte der Pfad, den Sie hier angeben, noch nicht existieren, so legen Sie diesen bitte vor dem Klick auf "Apply" an. }}
@@ Zeile 119: / Zeile 123: @@
 Klicken Sie auf "Manage all settings":
-[[File:Setup:systempreparation_php_16.png|border|600px|center|PHP 16]]
+[[File:Setup:systempreparation_php_17.png|border|600px|center|PHP 17]]
@@ Zeile 148: / Zeile 152: @@
 Zum schnelleren Auffinden dieser Optionen können Sie sich auch dem Filter (1) bedienen. Gehen Sie im Anschluss zurück (2):
-[[File:Setup:systempreparation_php_17.png|border|600px|center|PHP 17]]
+[[File:Setup:systempreparation_php_18.png|border|600px|center|PHP 18]]
 Klicken Sie im Hauptfenster auf "Enable or disable an extension":
-[[File:Setup:systempreparation_php_18.png|border|600px|center|PHP 18]]
+[[File:Setup:systempreparation_php_19.png|border|600px|center|PHP 19]]
 Achten Sie darauf, dass folgende Erweiterungen aktiviert sind:
-[[File:Setup:systempreparation_php_18.png|border|600px|center|PHP 18]]
+[[File:Setup:systempreparation_php_20.png|border|600px|center|PHP 20]]
 Um eine Erweiterung zu aktivieren, suchen Sie diese im Bereich "Disabled" heraus (1) und aktivieren diese durch Klick auf "Enable" (2):
-[[File:Setup:systempreparation_php_19.png|border|600px|center|PHP 19]]
+[[File:Setup:systempreparation_php_21.png|border|600px|center|PHP 21]]
 ==Nächster Schritt==
 Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/MariaDB|MariaDB]].