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

VisuellWikitext
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
Keine Bearbeitungszusammenfassung
 
(26 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:




{{Hint|file=icon_required.png|text=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.}}
{{Hint|file=icon_required.png|text=Der Quelltext von BlueSpice basiert auf der Scriptsprache "PHP". Diese muss auf Ihrem Server installiert werden, um BlueSpice betreiben zu können. Die hier aufgeführten Schritte sind zwingend erforderlich.}}


{{Hint|file=hint.png|text=PHP wird nicht mit einem "klassischen Installationspaket" installiert sondern die Sourcen werden heruntergeladen und über den [[Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP_Manager|im vorhergehenden Schritt installierten PHP Manager]] in IIS eingebunden.}}
{{Hint|file=hint.png|text=PHP wird nicht mit einem "klassischen Installationspaket" installiert, sondern die Sourcen werden heruntergeladen und über den [[Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP_Manager|im vorhergehenden Schritt installierten PHP Manager]] in IIS eingebunden.}}
==Download==
==Download==
{{Hint|file=hint.png|text=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.}}
{{Hint|file=hint.png|text=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 [https://windows.php.net/download/ 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):
Öffnen Sie in Ihrem Browser die [https://windows.php.net/download/ offizielle Download-Seite für Windows auf php.net] (1). Suchen Sie hier die derzeit [[Setup:Systemanforderungen|aktuell unterstützte Version]] (2) 64-bit Non Thread Safe (3) und laden diese herunter (4):


[[File:Setup:systempreparation_php_01.png|border|center|600px|PHP 01]]
[[File:Setup:systempreparation_php_01.png|border|center|600px|PHP 01]]


Folgen Sie den weiteren Download-Anweisungen.{{Hint|file=hint.png|text=In den  Screenshots und Anleitungsschritten wird nicht unbedingt die aktuell zuletzt unterstützte Version von PHP verwendet und dient nur beispielhaft für die aktuell unterstützten Versionen, 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.
{{Hint|file=hint.png|text=Diese Dokumentation geht von der von uns [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur_unter_Windows|empfohlenen Ordnerstruktur]] aus. Aus diesem Grund wird an dieser Stelle PHP in den Ordner C:\bluespice\bin\php-<version> 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, eine Umgebungsvariable in Windows zu konfigurieren. Führen Sie hierzu folgende Schritte durch:
Geben Sie die Tastenkombination Windows + R ein.


Folgen Sie den weiteren Download-Anweisungen.
Im folgenden Dialog tragen Sie "SystemPropertiesAdvanced.exe" ein (1) und bestätigen mit OK (2):


[[File:Setup:systempreparation_php_02.png|border|center|PHP 02]]


{{Hint|file=hint.png|text=Beachten Sie bitte, dass BlueSpice derzeit nicht mit PHP 8.x kompatibel ist.}}
Klicken Sie auf "Umgebungsvariablen":
 
[[File:Setup:systempreparation_php_03.png|border|center|PHP 03]]
 
Im unteren Bereich des jetzt geöffneten Fensters führen Sie einen Doppelklick auf die Zeile "Path" aus:
 
[[File:Setup:systempreparation_php_04.png|border|center|PHP 04]]
 
Klicken Sie auf "Neu":
 
[[File:Setup:systempreparation_php_05.png|border|center|PHP 05]]
 
Fügen Sie den Pfad zu Ihrer entpackten PHP-Version hinzu, in dem sich die Datei php.exe befindet.
 
[[File:Setup:systempreparation_php_06.png|border|center|PHP 06]]
 
Schließen Sie alle soeben geöffneten Fenster nacheinander wieder mit Klick auf "OK".


{{Hint|file=hint.png|text=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==
==Umgebungsvariable setzen==
==Überprüfung der Umgebungsvariable==
==Ü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):
[[File:Setup:systempreparation_php_07.png|border|center|PHP 07]]
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).
[[File:Setup:systempreparation_php_08.png|border|600px|center|PHP 08]]
Ist dies nicht der Fall, so wurde der Pfad zur Datei php.exe in den Umgebungsvariablen falsch angegeben.
==Einbinden von PHP in IIS==
==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):
[[File:Setup:systempreparation_php_09.png|border|center|PHP 09]]
Wählen Sie im linken Bereich Ihren Servernamen aus (1) und führen Sie anschließend einen Doppelklick auf "PHP Manager" (2) durch:
[[File:Setup:systempreparation_php_10.png|border|600px|center|PHP 10]]
Klicken Sie "Register new PHP version":
[[File:Setup:systempreparation_php_11.png|border|600px|center|PHP 11]]
Im folgenden Fenster wählen Sie den Durchsuchen-Button:
[[File:Setup:systempreparation_php_12.png|border|center|PHP 12]]
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):
[[File:Setup:systempreparation_php_13.png|border|600px|center|PHP 13]]
Bestätigen Sie nochmals mit "OK":
[[File:Setup:systempreparation_php_14.png|border|center|PHP 14]]
Klicken Sie auf "Configure error reporting":
[[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 seine Log-Datei 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. }}
Klicken Sie im Hauptfenster auf "Enable or disable an extension":
[[File:Setup:systempreparation_php_19.png|border|600px|center|PHP 19]]
Achten Sie darauf, dass folgende Erweiterungen aktiviert sind:
[[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_21.png|border|600px|center|PHP 21]]
Öffnen Sie die Konfigurationsdatei php.ini:
[[File:Setup:systempreparation_php_22.png|border|600px|center|PHP 22]]
Ersetzen Sie die Zeile extension=php_opcache.dll durch<code>zend_extension=php_opcache.dll</code>:
[[File:Setup:systempreparation_php_23.png|border|600px|center|PHP 23]]
Des Weiteren nehmen Sie in dieser Datei bitte folgende Änderungen an diesen Optionen vor:
{|
! style="background-color:#eaeaea;border:1px solid #000;padding:5px;" |Name
! style="background-color:#eaeaea;border:1px solid #000;padding:5px;" |Wert
! style="background-color:#eaeaea;border:1px solid #000;padding:5px;" |Kommentar
|-
| style="border:1px solid #000;padding:5px;" |date.timezone
| style="border:1px solid #000;padding:5px;" |"Europe/Berlin"
| style="border:1px solid #000;padding:5px;" |Bitte wählen Sie die für Sie zutreffende [https://www.php.net/manual/en/timezones.php Zeitzone]<br />Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |max_execution_time
| style="border:1px solid #000;padding:5px;" |600
| style="border:1px solid #000;padding:5px;" |
|-
| style="border:1px solid #000;padding:5px;" |post_max_size
| style="border:1px solid #000;padding:5px;" |1024M
| style="border:1px solid #000;padding:5px;" |
|-
| style="border:1px solid #000;padding:5px;" |upload_max_filesize
| style="border:1px solid #000;padding:5px;" |1024M
| style="border:1px solid #000;padding:5px;" |
|-
| style="border:1px solid #000;padding:5px;" |opcache.enable
| style="border:1px solid #000;padding:5px;" |1
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.enable_cli
| style="border:1px solid #000;padding:5px;" |0
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.memory_consumption
| style="border:1px solid #000;padding:5px;" |512
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.max_accelerated_files
| style="border:1px solid #000;padding:5px;" |1000000
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.validate_timestamps
| style="border:1px solid #000;padding:5px;" |1
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.revalidate_freq
| style="border:1px solid #000;padding:5px;" |2
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.optimization_level
| style="border:1px solid #000;padding:5px;" |0x7FFF9FFF
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |opcache.blacklist_filename
| style="border:1px solid #000;padding:5px;" |C:\bluespice\etc\opcache.blacklist
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|-
| style="border:1px solid #000;padding:5px;" |zlib.output_compression
| style="border:1px solid #000;padding:5px;" |On
| style="border:1px solid #000;padding:5px;" |
|-
| style="border:1px solid #000;padding:5px;" |zlib.output_compression_level
| style="border:1px solid #000;padding:5px;" |9
| style="border:1px solid #000;padding:5px;" |Bitte entfernen Sie die Auskommentierung
|}
Speichern und schließen Sie die Datei.
Im Anschluss erstellen Sie den Ordner<code>C:\bluespice\etc</code> und erstellen darin eine Textdatei mit dem Namen <code>opcache.blacklist</code> mit dem Inhalt <code>C:\bluespice\var\www\w\extensions\BlueSpiceFoundation\config\*</code>
Im nächsten Schritt erweitern Sie den Baum auf der linken Seite, bis die "Default Web Site" sichtbar wird:
[[File:Setup:systempreparation_php_24.png|border|600px|center|PHP 24]]
Führen Sie auf diese einen Rechtsklick aus (1) und klicken auf "Entfernen" (2):
[[File:Setup:systempreparation_php_25.png|border|600px|center|PHP 25]]
Den folgenden Dialog bestätigen Sie mit "Ja":
[[File:Setup:systempreparation_php_26.png|border|center|PHP 26]]
Führen Sie einen Rechtsklick auf "Sites" aus (1) und klicken auf "Website hinzufügen" (2):
[[File:Setup:systempreparation_php_27.png|border|600px|center|PHP 27]]
Vergeben Sie den Sitename "BlueSpice" (1) und wählen den Pfad auf Ihrem Server aus, in dem sich Ihre BlueSpice-Installation später befinden wird (2). Bestätigen Sie mit "OK" (3):
[[File:Setup:systempreparation_php_28.png|border|center|PHP 28]]
Die soeben angelegte Seite wird jetzt in der IIS-Übersicht gelistet:
[[File:Setup:systempreparation_php_29.png|border|600px|center|PHP 29]]
==Nächster Schritt==
==Nächster Schritt==
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/MariaDB|MariaDB]].
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/MariaDB|MariaDB]].

Aktuelle Version vom 26. April 2024, 11:44 Uhr


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


hint.png
 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

hint.png
 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 aktuell unterstützte Version (2) 64-bit Non Thread Safe (3) und laden diese herunter (4):

PHP 01

Folgen Sie den weiteren Download-Anweisungen.

hint.png
 In den Screenshots und Anleitungsschritten wird nicht unbedingt die aktuell zuletzt unterstützte Version von PHP verwendet und dient nur beispielhaft für die aktuell unterstützten Versionen, 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.


hint.png
 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-<version> 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, 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):

PHP 02

Klicken Sie auf "Umgebungsvariablen":

PHP 03

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

PHP 04

Klicken Sie auf "Neu":

PHP 05

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

PHP 06

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):


PHP 07

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).

PHP 08

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):

PHP 09

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

PHP 10

Klicken Sie "Register new PHP version":

PHP 11

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

PHP 12

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):

PHP 13

Bestätigen Sie nochmals mit "OK":

PHP 14

Klicken Sie auf "Configure error reporting":

PHP 15

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

PHP 16


hint.png
 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 im Hauptfenster auf "Enable or disable an extension":

PHP 19

Achten Sie darauf, dass folgende Erweiterungen aktiviert sind:

PHP 20

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

PHP 21

Öffnen Sie die Konfigurationsdatei php.ini:

PHP 22

Ersetzen Sie die Zeile extension=php_opcache.dll durchzend_extension=php_opcache.dll:

PHP 23

Des Weiteren nehmen Sie in dieser Datei bitte folgende Änderungen an diesen Optionen vor:

Name Wert Kommentar
date.timezone "Europe/Berlin" Bitte wählen Sie die für Sie zutreffende Zeitzone
Bitte entfernen Sie die Auskommentierung
max_execution_time 600
post_max_size 1024M
upload_max_filesize 1024M
opcache.enable 1 Bitte entfernen Sie die Auskommentierung
opcache.enable_cli 0 Bitte entfernen Sie die Auskommentierung
opcache.memory_consumption 512 Bitte entfernen Sie die Auskommentierung
opcache.max_accelerated_files 1000000 Bitte entfernen Sie die Auskommentierung
opcache.validate_timestamps 1 Bitte entfernen Sie die Auskommentierung
opcache.revalidate_freq 2 Bitte entfernen Sie die Auskommentierung
opcache.optimization_level 0x7FFF9FFF Bitte entfernen Sie die Auskommentierung
opcache.blacklist_filename C:\bluespice\etc\opcache.blacklist Bitte entfernen Sie die Auskommentierung
zlib.output_compression On
zlib.output_compression_level 9 Bitte entfernen Sie die Auskommentierung


Speichern und schließen Sie die Datei.


Im Anschluss erstellen Sie den OrdnerC:\bluespice\etc und erstellen darin eine Textdatei mit dem Namen opcache.blacklist mit dem Inhalt C:\bluespice\var\www\w\extensions\BlueSpiceFoundation\config\*

Im nächsten Schritt erweitern Sie den Baum auf der linken Seite, bis die "Default Web Site" sichtbar wird:

PHP 24

Führen Sie auf diese einen Rechtsklick aus (1) und klicken auf "Entfernen" (2):

PHP 25

Den folgenden Dialog bestätigen Sie mit "Ja":

PHP 26

Führen Sie einen Rechtsklick auf "Sites" aus (1) und klicken auf "Website hinzufügen" (2):

PHP 27

Vergeben Sie den Sitename "BlueSpice" (1) und wählen den Pfad auf Ihrem Server aus, in dem sich Ihre BlueSpice-Installation später befinden wird (2). Bestätigen Sie mit "OK" (3):

PHP 28

Die soeben angelegte Seite wird jetzt in der IIS-Übersicht gelistet:

PHP 29


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.

Abgerufen von „https://de.wiki.bluespice.com/w/index.php?title=Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP&oldid=10292“