CloudLinux PHP Selector

Summary

Cloudlinux has added their support in PHP Selector to work with lsphp in LiteSpeed Web server. It leverages the same PHP Selector GUI so that user can switch between different lsphp versions in LiteSpeed Web Server without going to LiteSpeed Admin Console to build LSPHP separately.

In brief, Cloudlinux' PHP Selector, LVE Manager and CageFS need to be installed and enabled; LSWS' lsphp5 external app needs to be in suEXEC non-daemon mode (for example, suEXEC worker mode or suEXEC Process Group mode. suEXEC daemon mode is incompatible with PHP Selector) with lsphp5 binary being set to a symlink that eventually points to the actual PHP binary of user's choice in CageFS.

You can also check Cloudlinux PHP Selector and Cloudlinux PHP Selector LiteSpeed Support documentation.

You can still use other php configuration such as LiteSpeed lsphp, cpanel easy apache php or plesk php instead of PHP Selector even on a CloudLinux Box if you like, however PHP selector is a recommended way.

Installation

Followings need to be installed and/or enabled. If They have been installed and enabled, you can skip to next step for LiteSpeed configuration.

  1. LVE Manager
  2. CageFS
  3. PHP Selector

a. Install alt-php packages from CloudLinux repository

  yum groupinstall alt-php

b. Update CageFS and LVE Manager RPMs from CloudLinux

  yum update cagefs lvemanager 

c. Changes to /etc/pam.d/su

Make sure the following entries are appended to file /etc/pam.d/su. It should be added when CageFS is installed. Just manually add them if not.

  session    required     pam_sulve.so
  session    required     pam_lve.so      100     1

d. Verify

Enter into user's CageFS as root

  cagefsctl -e username

In user's cagefs, verify PHP version:

/usr/local/bin/lsphp -i | more

/usr/local/bin/lsphp should be a symlink to a php version specified by System Admin or user.

For example:

  lstestc@cptest [~]# ls -l /usr/local/bin/lsphp
  lrwxrwxrwx 1 root root 22 Mar 14 19:15 /usr/local/bin/lsphp -> /etc/cl.selector/lsphp*
  lstestc@cptest [~]# ls -l /etc/cl.selector/lsphp 
  lrwxrwxrwx 1 lstestc lstestc 28 Mar 15 13:23 /etc/cl.selector/lsphp -> /opt/alt/php53/usr/bin/lsphp*
  lstestc@cptest [~]#

Please also refer to CloudLinux document for installation details.

LiteSpeed Web Server Setting

Configure php selector in LiteSpeed Web Server setting to enable it for LSWS:

  1. Enable CloudLinux CageFS support (Admin Console ⇒ Configuration ⇒ Server ⇒ General ⇒ Cloud-Linux, select applicable option, e.g., CageFS
  2. Enable PHP suEXEC ( Admin Console ⇒ Configuration ⇒ Using Apache Configuration File ⇒ PHP suEXEC, set to Yes
  3. LSPHP5 external app runs in suEXEC non-daemon mode ONLY (Run On Start Up ⇒ Yes or No). Check here for suEXEC worker mode or suEXEC process group mode setup.
  4. In lsphp5 external app (Admin Console ⇒ Configuration ⇒ Server ⇒ External App ⇒ lsphp5),

Change

command => $SERVER_ROOT/fcgi-bin/lsphp5 

To

command => /usr/local/bin/lsphp

See screenshot below:

LSWS LSPHP5 setting

Notes: In order to use PHP Selector and custom php.ini, lsphp5 needs to be in suEXEC NON-daemon mode( for example, suEXEC worker mode or suEXEC process group mode). As explained in this blog, php.ini can not be overridden in suEXEC daemon mode.

Admin Console ⇒ Configuration ⇒ Server ⇒ External App ⇒ lsphp5

Run On Start Up => Yes or No

You can also check Cloudlinux PHP Selector LiteSpeed Support documentation.

 
litespeed_wiki/cloudlinux/php-selector.txt · Last modified: 2017/04/21 12:55 by Michael Alegre