Changeset 5178bbf6

Timestamp:

03/29/2014 10:19:25 AM (10 years ago)

Author:

Pierre Labastie <pieere@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

5096ebd

Parents:

0f5aa11

Message:

Use the fastCGI process manager for PHP. Fixes ticket #4844

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@12909 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:

• general/prog/php.xml (modified) (10 diffs)
• introduction/welcome/changelog.xml (modified) (1 diff)

general/prog/php.xml

@@ -180 +180 @@
 ./configure --prefix=/usr                \
             --sysconfdir=/etc            \
+            --localstatedir=/var         \
+            --datadir=/usr/share/php     \
             --mandir=/usr/share/man      \
-            --with-apxs2                 \
+            --enable-fpm                 \
+            --with-fpm-user=apache       \
+            --with-fpm-group=apache      \
             --with-config-file-path=/etc \
             --with-zlib                  \
@@ -205 +209 @@
 <screen role="root"><userinput>make install                                         &amp;&amp;
 install -v -m644 php.ini-production /etc/php.ini     &amp;&amp;
+mv -v /etc/php-fpm.conf{.default,}                   &amp;&amp;
 
 install -v -m755 -d /usr/share/doc/php-&php-version; &amp;&amp;
@@ -243 +248 @@
       <application>Bison</application> as a valid version.</para>
       
-      <para><parameter>--with-apxs2</parameter>: This parameter
-      builds the Apache HTTPD 2.0 module.</para>
+      <para><parameter>--with-datadir=/usr/share/php</parameter>: This works
+      around a bug in the build machinery, which installs some data to a
+      wrong location.</para>
+
+      <para><parameter>--enable-fpm</parameter>: This parameter allows
+      building the fastCGI Process Manager.</para>
 
       <para><parameter>--with-config-file-path=/etc</parameter>: This parameter
@@ -282 +291 @@
       installed.</para>
 
+      <para><option>--with-apxs2</option>: Instead of building the fastCGI process
+      manager, it is possible to build an <application>apache</application> module.
+      This has some performance penalty for heavy loaded servers, but may be easier
+      to set up. This switch is incompatible with the
+      <parameter>--enable-fpm</parameter> and <parameter>--with-fpm-...</parameter>
+      switches.</para>
+
   </sect2>
 
@@ -290 +306 @@
       <title>Config Files</title>
 
-      <para><filename>/etc/php.ini</filename> and
-      <filename>/etc/pear.conf</filename></para>
+      <para><filename>/etc/php.ini</filename>,
+      <filename>/etc/pear.conf</filename> and
+      <filename>/etc/php-fpm.conf</filename></para>
 
       <indexterm zone="php php-config">
@@ -299 +316 @@
       <indexterm zone="php php-config">
         <primary sortas="e-etc-pear.conf">/etc/pear.conf</primary>
+      </indexterm>
+
+      <indexterm zone="php php-config">
+        <primary sortas="e-etc-php-fpm.conf">/etc/php-fpm.conf</primary>
       </indexterm>
 
@@ -325 +346 @@
     /etc/php.ini</userinput></screen>
 
-      <para>To enable PHP support in the <application>Apache</application>
-      web server, a new LoadModule (which should be handled automatically by the
-      <command>make install</command> command) and AddType directives
-      must be added to the <filename>httpd.conf</filename> file:</para>
-
-<screen><literal>LoadModule php5_module lib/apache/libphp5.so
-AddType application/x-httpd-php .php</literal></screen>
-
-      <para>Additionally, it can be useful to add an entry for
+      <para>To enable fastCGI support in the <application>Apache</application>
+      web server, two LoadModule directives must be added to the
+      <filename>httpd.conf</filename> file. They are commented out, so just issue the
+      following command as <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>sed -i -e '/proxy_module/s/^#//'      \
+       -e '/proxy_fgci_module/s/^#//' \
+       /etc/httpd/httpd.conf</userinput></screen>
+
+      <para>Those modules accept various <command>ProxyPass</command>
+      directives. One possibility is (as the
+      <systemitem class="username">root</systemitem> user):</para>
+
+<screen role="root"><userinput>echo \
+ProxyPassMatch ^/(.*\.php)$ fcgi://127.0.0.1:9000/srv/www/$1 >> \
+/etc/httpd/httpd.conf</userinput></screen>
+
+      <para>Additionally, it may be useful to add an entry for
       <filename>index.php</filename> to the DirectoryIndex directive of the
       <filename>httpd.conf</filename> file. Lastly, adding a line to setup the
@@ -348 +378 @@
     </sect3>
 
+    <sect3  id="php-init">
+      <title>Boot Script</title>
+
+      <para>
+        To automatically start the <command>php-fpm</command> daemon when the
+        system is rebooted, install the
+        <filename>/etc/rc.d/init.d/php</filename> bootscript from the
+        <xref linkend="bootscripts"/> package as the
+        <systemitem class="username">root</systemitem> user:
+      </para>
+
+      <indexterm zone="php php-init">
+        <primary sortas="f-php">php</primary>
+      </indexterm>
+
+<screen role="root"><userinput>make install-php</userinput></screen>
+    </sect3>
+
   </sect2>
 
@@ -360 +408 @@
       <seglistitem>
         <seg>pear, peardev, pecl, phar (symlink), phar.phar,
-        php, php-cgi, php-config, and phpize</seg>
-        <seg>libphp5.so Apache module and
-        two under /usr/lib/php/extensions/no-debug-zts-20121212/</seg>
-        <seg>/usr/include/php, /usr/lib/php and
+        php, php-cgi, php-config, php-fpm, and phpize</seg>
+        <seg>dba.so and opcache.so in
+       /usr/lib/php/extensions/no-debug-non-zts-20121212/</seg>
+        <seg>/usr/include/php, /usr/lib/php, /usr/share/php and
         /usr/share/doc/php-&php-version;</seg>
       </seglistitem>
@@ -395 +443 @@
       </varlistentry>
 
+      <varlistentry id="php-fpm">
+        <term><command>php-fpm</command></term>
+        <listitem>
+          <para>is the fastCGI process manager for PHP.</para>
+          <indexterm zone="php php-fpm">
+            <primary sortas="b-php-fpm">php-fpm</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
     </variablelist>
 

introduction/welcome/changelog.xml

@@ -49 +49 @@
       <itemizedlist>
         <listitem>
+          <para>[pierre] - Use the fastCGI process manager for PHP. Fixes
+          <ulink url="&blfs-ticket-root;4844">#4844</ulink>.</para>
+        </listitem>
+        <listitem>
           <para>[fernando] - LibreOffice-4.2.2 additional dependencies. Thanks
           Wayne B. Fixes