Difference between revisions of "Setup:Installation Guide/System Preparation/Windows/PHP 7.3"

[quality revision][quality revision]
m (Text replacement - "[[en:{{PAGENAME}}]]" to "[[en:{{FULLPAGENAME}}]]")
 
icon required.png
The source code of BlueSpice is based on the scripting language "PHP". It must be installed on your server in order to operate BlueSpice. The steps listed here are required.

Introduction[edit | edit source]

PHP is not installed with a "classic installation package", but the sources are downloaded and integrated in IIS via the previously installed PHP Manager.

Downloading PHP[edit | edit source]

In your browser, open the official download page for Windows on php.net (1). Find the latest version 7.3.x (2) 64-bit (3) Thread-Safe (4) and download it here (5):
PHP Download 01

Follow the download instructions.


Hint.jpg
Please note that the download on your Windows Server with Internet Explorer will only work if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft.



Hint.jpg
The following is PHP version 7.3.3 and is only an example of the latest version 7.3.x that you can download at the time of your installation.

Unzipping the ZIP archive[edit | edit source]

Unzip the ZIP archive just downloaded into a useful system path on your hard drive.


Hint.jpg
This documentation assumes the recommended folder structure.

For this reason PHP will be unpacked into the folder C:\bluespice\bin\php-7.3.3. If you have a different folder structure, you must adapt these paths accordingly.

Setting the environment variable[edit | edit source]

In order to use PHP easily on the command line of Windows, it is necessary to configure an environment variable in Windows accordingly. To do this, perform the following steps:

Enter the key combination Windows+R.

In the following dialog enter "SystemPropertiesAdvanced.exe" (1) and confirm with OK (2):
Environment variables 02
Click "Environment variables":
Environment variables 03
In the lower part of the now opened window double-click on the line "Path":
Environment variables 04
Click "New":
Environment variables 05
Add the path to your unpacked PHP version, which contains the php.exe file:
Environment variables 06

Close all newly opened windows one after the other by clicking on "OK".

Checking the environment variable[edit | edit source]

To make sure the environment variable is set correctly, perform the following steps:

Enter the key combination Windows+R.

In the following dialog, enter "cmd" (1) and confirm with OK (2):
Environment variables 07
At the command prompt, type "php -v" (1) and press the Enter key. The found PHP version will be displayed (2).
Environment variables 08

If this is not the case, then the path to the php.exe file in the environment variables was incorrectly specified.

Configuring IIS for PHP[edit | edit source]

In the following steps, PHP will be included in IIS and IIS will be configured to provide a working basic setup:

First, call IIS Manager. To do this, enter the key combination Windows+R.

In the following dialog, enter "inetmgr" (1) and confirm with "OK" (2):

PHP and IIS 01

In the left pane, select your server name (1) and then double-click "PHP Manager" (2):

PHP and IIS 02
Click "Register new PHP version":
PHP and IIS 03

In the following window select the browse "(...)" button:

PHP and IIS 04

To manage the PHP settings in the next window:

Change to the path to which you previously unzipped PHP (1), mark the "php-cgi.exe" (2) and confirm the dialog with "Open" (3):

PHP and IIS 05

Confirm again with "OK":

PHP and IIS 06
Click on "Configure error reporting":
PHP and IIS 07

Activate the item "Production machine" (1) and select a path and a file of your choice where PHP should save its log (2). Confirm with "Apply" (3):

PHP and IIS 08


Hint.jpg
This documentation assumes the recommended folder structure. If the path you specify here does not yet exist, please create it before clicking "Apply".


Click "Manage all settings":

PHP and IIS 09

Adjust the following settings:

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

To find these options faster, you can also use the filter (1). Go back afterwards (2):

PHP and IIS 10

In the main window, click "Enable or disable an extension":

PHP and IIS 11

Make sure that the following extensions are enabled:

PHP and IIS 12

To activate an extension, select it in the "Disabled" section (1) and activate it by clicking on "Enable" (2):

PHP and IIS 13

In the next step, expand the tree on the left until the "Default Web Site" becomes visible:

PHP and IIS 14

Right-click (1) and then click "Remove" (2):

PHP and IIS 15

Confirm the following dialog with "Yes":

PHP and IIS 16

Right-click on "Sites" (1) and click on "Add Website" (2):

PHP and IIS 17

Enter the site name "BlueSpice" (1) and select the path on your server where your BlueSpice installation will be located later (2). Confirm with "OK" (3):

PHP and IIS 18


Hint.jpg
This documentation assumes the recommended folder structure. If the path you specify here does not yet exist, please create it before clicking "OK".


The new page is now listed in the IIS overview page:

PHP and IIS 19

Next step[edit | edit source]

If you have successfully completed all these steps, you can proceed to the next step " MariaDB".

{{DISPLAYTITLE:PHP 7.3 on Windows}}
            __TOC__
        

        {{Template:Important|text=The source code of BlueSpice is based on the scripting language "PHP". It must be installed on your server in order to operate BlueSpice. The steps listed here are required.}}
        
        ==Introduction==
        
        PHP is not installed with a "classic installation package", but the sources are downloaded and integrated in IIS via the [[Setup:Installation Guide/System Preparation/Windows/PHP_Manager |  previously  installed PHP Manager]].
        
        ==Downloading PHP==
        

        In your browser, open the [https://windows.php.net/download/ official download page for Windows on php.net] (1). Find the latest version 7.3.x (2) 64-bit (3) Thread-Safe (4) and download it here (5):<br />[[File:Setup:PHP_Download_01.png|center|400px|PHP Download 01]]
        

        Follow the download instructions.
        
<br />{{Template:Hint|text=Please note that the download on your Windows Server with Internet Explorer will only work if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft.}}
        

        {{Template:Hint|text=The following is PHP version 7.3.3 and is only an example of the latest version 7.3.x that you can download at the time of your installation.}}
        
        ==Unzipping the ZIP archive==
        
        Unzip the ZIP archive just downloaded into a useful system path on your hard drive.
        

        {{Template:Hint|text=This documentation assumes the [[Setup:Installation Guide/Advanced/Windows_Folder_Structure|recommended folder structure]]. 
        
        For this reason PHP will be unpacked into the folder C:\bluespice\bin\php-7.3.3. If you have a different folder structure, you must adapt these paths accordingly.}}
        
        ==Setting the environment variable==
        
        In order to use PHP easily on the command line of Windows, it is necessary to configure an environment variable in Windows accordingly. To do this, perform the following steps:
        

        Enter the key combination Windows+R.
        

        In the following dialog enter "SystemPropertiesAdvanced.exe" (1) and confirm with OK (2):[[File:Setup:EnvironmentVariables_01.png|center|400px|Environment variables 02]]
        

        Click "Environment variables":[[File:Setup:EnvironmentVariables_02.png|center|400px|Environment variables 03]]
        

        In the lower part of the now opened window double-click on the line "Path":[[File:Setup:EnvironmentVariables_03.png|center|400px|Environment variables 04]]
        

        Click "New":[[File:Setup:EnvironmentVariables_04.png|center|400px|Environment variables 05]]
        

        Add the path to your unpacked PHP version, which contains the php.exe file:[[File:Setup:PHP_EnvironmentVariables_01.png|center|400px|Environment variables 06]]
        

        Close all newly opened windows one after the other by clicking on "OK".
        
        ==Checking the environment variable==
        
        To make sure the environment variable is set correctly, perform the following steps:
        

        Enter the key combination Windows+R.
        

        In the following dialog, enter "cmd" (1) and confirm with OK (2):[[File:Setup:PHP_EnvironmentVariables_02.png|center|400px|Environment variables 07]]
        

        At the command prompt, type "php -v" (1) and press the Enter key. The found PHP version will be displayed (2).[[File:Setup:PHP_EnvironmentVariables_03.png|center|400px|Environment variables 08]]
        

        If this is not the case, then the path to the php.exe file in the environment variables was incorrectly specified.
        
        ==Configuring IIS for PHP==
        
        In the following steps, PHP will be included in IIS and IIS will be configured to provide a working basic setup:
        

        First, call IIS Manager. To do this, enter the key combination Windows+R.
        

        In the following dialog, enter "inetmgr" (1) and confirm with "OK" (2):
        

        [[File:Setup:PHP_IIS_Config_01.png|center|400px|PHP and IIS 01]]
        

        In the left pane, select your server name (1) and then double-click "PHP Manager" (2):
        

        [[File:Setup:PHP_IIS_Config_02.png|center|400px|PHP and IIS 02]]
        
        Click "Register new PHP version":[[File:Setup:PHP_IIS_Config_03.png|center|400px|PHP and IIS 03]]
        

        In the following window select the browse "(...)" button:
        

        [[File:Setup:PHP_IIS_Config_04.png|center|400px|PHP and IIS 04]]
        

        '''To manage the PHP settings in the next window:'''
        

        Change to the path to which you previously unzipped PHP (1), mark the "php-cgi.exe" (2) and confirm the dialog with "Open" (3):
        

        [[File:Setup:PHP_IIS_Config_05.png|center|400px|PHP and IIS 05]]
        

        Confirm again with "OK":
        

        [[File:Setup:PHP_IIS_Config_06.png|center|400px|PHP and IIS 06]]
        

        Click on "Configure error reporting":[[File:Setup:PHP_IIS_Config_07.png|center|400px|PHP and IIS 07]]
        

        Activate the item "Production machine" (1) and select a path and a file of your choice where PHP should save its log (2). Confirm with "Apply" (3):
        

        [[File:Setup:PHP_IIS_Config_08.png|center|400px|PHP and IIS 08]]
        

        {{Template:Hint|text=This documentation assumes the [[Setup:Installation Guide/Advanced/Windows_Folder_Structure|recommended folder structure]].  If the path you specify here does not yet exist, please create it before clicking  "Apply".}}
        

        Click "Manage all settings":
        

        [[File:Setup:PHP_IIS_Config_09.png|center|400px|PHP and IIS 09]]
        

        Adjust the following settings:
        

        {| style="align:middle"
        
        ! style="" |Name
            
            ! style="" |Value
            
            ! style="" |Section
            
            |-
            
            | style="" |date.timezone
            
            | style="border: 1px solid #000; padding: 5px;" |Name
            
            ! style="border: 1px solid #000; padding: 5px;" |Value
            
            ! style="border: 1px solid #000; padding: 5px;" |Section
            
            |-
            
            | style="border: 1px solid #000; padding: 5px;" |date.timezone
            
            | style="border: 1px solid #000; padding: 5px;" |"Europe/Berlin"<br />''oder entsprechend Ihrer Zeitzone''
        
        | style="" |Date
            
            |-
            
            | style="border: 1px solid #000; padding: 5px;" |Date
            
            |-
            
            | style="border: 1px solid #000; padding: 5px;" |max_execution_time
        
        | style="" |600
            
            | style="" |PHP
            
            |-
            
            | style="border: 1px solid #000; padding: 5px;" |600
            
            | style="border: 1px solid #000; padding: 5px;" |PHP
            
            |-
            
            | style="border: 1px solid #000; padding: 5px;" |post_max_size
        
        | style="" |128M
            
            | style="" |PHP
            
            |-
            
            | style="border: 1px solid #000; padding: 5px;" |128M
            
            | style="border: 1px solid #000; padding: 5px;" |PHP
            
            |-
            
            | style="border: 1px solid #000; padding: 5px;" |upload_max_filesize
        
        | style="" |128M
            
            | style="border: 1px solid #000; padding: 5px;" |128M
            
            | style="border: 1px solid #000; padding: 5px;" |PHP
        
        |}
        

        To find these options faster, you can also use the filter (1). Go back afterwards (2):
        

        [[File:Setup:PHP_IIS_Config_10.png|center|400px|PHP and IIS 10]]
        

        In the main window, click "Enable or disable an extension":
        

        [[File:Setup:PHP_IIS_Config_11.png|center|400px|PHP and IIS 11]]
        

        Make sure that the following extensions are enabled:
        

        [[File:Setup:PHP_IIS_Config_12.png|center|400px|PHP and IIS 12]]
        

        To activate an extension, select it in the "Disabled" section (1) and activate it by clicking on "Enable" (2):
        

        [[File:Setup:PHP_IIS_Config_13.png|center|400px|PHP and IIS 13]]
        

        In the next step, expand the tree on the left until the "Default Web Site" becomes visible:
        

        [[File:Setup:PHP_IIS_Config_14.png|center|400px|PHP and IIS 14]]
        

        Right-click (1) and then click  "Remove" (2):
        

        [[File:Setup:PHP_IIS_Config_15.png|center|400px|PHP and IIS 15]]
        

        Confirm the following dialog with "Yes":
        

        [[File:Setup:PHP_IIS_Config_16.png|center|400px|PHP and IIS 16]]
        

        Right-click on "Sites" (1) and click on "Add Website" (2):
        

        [[File:Setup:PHP_IIS_Config_17.png|center|400px|PHP and IIS 17]]
        

        Enter the site name "BlueSpice" (1) and select the path on your server where your BlueSpice installation will be located later (2). Confirm with "OK" (3):
        
        [[File:Setup:PHP_IIS_Config_18.png|center|400px|PHP and IIS 18]]
        

        {{Template:Hint|text=This documentation assumes the [[Setup:Installation Guide/Advanced/Windows_Folder_Structure|recommended folder structure]].  If the path you specify here does not yet exist, please create it before clicking  "OK".}}
        

        The new page is now listed in the IIS overview page:
        

        [[File:Setup:PHP_IIS_Config_19.png|center|400px|PHP and IIS 19]]
        

        ==Next step==
        
        If you have successfully completed all these steps, you can proceed to the next step "[[Setup: Installation Guide/System Preparation/Windows/MariaDB | MariaDB]]".
        

        [[en:{{FULLPAGENAME}}]]
        
        [[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP_7.3]]
Line 1: Line 1:
 +
{{DISPLAYTITLE:PHP 7.3 on Windows}}
 
__TOC__
 
__TOC__
  
Line 87: Line 88:
  
 
{| style="align:middle"
 
{| style="align:middle"
! style="border: 1px solid #000; padding: 5px;" |Name
+
! style="" |Name
! style="border: 1px solid #000; padding: 5px;" |Value
+
! style="" |Value
! style="border: 1px solid #000; padding: 5px;" |Section
+
! style="" |Section
 
|-
 
|-
| style="border: 1px solid #000; padding: 5px;" |date.timezone
+
| style="" |date.timezone
| style="border: 1px solid #000; padding: 5px;" |"Europe/Berlin"<br />''oder entsprechend Ihrer Zeitzone''
+
| style="" |"Europe/Berlin"<br />''oder entsprechend Ihrer Zeitzone''
| style="border: 1px solid #000; padding: 5px;" |Date
+
| style="" |Date
 
|-
 
|-
| style="border: 1px solid #000; padding: 5px;" |max_execution_time
+
| style="" |max_execution_time
| style="border: 1px solid #000; padding: 5px;" |600
+
| style="" |600
| style="border: 1px solid #000; padding: 5px;" |PHP
+
| style="" |PHP
 
|-
 
|-
| style="border: 1px solid #000; padding: 5px;" |post_max_size
+
| style="" |post_max_size
| style="border: 1px solid #000; padding: 5px;" |128M
+
| style="" |128M
| style="border: 1px solid #000; padding: 5px;" |PHP
+
| style="" |PHP
 
|-
 
|-
| style="border: 1px solid #000; padding: 5px;" |upload_max_filesize
+
| style="" |upload_max_filesize
| style="border: 1px solid #000; padding: 5px;" |128M
+
| style="" |128M
| style="border: 1px solid #000; padding: 5px;" |PHP
+
| style="" |PHP
 
|}
 
|}
  

Attachments

Discussions