From 5eae375f318bee8ffdefd0b7a0bb6be19cff8f1a Mon Sep 17 00:00:00 2001 From: Rich Bowen Date: Sat, 8 Aug 2026 00:53:50 +0000 Subject: [PATCH] use simpara for simple paragraphs Documentatio CI enforces the use of simpara rather than para for paragraphs containing only inline content. Converted 62 instances of para to simpara across install/unix/ where no block-level elements (examples, lists, etc.) are nested within to simplify future patches. --- install/unix/commandline.xml | 4 +- install/unix/lighttpd-14.xml | 28 ++++----- install/unix/litespeed.xml | 112 +++++++++++++++++------------------ install/unix/nginx.xml | 92 ++++++++++++++-------------- install/unix/openbsd.xml | 4 +- install/unix/solaris.xml | 8 +-- 6 files changed, 124 insertions(+), 124 deletions(-) diff --git a/install/unix/commandline.xml b/install/unix/commandline.xml index e3877021cd85..c532ac09b70d 100644 --- a/install/unix/commandline.xml +++ b/install/unix/commandline.xml @@ -2,14 +2,14 @@ CGI and command line setups - + By default, PHP is built as both a CLI and CGI program, which can be used for CGI processing. If you are running a web server that PHP has module support for, you should generally go for that solution for performance reasons. However, the CGI version enables users to run different PHP-enabled pages under different user-ids. - + &warn.install.cgi; diff --git a/install/unix/lighttpd-14.xml b/install/unix/lighttpd-14.xml index 1aaef16e5f82..8ffe291b7bae 100644 --- a/install/unix/lighttpd-14.xml +++ b/install/unix/lighttpd-14.xml @@ -3,29 +3,29 @@ Lighttpd 1.4 on Unix systems - + This section contains notes and hints specific to Lighttpd 1.4 installs of PHP on Unix systems. - + - + Please use the Lighttpd trac to learn how to install Lighttpd properly before continuing. - + - + FastCGI is the preferred SAPI to connect PHP and Lighttpd. FastCGI is automagically enabled in php-cgi. - + Letting Lighttpd spawn php processes - + To configure Lighttpd to connect to PHP and spawn FastCGI processes, edit lighttpd.conf. Sockets are preferred to connect to FastCGI processes on the local system. - + Partial lighttpd.conf @@ -68,22 +68,22 @@ fastcgi.server = ( ".php" => Spawning with spawn-fcgi - + Lighttpd provides a program called spawn-fcgi to make the process of spawning FastCGI processes easier. - + Spawning php-cgi - + It is possible to spawn processes without spawn-fcgi, though a bit of heavy-lifting is required. Setting the PHP_FCGI_CHILDREN environment var controls how many children PHP will spawn to handle incoming requests. Setting PHP_FCGI_MAX_REQUESTS will determine how long (in requests) each child will live. Here's a simple bash script to help spawn php responders. - + Spawning FastCGI Responders @@ -119,10 +119,10 @@ echo $! > "$PHP_PID" Connecting to remote FCGI instances - + FastCGI instances can be spawned on multiple remote machines in order to scale applications. - + Connecting to remote php-fastcgi instances diff --git a/install/unix/litespeed.xml b/install/unix/litespeed.xml index 2f97c5ab924b..8d3d6f6d3d88 100644 --- a/install/unix/litespeed.xml +++ b/install/unix/litespeed.xml @@ -3,51 +3,51 @@ 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: - + @@ -63,12 +63,12 @@ cd php-x.x.x - + 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: - + @@ -82,14 +82,14 @@ sudo make install - + Checking The LSPHP Installation - + - + One of the simplest ways to check whether the installation of PHP was successful is to run the following code: - + @@ -100,9 +100,9 @@ cd /usr/local/lsws/fcgi-bin/ - + This should return information about the new PHP build: - + @@ -114,45 +114,45 @@ Zend Engine v2.6.0, Copyright (c) 1998-2015 Zend Technologies - + 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: - + @@ -162,9 +162,9 @@ Zend Engine v2.6.0, Copyright (c) 1998-2015 Zend Technologies - + Have LSPHP bind to port 3000 on all IPv4 addresses: - + @@ -174,9 +174,9 @@ Zend Engine v2.6.0, Copyright (c) 1998-2015 Zend Technologies - + Have LSPHP bind to address 192.168.0.2:3000: - + @@ -186,9 +186,9 @@ Zend Engine v2.6.0, Copyright (c) 1998-2015 Zend Technologies - + Have LSPHP accept requests on Unix domain socket /tmp/lsphp_manual.sock: - + @@ -198,9 +198,9 @@ Zend Engine v2.6.0, Copyright (c) 1998-2015 Zend Technologies - + Environment variables can be added before the LSPHP executable: - + @@ -210,41 +210,41 @@ PHP_LSAPI_MAX_REQUESTS=500 PHP_LSAPI_CHILDREN=35 /path/to/lsphp -b IP_address:po - + 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 - + Installing from packages or ports on OpenBSD - + This section contains notes and hints specific to installing PHP on OpenBSD. - + Using Binary Packages diff --git a/install/unix/solaris.xml b/install/unix/solaris.xml index af81554ed2c8..a007fc12178b 100644 --- a/install/unix/solaris.xml +++ b/install/unix/solaris.xml @@ -2,18 +2,18 @@ <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