Set up OLS with Multi PHP versions

How Can We Help?
< Back
You are here:

Multiple PHP Versions on OpenLiteSpeed

Users may want to setup multi-PHP versions and use a different version for different virtual host/domain.

This wiki will address setting up multiple PHPs for one installation of OpenLiteSpeed. The wiki assumes you have our repository installed and enabled and that PHP is being downloaded from this repository. Multiple PHPs can just as easily be set up when PHP has been built from source, though. This wiki demonstrates installing different versions of PHP. Alternately, you can install the same version of PHP with different options. This wiki uses the WebAdmin console where possible.

Multi-PHP versions will be configurated to different external apps, while the script handler section will define which version to be used.

Install Multiple PHPs

yum groupinstall lsphp-all

The above command installs all available versions of PHP (5.3, 5.4, 5.5, 5.6, 7.0, 7.1, 7.2, 7.2, 7.3).

These PHP builds are installed to the following locations based on version number:


Define External Applications for These PHPs

We will go through creating an external application for PHP 5.6. However, you can also use the default external applications with some modification.

Add an external application (in the WebAdmin console > Server Configuration > External App > Add).

Choose LSAPI for the application type.

Give the new external application an appropriate name, address, maximum number of connections, initial response timeout, and retry timeout.


The most important setting is the Command setting. This tells the external application where to look for the PHP it will use. Direct it to one of your PHP installations.

Set up Script Handlers

Script handlers will tell OpenLiteSpeed which scripts should go to which external application. There are many ways to configure this. You can, for example, stipulate that different external applications should be responsible for different suffixes. We will be setting up a script handler at the virtual host level to tell OpenLiteSpeed that our new lsphp54 external application will be serving .php scripts in this virtual host. As a result, this will override any server-level script handler settings. Use context-level settings to override server- or virtual host-level settings.

Add a virtual host-level script handler (WebAdmin console > Server Configuration > Virtual Hosts > Example > Script Handlers > Add).




Choose the suffix this script handler will handle, make the Handler Type LiteSpeed SAPI, and direct it toward the external application you just created.

Graceful restart to save your changes.


OpenLiteSpeed will now serve .php scripts in the virtual host with PHP 5.6. You can repeat these processes for any other PHP builds you’d like to support.