mirror of
https://github.com/sigmasternchen/php-doc-en
synced 2025-03-15 16:38:54 +00:00
445962cfde
<informalexample> doesn't require title and therefore unclutters Example Index git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@341083 c90b9560-bf6c-de11-be94-00142212c4b1
269 lines
7.5 KiB
XML
269 lines
7.5 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<sect1 xml:id="install.unix.litespeed" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<title>LiteSpeed Web Server/OpenLiteSpeed Web Server on Unix systems</title>
|
|
|
|
<para>
|
|
LiteSpeed PHP is an optimized compilation of PHP built to work with LiteSpeed
|
|
products through the LiteSpeed SAPI. LSPHP runs as its own process and has
|
|
its own standalone binary, which can be used as a simple command line binary to execute
|
|
PHP scripts from the command line.
|
|
</para>
|
|
|
|
<para>
|
|
The LSAPI is a highly optimized API that allows communication between
|
|
LiteSpeed and third party web engines. Its protocol is similar to FCGI, but is
|
|
more efficient.
|
|
</para>
|
|
|
|
<para>
|
|
This documentation will cover installing and configuring PHP with LSAPI
|
|
for a LiteSpeed Web Server and OpenLiteSpeed Web Server.
|
|
</para>
|
|
|
|
<para>
|
|
This guide will assume that either LSWS or OLS is installed with their
|
|
default paths and flags. The default installation directory for both web
|
|
servers is /usr/local/lsws and both can be run from the bin subdirectory.
|
|
</para>
|
|
|
|
<para>
|
|
Please note that throughout this documentation, version numbers have been
|
|
replaced with an <literal>x</literal> to ensure this documentation stays correct in the future,
|
|
please replace these, as necessary, with the corresponding version numbers.
|
|
</para>
|
|
|
|
<orderedlist>
|
|
<listitem>
|
|
<para>
|
|
To obtain and install either LiteSpeed Web Server or OpenLiteSpeed Web Server, visit the
|
|
LiteSpeed Web Server wiki
|
|
<link xlink:href="https://www.litespeedtech.com/support/wiki/doku.php/litespeed_wiki:installation">install page</link>
|
|
or OpenLiteSpeed wiki
|
|
<link xlink:href="http://open.litespeedtech.com/mediawiki/index.php/Help:Install">install page</link>.
|
|
</para>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
Obtain and unpack the php source:
|
|
</para>
|
|
|
|
<informalexample xml:id="install.unix.litespeed.extract.php">
|
|
<screen>
|
|
<![CDATA[
|
|
mkdir /home/php
|
|
cd /home/php
|
|
wget http://us1.php.net/get/php-x.x.x.tar.gz/from/this/mirror
|
|
tar -zxvf php-x.x.x.tar.gz
|
|
cd php-x.x.x
|
|
]]>
|
|
</screen>
|
|
</informalexample>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
Configure and build PHP. This is where PHP can be customized with various options,
|
|
such as which extensions will be enabled. Run ./configure --help for a list of available
|
|
options. In the example, we'll use the default recommended configuration options for
|
|
LiteSpeed Web Server:
|
|
</para>
|
|
|
|
<informalexample xml:id="install.unix.litespeed.build.php">
|
|
<screen>
|
|
<![CDATA[
|
|
./configure ... '--with-litespeed'
|
|
make
|
|
sudo make install
|
|
]]>
|
|
</screen>
|
|
</informalexample>
|
|
</listitem>
|
|
|
|
<listitem>
|
|
<para>
|
|
Checking The LSPHP Installation
|
|
</para>
|
|
|
|
<para>
|
|
One of the simplest ways to check whether the installation of PHP was successful
|
|
is to run the following code:
|
|
</para>
|
|
|
|
<informalexample>
|
|
<screen>
|
|
<![CDATA[
|
|
cd /usr/local/lsws/fcgi-bin/
|
|
./lsphp5 -v
|
|
]]>
|
|
</screen>
|
|
</informalexample>
|
|
|
|
<para>
|
|
This should return information about the new PHP build:
|
|
</para>
|
|
|
|
<informalexample>
|
|
<screen>
|
|
<![CDATA[
|
|
PHP 5.6.17 (litespeed) (built: Mar 22 2016 11:34:19)
|
|
Copyright (c) 1997-2014 The PHP Group
|
|
Zend Engine v2.6.0, Copyright (c) 1998-2015 Zend Technologies
|
|
]]>
|
|
</screen>
|
|
</informalexample>
|
|
|
|
<para>
|
|
Notice the <literal>litespeed</literal> in parenthesis. This means that the PHP binary has been
|
|
built with LSAPI support.
|
|
</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
|
|
<para>
|
|
Following the steps above, LiteSpeed / OpenLiteSpeed Web Server should
|
|
now be running with support for PHP as an SAPI extension. There are many more
|
|
configuration options available for LSWS / OLS and PHP. For more information,
|
|
check out the LiteSpeed wiki about
|
|
<link xlink:href="https://www.litespeedtech.com/support/wiki/doku.php/litespeed_wiki:php">PHP</link>.
|
|
</para>
|
|
|
|
<para>
|
|
Using LSPHP from the command line:
|
|
</para>
|
|
|
|
<para>
|
|
LSPHP(LSAPI + PHP) command line mode is used to process PHP scripts running
|
|
on a remote server that does not necessarily have a web server running. It is used
|
|
to process PHP scripts residing on a local web server (separate). This setup is
|
|
suitable for service scalability as PHP processing is offloaded to a remote server.
|
|
</para>
|
|
|
|
<para>
|
|
Start lsphp from the command line on a remote server:
|
|
LSPHP is an executable and can be started manually and bound to IPv4, IPv6, or
|
|
Unix domain socket addresses with the command line option -b socket_address
|
|
</para>
|
|
|
|
<para>
|
|
Examples:
|
|
</para>
|
|
|
|
<para>
|
|
Have LSPHP bind to port 3000 on all IPv4 and IPv6 addresses:
|
|
</para>
|
|
|
|
<informalexample>
|
|
<screen>
|
|
<![CDATA[
|
|
/path/to/lsphp -b [::]:3000
|
|
]]>
|
|
</screen>
|
|
</informalexample>
|
|
|
|
<para>
|
|
Have LSPHP bind to port 3000 on all IPv4 addresses:
|
|
</para>
|
|
|
|
<informalexample>
|
|
<screen>
|
|
<![CDATA[
|
|
/path/to/lsphp -b *:3000
|
|
]]>
|
|
</screen>
|
|
</informalexample>
|
|
|
|
<para>
|
|
Have LSPHP bind to address 192.168.0.2:3000:
|
|
</para>
|
|
|
|
<informalexample>
|
|
<screen>
|
|
<![CDATA[
|
|
/path/to/lsphp -b 192.168.0.2:3000
|
|
]]>
|
|
</screen>
|
|
</informalexample>
|
|
|
|
<para>
|
|
Have LSPHP accept requests on Unix domain socket <literal>/tmp/lsphp_manual.sock</literal>:
|
|
</para>
|
|
|
|
<informalexample>
|
|
<screen>
|
|
<![CDATA[
|
|
/path/to/lsphp -b /tmp/lsphp_manual.sock
|
|
]]>
|
|
</screen>
|
|
</informalexample>
|
|
|
|
<para>
|
|
Environment variables can be added before the LSPHP executable:
|
|
</para>
|
|
|
|
<informalexample>
|
|
<screen>
|
|
<![CDATA[
|
|
PHP_LSAPI_MAX_REQUESTS=500 PHP_LSAPI_CHILDREN=35 /path/to/lsphp -b IP_address:port
|
|
]]>
|
|
</screen>
|
|
</informalexample>
|
|
|
|
<para>
|
|
Currently LiteSpeed PHP can be used with LiteSpeed Web Server,
|
|
OpenLiteSpeed Web Server, and Apache mod_lsapi. For steps on
|
|
server-side configuration, visit the wiki pages for
|
|
<link xlink:href="https://www.litespeedtech.com/support/wiki/doku.php/litespeed_wiki:php:configuring-lsws-for-php">LiteSpeed Web Server</link>
|
|
and <link xlink:href="http://open.litespeedtech.com/mediawiki/index.php/Help:Default_PHP_Settings">OpenLiteSpeed</link>.
|
|
</para>
|
|
|
|
<para>
|
|
LSPHP can be installed in several other ways as well.
|
|
</para>
|
|
|
|
<para>
|
|
CentOS:
|
|
On CentOS, LSPHP can be installed from the LiteSpeed Repository or the Remi
|
|
Repository using <link xlink:href="https://www.litespeedtech.com/support/wiki/doku.php/litespeed_wiki:php:rpm">RPM</link>.
|
|
</para>
|
|
|
|
<para>
|
|
Debian:
|
|
On Debian, LSPHP can be installed from the LiteSpeed Repository using
|
|
<link xlink:href="https://www.litespeedtech.com/support/wiki/doku.php/litespeed_wiki:php:apt">apt</link>.
|
|
</para>
|
|
|
|
<para>
|
|
cPanel:
|
|
Visit the respective <link xlink:href="https://www.litespeedtech.com/support/wiki/doku.php/litespeed_wiki:cpanel:easyapache4-config">wiki page</link>
|
|
about how to install LSPHP with cPanel and LSWS/OLS using EasyApache 4.
|
|
</para>
|
|
|
|
<para>
|
|
Plesk:
|
|
Plesk can be used with LSPHP on CentOS, CloudLinux, Debian, and Ubuntu,
|
|
for more details on this, visit the respective <link xlink:href="https://www.litespeedtech.com/support/wiki/doku.php/litespeed_wiki:plesk:php_guide">wiki page</link>
|
|
</para>
|
|
</sect1>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|