diff --git a/install/unix/litespeed.xml b/install/unix/litespeed.xml new file mode 100644 index 0000000..fe5eaf0 --- /dev/null +++ b/install/unix/litespeed.xml @@ -0,0 +1,270 @@ + + + + + LiteSpeed Web Server/OpenLiteSpeed Web Server on Unix systems + + + 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. + + + + 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. + + + + This documentation will cover installing and configuring PHP with LSAPI + for a LiteSpeed Web Server and OpenLiteSpeed Web Server. + + + + 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. + + + + Please note that throughout this documentation, version numbers have been + replaced with an x to ensure this documentation stays correct in the future, + please replace these, as necessary, with the corresponding version numbers. + + + + + + To obtain and install either LiteSpeed Web Server or OpenLiteSpeed Web Server, visit the + LiteSpeed Web Server documentation + install page + or OpenLiteSpeed documentation + install page. + + + + + + Obtain and unpack the php source: + + + + + + + + + + + + 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: + + + + + + + + + + + + Checking The LSPHP Installation + + + + One of the simplest ways to check whether the installation of PHP was successful + is to run the following code: + + + + + + + + + + This should return information about the new PHP build: + + + + + + + + + + Notice the litespeed in parenthesis. This means that the PHP binary has been + built with LSAPI support. + + + + + + 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 documentation about + PHP. + + + + Using LSPHP from the command line: + + + + 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. + + + + 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 + + + + Examples: + + + + Have LSPHP bind to port 3000 on all IPv4 and IPv6 addresses: + + + + + + + + + + Have LSPHP bind to port 3000 on all IPv4 addresses: + + + + + + + + + + Have LSPHP bind to address 192.168.0.2:3000: + + + + + + + + + + Have LSPHP accept requests on Unix domain socket /tmp/lsphp_manual.sock: + + + + + + + + + + Environment variables can be added before the LSPHP executable: + + + + + + + + + + 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 documentation pages for + LiteSpeed Web Server + and OpenLiteSpeed. + + + + LSPHP can be installed in several other ways as well. + + + + CentOS: + On CentOS, LSPHP can be installed from the LiteSpeed Repository or the Remi + Repository using RPM. + + + + Debian: + On Debian, LSPHP can be installed from the LiteSpeed Repository using + apt. + + + + cPanel: + Visit the respective documentation page + about how to install LSPHP with cPanel and LSWS/OLS using EasyApache 4. + + + + Plesk: + Plesk can be used with LSPHP on CentOS, CloudLinux, Debian, and Ubuntu, + for more details on this, visit the respective documentation page + + + + diff --git a/install/unix/openbsd.xml b/install/unix/openbsd.xml new file mode 100644 index 0000000..f92513e --- /dev/null +++ b/install/unix/openbsd.xml @@ -0,0 +1,115 @@ + + + + + OpenBSD installation notes + + This section contains notes and hints specific to installing + PHP on OpenBSD. + + + Using Binary Packages + + Using binary packages to install PHP on OpenBSD is the recommended + and simplest method. The core package has been separated from the various + modules, and each can be installed and removed independently from the others. + The files you need can be found on your OpenBSD CD or on the FTP site. + + + The main package you need to install is php, + which contains the basic engine (plus fpm, gettext and iconv) and might be + available in several versions to choose from. Next, take a look + at the module packages, such as php-mysqli + or php-imap. You need to use the phpxs + command to activate and deactivate these modules in your &php.ini;. + + + OpenBSD Package Install Example + + + + + + Read the packages(7) + manual page for more information about binary packages on OpenBSD. + + + + Using Ports + + You can also compile up PHP from source using the ports tree. + However, this is only recommended for users familiar with OpenBSD. The PHP port + is split into core and extensions. The + extensions generate sub-packages for all of the supported + PHP modules. If you find you do not want to create some of these modules, + use the no_* FLAVOR. For example, to skip building + the imap module, set the FLAVOR to no_imap. + + + + Common Problems + + + Apache and Nginx are no longer the default server on OpenBSD, but they can both be easily + found in ports and packages. The new default server is also called 'httpd'. + + + + The default install of httpd runs inside a + chroot(2) jail, which will restrict PHP scripts to + accessing files under /var/www. You will therefore need to create a + /var/www/tmp directory for PHP session files to be stored, or use an + alternative session backend. In addition, database sockets need to be placed inside the + jail or listen on the localhost interface. If you use network functions, + some files from /etc such as /etc/resolv.conf and + /etc/services will need to be moved into /var/www/etc. + The OpenBSD PEAR package automatically installs into the correct chroot directories. + + + + + The OpenBSD package for the gd extension + requires Xorg to be installed. Unless already installed at base install by + adding the xbase.tgz file set, this can be added at + post-installation (see + OpenBSD FAQ#4). + + + + + + + diff --git a/install/unix/solaris.xml b/install/unix/solaris.xml new file mode 100644 index 0000000..773ae98 --- /dev/null +++ b/install/unix/solaris.xml @@ -0,0 +1,122 @@ + + + + + <productname>Solaris</productname> specific installation tips + + This section contains notes and hints specific to installing + PHP on Solaris systems. + + + Required software + + Solaris installs often lack C compilers and their related tools. + Read this FAQ + for information on why using GNU versions for some of these + tools is necessary. + + + For unpacking the PHP distribution you need + + + + tar + + + + + gzip or + + + + + bzip2 + + + + + + For compiling PHP you need + + + + gcc (recommended, other C compilers may work) + + + + + make + + + + + GNU sed + + + + + + For building extra extensions or hacking the code of PHP you might also need + + + + re2c + + + + + bison + + + + + m4 + + + + + autoconf + + + + + automake + + + + In addition, you will need to install (and possibly compile) any + additional software specific to your configuration, such as Oracle + or MySQL. + + + + Using Packages + + You can simplify the Solaris install process by using pkgadd to + install most of your needed components. The Image Packaging System (IPS) for + Solaris 11 Express also contains most of the required components + for installation using the pkg command. + + + + +