How to change PHP version for webmail in Plesk for Linux

Question

How to change PHP version for webmail in Plesk for Linux?

Answer

Note: In Plesk Obsidian, webmail uses PHP 7.4 that comes with Plesk.

Note: Starting from Plesk Obsidian 18.0.39 it is impossible to have webmail without PHP 7.4 even if webmail does not actually use PHP 7.4 (a customized PHP version is used instead). If PHP 7.4 is removed from Tools & Settings > Updates > Add/Remove Components, Plesk Installer will provide a warning that it will remove webmails alongside with PHP 7.4 by dependencies.

1. Connect to a Plesk server via SSH.

2. Create a directory for custom configuration templates:

   # mkdir -p /usr/local/psa/admin/conf/templates/custom/webmail

3. Copy the original files roundcube.php and horde.php to the created directory:

   • Roundcube:

     # cp /usr/local/psa/admin/conf/templates/default/webmail/roundcube.php /usr/local/psa/admin/conf/templates/custom/webmail/

   • Horde:

     # cp /usr/local/psa/admin/conf/templates/default/webmail/horde.php /usr/local/psa/admin/conf/templates/custom/webmail/

4. Run the command below to list all available PHP versions. If a required PHP version is not listed, install it using the steps from this KB article.

   # plesk bin php_handler --list | grep fastcgi
   
   id:                    display name:
   
   fastcgi                5.4.16 by OS vendor
   plesk-php72-fastcgi    7.2.23
   plesk-php73-fastcgi    7.3.10

5. Modify the configuration file of Roundcube:

   5.1. Open the roundcube.php file in a text editor. In this example, we are using the vi editor:

   # vi /usr/local/psa/admin/conf/templates/custom/webmail/roundcube.php

   5.2. Change the PHP handler from 'fastcgi' to any other id from step 4. In this example, we are setting PHP version 7.2:

   • Before

     CONFIG_TEXT: FcgidInitialEnv PP_CUSTOM_PHP_CGI_INDEX fastcgi

   • After

     CONFIG_TEXT: FcgidInitialEnv PP_CUSTOM_PHP_CGI_INDEX plesk-php73-fastcgi

   5.3. Save the changes and close the file.

6. Modify the configuration file of Horde:

   6.1. Open the horde.php file in a text editor:

   # vi /usr/local/psa/admin/conf/templates/custom/webmail/horde.php

   6.2. Change the PHP handler from 'fastcgi' to any other id from step 4. In this example, we are setting PHP version 7.2:

   • Before

     CONFIG_TEXT: FcgidInitialEnv PP_CUSTOM_PHP_CGI_INDEX fastcgi

   • After

     CONFIG_TEXT: FcgidInitialEnv PP_CUSTOM_PHP_CGI_INDEX plesk-php73-fastcgi

   6.3. Save the changes and close the file.

7. Regenerate configuration files to apply the changes:

   # plesk repair web -server