CloudLinux PHP Selector Howto

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 NON suEXEC 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 documentation.

CloudLinux:

Followings need to be installed and/or enabled:

1. PHP Selector
2. LVE Manager
3. CageFS

Refer to CloudLinux document for installation details and how to enable.

LiteSpeed Web Server:

1. Enable CloudLinux CageFS support (Admin Console ⇒ Configuration ⇒ Server ⇒ General ⇒ Cloud-Linux): CageFS
2. Enable PHP suEXEC ( Admin Console ⇒ Configuration ⇒ Using Apache Configuration File ⇒ PHP suEXEC): Yes
3. LSPHP5 external app runs in NON suEXEC daemon mode ONLY (Run On Start Up ⇒ Yes or No)

  yum groupinstall alt-php

  yum update cagefs lvemanager 

As of this writing (3/15/13), the correct package version should be:

  cagefs-4.0-14
  lvemanager-0.6-1

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

1. Enable cagefs for a user

  su - username 

or

  cagefsctl -e username

2. Select PHP 5.3 binary in PHP selector for illustration

3. In user's cagefs, /usr/local/bin/lsphp should be a symlink to php53 (since we pick 5.3 in step 2.)

  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 [~]#

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:

1. In order to use PHP Selector and custom php.ini, lsphp5 needs to be in NON suEXEC 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