PHP Extensions¶

• cPanel: EasyApache 4
• Plesk: PHP Settings
• CloudLinux: PHP Selector
• DirectAdmin: CustomBuild 2.0

PECL¶

Overview¶

PECL is a repository for PHP extensions, providing a directory of all known extensions and hosting facilities for downloading and developing PHP extensions. You may need a certain PHP PECL extension to get the application working. This guide explains how to install PECL extensions for native LSWS installs. For cPanel installs please refer to this ‘PHP PECL’ article.

There are several ways to get a PHP PECL extension installed:

1. LiteSpeed Repository
2. The PEAR Package Manager
3. Source Code

Install¶

LiteSpeed Repository¶

We offer some of the more popular PECL extensions right in our own CentOS or Debian/Ubuntu repositories.

The extensions we currently offer are:

• APCu
• Igbinary
• Imagick
• Memcached
• Msgpack
• Redis

If the extension is not in our repository, you can send a request to support@litespeedtech.com requesting its inclusion and we will evaluate the possibility of adding it.

To install a PECL extension via a repository, type one the following commands into a terminal, depending on your distribution:

$ sudo yum install lsphpXX-pecl-PECL_NAME

$ sudo dnf install lsphpXX-pecl-PECL_NAME

$ sudo apt install lsphpXX-PECL_NAME

Once completed, please skip ahead to the Finish section.

The PEAR Package Manager¶

Another way to install a PECL extension is by using PECL, which is supplied by PEAR.

Install PEAR/PECL by running one of the following inside of a terminal:

$ sudo yum install lsphpXX-pear

$ sudo dnf install lsphpXX-pear

$ sudo apt install lsphpXX-pear

$ sudo cd /usr/local/lsws/lsphpXX/bin
$ wget http://pear.php.net/go-pear.phar
$ sudo ./php go-pear.phar
$ sed -i -e 's/-C -n/-C/g' ./pecl

Install/Set up the necessary PECL extension by running the following commands inside of a terminal:

$ sudo /usr/local/lsws/lsphpXX/bin/pecl install PECL_NAME

Once completed, please skip ahead to the Configure section.

Source Code¶

The PECL extensions can also be compiled and installed from source code.

In the following examples we will install the PECL extension, Imagick, for LSPHPXX. We will install the necessary packages first, and then do the compilation.

Type the following code blocks for your specific distribution into the terminal in order to install the necessary build packages:

$ sudo yum install epel-release # Installs the Extra Packages for Enterprise Linux Repo
$ sudo yum install gcc gcc-c++ make autoconf glibc rcs # Installs compilation needed packages
$ sudo yum install lsphpXX-devel # Installs the LSPHP devel package
$ sudo yum install ImageMagick-devel  # Installs the ImageMagick-devel package

$ sudo dnf install epel-release # Installs the Extra Packages for Enterprise Linux Repo
$ sudo dnf install gcc gcc-c++ make autoconf glibc rcs # Installs compilation needed packages
$ sudo dnf install lsphpXX-devel # Installs the LSPHP devel package
$ sudo dnf install ImageMagick-devel  # Installs the ImageMagick-devel package

$ sudo apt-get install libmagickwand-dev pkg-config build-essential # Installs compilation needed packages
$ sudo apt-get install lsphpXX-dev # Installs the LSPHP dev package

After the build packages are installed the next step is to compile Imagick. Run the following into a terminal:

$ wget https://pecl.php.net/get/imagick-3.7.0.tgz
$ tar -zxvf imagick-3.7.0.tgz
$ cd imagick-3.7.0
$ sudo /usr/local/lsws/lsphpXX/bin/phpize
$ ./configure --with-imagick=/usr/local/lsws/lsphpXX --with-php-config=/usr/local/lsws/lsphpXX/bin/php-config
$ make
$ sudo make install

Once completed, please skip ahead to the Configure section.

Configure¶

The imagick extension is now installed to the following directories:

Installing shared extensions:     /usr/local/lsws/lsphpXX/lib64/php/modules/
Installing header files:          /usr/local/lsws/lsphpXX/include/php/

Installing shared extensions:     /usr/local/lsws/lsphpXX/lib/php/XXXXXXXX/
Installing header files:          /usr/local/lsws/lsphpXX/include/php/

Next, load the PECL extension via a .ini file.

$ sudo echo "extension=imagick.so" >> /usr/local/lsws/lsphpXX/etc/php.d/40-imagick.ini

$ sudo echo "extension=imagick.so" >> /usr/local/lsws/lsphpXX/etc/php/X.X/mods-available/40-imagick.ini

Finish¶

Once everything is installed and loaded, restart PHP and the web server.

$ sudo touch /usr/local/lsws/admin/tmp/.lsphp_restart.txt  
$ sudo systemctl restart lsws

When checking a phpinfo.php page it should now show the PECL extension, Imagick, as enabled.

cURL¶

How to Compile the cURL PHP Extension

Sometimes the lsphp-curl package does not contain the latest cURL. If this is the case, you can manually compile the cURL extension with the latest version.

The PHPinfo page in the screenshot above reveals the currently installed cURL version is 7.29.0, but certain applications may require a higher version in order to work properly.

Install the Latest cURL¶

Run the following commands:

rpm -ivh http://www.city-fan.org/ftp/contrib/yum-repo/city-fan.org-release-3-6.rhel7.noarch.rpm
yum-config-manager --enable city-fan.org
yum clean all
yum update

Check the cURL Version¶

Run the following command:

curl -V

You should see output similar to this:

curl 7.69.1 (x86_64-redhat-linux-gnu) libcurl/7.69.1 NSS/3.44 zlib/1.2.7 libpsl/0.7.0 (+libicu/50.1.2) libssh2/1.9.0 nghttp2/1.31.1
Release-Date: 2020-03-11
Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 pop3s rtsp scp sftp smb smbs smtp smtps telnet tftp 
Features: AsynchDNS GSS-API HTTP2 HTTPS-proxy IPv6 Kerberos Largefile libz Metalink NTLM NTLM_WB PSL SPNEGO SSL UnixSockets

Download the PHP Source Code¶

In this example, we use PHP 7.4 and compile the extension from source:

wget https://www.php.net/distributions/php-7.4.33.tar.gz
tar xzvf php-7.4.33.tar.gz
cd php-7.4.33/ext/curl
/usr/local/lsws/lsphp74/bin/phpize
./configure --with-php-config=/usr/local/lsws/lsphp74/bin/php-config --with-curl=/usr/bin
make
make install

Restart and Verify¶

Restart LSPHP with the pkill lsphp command, if necessary, and check the PHPinfo page again.

In this example, the screenshot shows cURL version 7.69.1 is installed.

GD¶

Sometimes the lsphp-gd package is not up-to-date, in which case it may be missing some features, like WebP support. If this happens, you can manually compile the GD extension to include the new features.

Install Dependencies¶

Run the following command:

yum install -y lsphp73-devel gcc libjpeg-turbo-devel libpng-devel libXpm-devel freetype-devel libwebp-devel

Download the PHP Source Code¶

In this example we'll use lsphp73. Please change it to another appropriate PHP version number if necessary. Run the following commands:

wget https://www.php.net/distributions/php-7.3.12.tar.gz
tar xzvf php-7.3.12.tar.gz
cd php-7.3.12
cd ext
cd gd
/usr/local/lsws/lsphp73/bin/phpize
./configure --with-php-config=/usr/local/lsws/lsphp73/bin/php-config --with-webp-dir=/usr/include/webp --with-freetype-dir=/usr/include/freetype2/freetype --with-jpeg-dir=/usr/include --with-png-dir=/usr/include --with-xpm-dir=/usr/include
make
make install

Restart and Verify¶

Restart LSPHP if necessary, and check the PHPinfo page to verify that WebP Support is enabled.

Imagick¶

Sometimes the lsphp-imagick package does not contain the latest features. If this is the case, you can manually compile the extension to the latest version.

Compile libwebp¶

Run the following commands:

yum install libjpeg-devel libpng-devel libtiff-devel giflib-devel
wget https://storage.googleapis.com/downloads.webmproject.org/releases/webp/libwebp-1.1.0.tar.gz
tar xzvf libwebp-1.1.0.tar.gz
cd libwebp-1.1.0
./configure
make
make install

Compile Imagick with WebP Support¶

Run the following commands:

wget https://imagemagick.org/download/ImageMagick.tar.gz
tar xzvf ImageMagick.tar.gz
cd ImageMagick*
./configure --with-webp=yes
make
make install

Compile PHP Extension¶

As Imagick requires a lot of dependencies, use the following commands to install it, and then upgrade it:

yum install lsphp73-imagick
wget http://pecl.php.net/get/imagick
tar xzvf imagick
cd imagick-*
/usr/local/lsws/lsphp73/bin/phpize
./configure --with-php-config=/usr/local/lsws/lsphp73/bin/php-config
make
make install

Restart the LSPHP process if necessary.

Ioncube¶

ionCube Loader is sometimes needed when using encoded and secure PHP files. This section will show you how to enable it for LSPHP.

Repository¶

To install ionCube via the repository run the following in a command prompt:

$ sudo yum install lsphpXX-ioncube

$ sudo dnf install lsphpXX-ioncube

$ sudo apt install lsphpXX-ioncube

Manual¶

1. Download ionCube by running:

   $ wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz
   

2. Extract the package by running:

   $ tar -xf ioncube_loaders_lin_x86-64.tar.gz
   

3. Move the needed .so file by running:

   CentOSDebian/Ubuntu

   $ sudo cp ioncube/ioncube_loader_lin_X.X.so /usr/local/lsws/lsphpXX/lib64/php/modules/ioncube.so
   

   $ sudo cp ioncube/ioncube_loader_lin_X.X.so /usr/local/lsws/lsphpXX/lib/php/XXXXXXXX/ioncube.so
   

4. Now, enable the extension by running:

   CentOSDebian/Ubuntu

   $ sudo echo "extension=ioncube.so" >> /usr/local/lsws/lsphpXX/etc/php.d/01-imagick.ini
   

   $ sudo echo "extension=ioncube.so" >> /usr/local/lsws/lsphpXX/etc/php/X.X/mods-available/01-imagick.ini
   

5. Restart PHP in order for the changes to take affect.

   $ sudo touch /usr/local/lsws/admin/tmp/.lsphp_restart.txt  
   $ sudo systemctl restart lsws