How To: Enable Multiple PHP in NodeWorx and SiteWorx
====================================================

The InterWorx Control Panel provides the ability to install more than one version of PHP using the
Multiple PHP tool. From the Webserver page, server administrators can install several different
PHP versions, which can then be assigned to different domains and SiteWorx accounts. 

Documentation on how to set PHP versions for specific domains in SiteWorx can be found :doc:`here </siteworx/domains_and_websites/php/change-php-versions>`.

.. note:: 

   The versions of PHP provided by the Multiple PHP tool within InterWorx are PHP-FPM by default, whether
   the system-level PHP mode is set to SuPHP or PHP-FPM. 

.. contents::

Managing Multiple PHP Versions in NodeWorx
------------------------------------------

To Enable Multiple PHP 
^^^^^^^^^^^^^^^^^^^^^^

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. From NodeWorx, navigate to **System Services > Web Server > Overview**
#. Under Multiple PHP Versions, click **Enable**

.. image:: /images//multiphp-2.png
   :alt: multiple php enable button

To Install Multiple PHP Versions
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. From NodeWorx, navigate to **System Services > Web Server > Overview**
#. Under Multiple PHP Versions, select the **checkbox** next to the PHP versions to be installed

   .. note:: 

      Depending on the number of PHP versions that are being installed, and the speed of the internet 
      connection on the server, it is not uncommon for this process to take several minutes. 

   .. image:: /images/multiphp-3.png
      :alt: php versions

#. Click **Update** 

Managing Multiple PHP Versions for SiteWorx Accounts
----------------------------------------------------

  
To Set the Default PHP Version for SiteWorx Accounts
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The Default PHP Version is what will be pre-selected when creating new SiteWorx accounts.

This also controls the default value when using an API call to create a new SiteWorx Account.

.. note:: 

   Changing the default PHP version will only affect newly created SiteWorx accounts. The PHP version for existing
   accounts will not be changed.

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. From NodeWorx, navigate to **System Services > Web Server > Overview**
#. From the Default PHP Version dropdown, select the **installed PHP version** to set as the 
   default
#. Click **Update**

.. image:: /images/sw-default-php-version.png
   :alt: default php version

To Enable Specific PHP Versions for a SiteWorx Account
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

It is possible for server administrators to set specific PHP versions that a SiteWorx account has
access to. This can be achieved both when creating a new SiteWorx account, or when editing an existing 
one.

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. From NodeWorx, navigate to **SiteWorx > Accounts**
#. If creating a new SiteWorx account, click **+**

   - If editing an existing SiteWorx account, click the **Pencil** next to the account. This opens
     the SiteWorx Account Management form

#. To select the Default PHP Version for the SiteWorx account (if different from the default set on 
   the Webserver page), select the **PHP version** from the PHP Versions dropdown
   under PHP Options
#. To select and PHP versions that the SiteWorx account should have the ability to use, other than the
   default, under Available PHP Versions, select the **checkbox** next to all PHP versions that
   apply

   - To select all versions, click **check all**

#. Click **Save**

 .. image:: /images/sw-php-options.png
   :alt: php options