Configuring Each Domain's PHP Version

For Enkompass 1.6 and 2.0

If you have already installed multiple versions of PHP on your Enkompass server, you can enable PHP for specific accounts. Then, the domain owner can choose which version to run on his or her website.

Server administrators: Enable PHP for all accounts (not recommended)

The Php Configuration screen in the Enkompass Server Administrator Interface provides the option of enabling PHP globally. You cannot disable PHP for specific accounts after you have enabled it globally.

Important: We do not recommend enabling PHP globally unless you are very experienced with PHP. Enabling PHP globally can introduce security risks.

If you understand how to secure PHP on your server, and you wish to enable it for all accounts:

1. Go to Web Server Settings > Php Configuration.
2. Select Enable PHP on all Web Servers.
3. Click Save.

Click to enable PHP on all your servers and domains.

Every account on all your servers now has access to PHP. You (or the domain owner) can now select the PHP version for each website.

Server administrators and resellers: Enable PHP for a specific account (recommended)

There are 2 points at which you can enable PHP for specific accounts on your server:

• During account creation (either by assigning an existing role that has PHP enabled, or by creating a custom role using the Create a New Account screen)
• After account creation (either by assigning an existing role that has PHP enabled, or by creating a custom role using the Manage Accounts screen)

Enabling PHP for new accounts

When you create an account using the Create a New Account screen, you can assign it a role that has PHP enabled.

If you have not yet created a role with PHP enabled, you can do so during account creation:

1. Go to Account Functions > Create a New Account.
2. Under WSO Role, select Custom(*).
   

   
   Select "Custom" to create a custom role.

   
   
3. In the Create a Role pop-up screen, type a role name in the text box, if you wish. (This will make it easier to assign the role to accounts later.)
4. From the Preferences drop-down menu, select Addins.
   

   
   Select "Addins" from the drop-down menu.

   
   
5. Select Php.
   

   
   Select "Php" to enable PHP for the account.

   
   
6. Click Save.

Now that you've created a custom role with PHP enabled, you can assign new accounts to this role during account creation. You can also assign this role to a plan, using the Edit a Plan screen.

Next, select the PHP version for each website.

Enabling PHP for existing accounts

If the account already exists, you can assign it a custom role with PHP enabled:

1. Go to Account Functions > Manage Accounts.
2. Find the account for which you wish to enable PHP, and click Role.
   • Note: If the Role icon is gray, the account is on a plan. You will not be able to modify the role from this screen. Instead, add a custom role to the account's plan via the Manage Plans screen.
     

     
     Select "Role" for the desired account.

     
     
3. On the Modify Account Role screen, click Create or use a custom role.
4. Click Php under All Addins.
   

   
   Select "Create or use a custom role" and "Php."

   
   
5. If you wish, enter a role name in the Role Name box. (This will make it easier to assign the role to accounts later.)
6. Click Apply Role.

Now that you've created a custom role with PHP enabled, you can assign new accounts to this role during account creation. You can also assign this role to a plan, using the Edit a Plan screen.

Next, select the PHP version for each website.

Domain owners: Select the PHP version

Once the server administrator has enabled PHP for an account, the domain owner will see a notice in the Notices section of the Web Site Owner interface (WSO) stating that a new version of PHP is available.

The PHP version notice appears in the Web Site Owner interface after the administrator enables PHP for the account.

The Php Version icon will also appear in the Advanced section. This feature allows you, as the domain owner, to choose the PHP version for each of your domains.

The "Php Version" icon appears in the "Advanced" section.

To choose the PHP version:

1. Select a domain from the Domain drop-down menu.
2. Select a PHP version from the Version drop-down menu.
3. Click Save.

Select the domain and PHP version from the drop-down menus.

Once you choose a new PHP version, the change is saved to the Enkompass database. IIS will read the change when it is not busy serving web pages. Depending on your server's load, this can delay the change. Typically, the upgrade takes between 4 and 25 minutes.

If the website runs on IP addresses served by many servers, then Enkompass will apply the PHP configuration to each web server.