When running LiteSpeed as the web server on a Plesk-based Linux environment, users may encounter issues with Roundcube webmail failing to load due to an unsupported PHP version error. The error typically states:
"Required PHP >= 7.3"This issue arises because LiteSpeed, in some configurations, ignores Plesk’s PHP settings for webmail and defaults to its bundled LSPHP version, which may be as old as LSPHP 5.6. Consequently, Roundcube, which requires PHP 7.3 or higher, fails to function.
Diagnosing the Issue
Attempts to change the PHP version for Roundcube webmail through Plesk’s settings often prove ineffective. This issue arises because the LiteSpeed configuration does not honor Plesk’s PHP settings for webmail applications. Despite configuring a newer PHP version within Plesk, LiteSpeed continues to use its default, outdated LSPHP binary for webmail, leading to compatibility issues. As a result, Roundcube webmail fails to function correctly with LiteSpeed installed on Plesk, displaying an error that states: “Unsupported PHP version. Required PHP >= 7.3.” This mismatch occurs because LiteSpeed overrides the PHP version required by Roundcube, necessitating manual adjustments to the LiteSpeed settings or the server’s webmail configuration to ensure that Roundcube can access the correct PHP version. Failure to align the PHP version with Roundcube’s requirements can cause persistent errors and prevent users from accessing their webmail until the correct PHP version is applied.
Resolution Steps
To resolve the issue, you need to replace the default LSPHP binary with a symlink to a more recent version of LSPHP installed on the server. Follow these steps:
1. Backup the existing LSPHP binary:
mv /usr/local/bin/lsphp /usr/local/bin/lsphp-bk2. Create a symlink to the newer LSPHP version:
ln -s /opt/plesk/php/8.2/bin/lsphp /usr/local/bin/lsphpReplace /opt/plesk/php/8.2/bin/lsphp with the path to the desired PHP version installed on your server.
Conclusion
This workaround forces LiteSpeed to use a PHP version compatible with Roundcube, effectively resolving the unsupported PHP version error. This approach ensures webmail functionality without compromising the LiteSpeed performance benefits.
If you’re experiencing issues with Roundcube webmail failing to function due to an unsupported PHP version error when using LiteSpeed on Plesk, we can help. Our team specializes in resolving PHP version conflicts and ensuring seamless compatibility between webmail applications and server configurations. Don’t let PHP errors disrupt your email services—contact us today for expert support and a quick resolution to get your Roundcube webmail up and running smoothly.
