OpenLiteSpeed Wiki OpenLiteSpeed Wiki

Fast CGI (FCGI) SAPI is supported in OpenLiteSpeed as a a way to communicate with PHP external applications. Our tests show LSAPI to be a faster method of communicating with PHP external applications. Some people, though, may still be interested in building PHP with FCGI SAPI. Here we provide the procedure for doing so.

FCGI SAPI external applications can be set up at either the server level or the virtual host level. Server-level external applications can be shared by all virtual hosts.

Download the PHP source package

For this guide, we will download the latest PHP (5.5.0) package. This can be done from either your browser or the command line.

You can put the PHP package anywhere you like. We recommend using the $SERVER_ROOT/phpbuild directory for ease of use.

 [root@localhost phpbuild]# wget http://us1.php.net/distributions/php-5.5.0.tar.bz2 
 --2013-07-16 06:28:22--  http://us1.php.net/distributions/php-5.5.0.tar.bz2
 Resolving us1.php.net... 208.69.120.58
 Connecting to us1.php.net|208.69.120.58|:80... connected.
 HTTP request sent, awaiting response... 200 OK
 Length: 12256814 (12M) [application/octet-stream]
 Saving to: `php-5.5.0.tar.bz2'
 
 100%[=================================================>] 12,256,814  6.33M/s   in 1.8s    
 
 2013-07-16 06:28:24 (6.33 MB/s) - `php-5.5.0.tar.bz2' saved [12256814/12256814]
 
 [root@localhost phpbuild]#

Unpack the PHP package

  [root@localhost phpbuild]# tar jxf php-5.5.0.tar.bz2
  [root@localhost phpbuild]# cd php-5.5.0
  [root@localhost php-5.5.0]#

Compile PHP

Compile PHP with FCGI related options:

(Again, the prefix we are using, $SERVER_ROOT/fcgiphp5, is not required. The PHP build can be installed anywhere that OpenLiteSpeed will have access to it. This just seemed the easiest place to put it.)

  [root@localhost php-5.5.0]#  ./configure  --prefix=/usr/local/lsws/fcgiphp5 --with-mysqli --with-zlib \
     --with-gd --enable-shmop --enable-sockets --enable-sysvsem --enable-sysvshm \
     --enable-mbstring --with-iconv
  [root@localhost php-5.5.0]#  make && make install

Create an FCGI SAPI external application

(WebAdmin console => Configuration => Server => External App => Add => Type="FCGI")

Error creating thumbnail: File missing

You must set the Command setting to the location of your PHP binary.

Other settings to pay attention to include Memory Limit (soft/hard), Process Limit (soft/hard), Back Log, and Instances. Suggestions for settings values can be found in the screenshot below:

Error creating thumbnail: File missing

Create a script handler to map files to the FCGI external application

(WebAdmin console => Configuration => Server => Script Handler => Add)

A script handler will tell OpenLiteSpeed which files (generally those with the suffix .php) to send to the Fast CGI external application just created.

Verify

Point your browser to your phpinfo page to check your PHP settings. Under Server API, it should say "CGI/FastCGI"