Changeset db81e4cb


Ignore:
Timestamp:
05/05/2005 07:47:31 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 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, ken/inkscape-core-mods, krejzi/svn, lazarus, nosym, perl-modules, plabs/python-mods, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226
Children:
4f9811f
Parents:
a3a476d
Message:

Tagged php.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/prog/php.xml

    ra3a476d rdb81e4cb  
    1414
    1515<sect1 id="php" xreflabel="PHP-&php-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="php.html"?>
    21 <title><acronym>PHP</acronym>-&php-version;</title>
    22 <indexterm zone="php">
    23 <primary sortas="a-PHP">PHP</primary></indexterm>
    24 
    25 <sect2>
    26 <title>Introduction to <application><acronym>PHP</acronym></application></title>
    27 
    28 <para><application><acronym>PHP</acronym></application> is the
    29 <acronym>PHP</acronym> Hypertext Preprocessor. Primarily used in dynamic web
    30 sites, it allows for programming code to be directly embedded into the
    31 <acronym>HTML</acronym> markup.</para>
    32 
    33 <sect3><title>Package information</title>
    34 <itemizedlist spacing='compact'>
    35 <listitem><para>Download (HTTP):
    36 <ulink url="&php-download-http;"/></para></listitem>
    37 <listitem><para>Download (FTP):
    38 <ulink url="&php-download-ftp;"/></para></listitem>
    39 <listitem><para>Download MD5 sum: &php-md5sum;</para></listitem>
    40 <listitem><para>Download size: &php-size;</para></listitem>
    41 <listitem><para>Estimated disk space required:
    42 &php-buildsize;</para></listitem>
    43 <listitem><para>Estimated build time:
    44 &php-time;</para></listitem></itemizedlist>
    45 </sect3>
    46 
    47 <sect3><title>Additional downloads</title>
    48 <itemizedlist spacing="compact">
    49 <listitem><para>Required patch for Berkeley DB: <ulink
    50 url="&patch-root;/php-&php-version;-db43-1.patch"/></para>
    51 </listitem></itemizedlist>
    52 </sect3>
    53 
    54 <sect3><title><application><acronym>PHP</acronym></application>
    55 dependencies</title>
    56 <sect4><title>Required</title>
    57 <para><xref linkend="apache"/></para>
    58 </sect4>
    59 
    60 <sect4><title>Optional</title>
    61 <para><xref linkend="libxml2"/>,
    62 <xref linkend="libxslt"/>,
    63 <xref linkend="openssl"/>,
    64 <ulink url="http://www.fastio.com/">ClibPDF</ulink>,
    65 <xref linkend="libjpeg"/>,
    66 <xref linkend="libtiff"/>,
    67 <xref linkend="curl"/>,
    68 <ulink url="http://qdbm.sourceforge.net/">QDBM</ulink>,
    69 <ulink url="http://cr.yp.to/cdb.html">cdb</ulink>,
    70 <xref linkend="gdbm"/>,
    71 <xref linkend="db"/>,
    72 <xref linkend="fam"/>,
    73 <ulink url="http://www.boutell.com/gd/">GD</ulink>,
    74 <xref linkend="libpng"/>,
    75 X (<xref linkend="xorg"/> or <xref linkend="xfree86"/>),
    76 <xref linkend="freetype2"/>,
    77 <ulink
    78 url="http://gd.tuwien.ac.at/visual/ibiblio/libs/graphics/t1lib-5.0.2.tar.gz">
    79 t1lib</ulink>,
    80 <xref linkend="gmp"/>
    81 <xref linkend="mysql"/>,
    82 <xref linkend="pcre"/>,
    83 <xref linkend="postgresql"/>,
    84 <xref linkend="aspell"/>,
    85 <xref linkend="pkgconfig"/>,
    86 <xref linkend="html-tidy"/>,
    87 <xref linkend="openldap"/>,
    88 <xref linkend="cyrus-sasl"/>,
    89 <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>,
    90 <ulink url="http://mcrypt.hellug.gr/">libmcrypt</ulink>,
    91 <ulink url="http://mhash.sourceforge.net/">mhash</ulink>,
    92 <ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>,
    93 <ulink url="http://www.sqlite.org/">SQLite</ulink>,
    94 <ulink url="http://dmalloc.com/">Dmalloc</ulink>,
    95 <ulink url="http://www.mnogosearch.org/">mnoGoSearch</ulink>,
    96 <ulink url="http://www.hughes.com.au/products/msql/">Mini SQL</ulink>,
    97 <ulink url="http://www.empress.com/">Empress</ulink>,
    98 <ulink url="http://www.birdstep.com/">Birdstep</ulink>,
    99 <ulink url="http://www.dbmaker.com/">DBMaker</ulink>,
    100 <ulink url="http://www.softwareag.com/">Adabas</ulink>,
    101 <ulink url="http://www.frontbase.com/">FrontBase</ulink>,
    102 <ulink url="http://caudium.net/">Caudium</ulink>,
    103 <ulink url="http://www.openwddx.org/">WDDX</ulink>,
    104 <ulink url="http://partners.adobe.com/asn/acrobat/forms.jsp">
    105 FDF Toolkit</ulink>,
    106 <ulink url="http://www.hyperwave.com/">Hyperwave</ulink>,
    107 <ulink url="http://www.mainstreetsoftworks.com/">Monetra</ulink>,
    108 <xref linkend="expat"/> and
    109 <ulink url="../server/mail.html">MTA</ulink></para>
    110 </sect4>
    111 </sect3>
    112 
    113 </sect2>
    114 
    115 <sect2>
    116 <title>Installation of <application><acronym>PHP</acronym></application></title>
    117 
    118 <note><para>You can use <application><acronym>PHP</acronym></application>
    119 for server-side scripting, command line scripting or client-side
    120 <acronym>GUI</acronym> applications. The book provides instructions for
    121 setting up <application><acronym>PHP</acronym></application> for
    122 server-side scripting as it is the most common form.</para></note>
    123 
    124 <para>If you have Berkeley DB installed and wish to utilize it, apply
    125 the following patch:</para>
    126 
    127 <screen><userinput><command>patch -Np1 -i ../php-&php-version;-db43-1.patch</command></userinput></screen>
    128 
    129 <para>Install <application><acronym>PHP</acronym></application> by
    130 running the following commands:</para>
    131 
    132 <screen><userinput><command>./configure --prefix=/usr \
     16  <?dbhtml filename="php.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>PHP-&php-version;</title>
     24
     25  <indexterm zone="php">
     26    <primary sortas="a-PHP">PHP</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to PHP</title>
     31
     32    <para><application>PHP</application> is the PHP Hypertext Preprocessor.
     33    Primarily used in dynamic web sites, it allows for programming code to be
     34    directly embedded into the HTML markup.</para>
     35
     36    <bridgehead renderas="sect3">Package Information</bridgehead>
     37    <itemizedlist spacing="compact">
     38      <listitem>
     39        <para>Download (HTTP): <ulink url="&php-download-http;"/></para>
     40      </listitem>
     41      <listitem>
     42        <para>Download (FTP): <ulink url="&php-download-ftp;"/></para>
     43      </listitem>
     44      <listitem>
     45        <para>Download MD5 sum: &php-md5sum;</para>
     46      </listitem>
     47      <listitem>
     48        <para>Download size: &php-size;</para>
     49      </listitem>
     50      <listitem>
     51        <para>Estimated disk space required: &php-buildsize;</para>
     52      </listitem>
     53      <listitem>
     54        <para>Estimated build time: &php-time;</para>
     55      </listitem>
     56    </itemizedlist>
     57
     58    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     59    <itemizedlist spacing="compact">
     60      <listitem>
     61        <para>Required patch for Berkeley DB: <ulink
     62        url="&patch-root;/php-&php-version;-db43-1.patch"/></para>
     63      </listitem>
     64    </itemizedlist>
     65
     66    <bridgehead renderas="sect3">PHP Dependencies</bridgehead>
     67
     68    <bridgehead renderas="sect4">Required</bridgehead>
     69    <para><xref linkend="apache"/></para>
     70
     71    <bridgehead renderas="sect4">Optional</bridgehead>
     72    <para><xref linkend="libxml2"/>,
     73    <xref linkend="libxslt"/>,
     74    <xref linkend="openssl"/>,
     75    <ulink url="http://www.fastio.com/">ClibPDF</ulink>,
     76    <xref linkend="libjpeg"/>,
     77    <xref linkend="libtiff"/>,
     78    <xref linkend="curl"/>,
     79    <ulink url="http://qdbm.sourceforge.net/">QDBM</ulink>,
     80    <ulink url="http://cr.yp.to/cdb.html">cdb</ulink>,
     81    <xref linkend="gdbm"/>,
     82    <xref linkend="db"/>,
     83    <xref linkend="fam"/>,
     84    <ulink url="http://www.boutell.com/gd/">GD</ulink>,
     85    <xref linkend="libpng"/>,
     86    X (<xref linkend="xorg"/> or <xref linkend="xfree86"/>),
     87    <xref linkend="freetype2"/>,
     88    <ulink
     89    url="http://gd.tuwien.ac.at/visual/ibiblio/libs/graphics/t1lib-5.0.2.tar.gz">
     90    t1lib</ulink>,
     91    <xref linkend="gmp"/>
     92    <xref linkend="mysql"/>,
     93    <xref linkend="pcre"/>,
     94    <xref linkend="postgresql"/>,
     95    <xref linkend="aspell"/>,
     96    <xref linkend="pkgconfig"/>,
     97    <xref linkend="html-tidy"/>,
     98    <xref linkend="openldap"/>,
     99    <xref linkend="cyrus-sasl"/>,
     100    <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>,
     101    <ulink url="http://mcrypt.hellug.gr/">libmcrypt</ulink>,
     102    <ulink url="http://mhash.sourceforge.net/">mhash</ulink>,
     103    <ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>,
     104    <ulink url="http://www.sqlite.org/">SQLite</ulink>,
     105    <ulink url="http://dmalloc.com/">Dmalloc</ulink>,
     106    <ulink url="http://www.mnogosearch.org/">mnoGoSearch</ulink>,
     107    <ulink url="http://www.hughes.com.au/products/msql/">Mini SQL</ulink>,
     108    <ulink url="http://www.empress.com/">Empress</ulink>,
     109    <ulink url="http://www.birdstep.com/">Birdstep</ulink>,
     110    <ulink url="http://www.dbmaker.com/">DBMaker</ulink>,
     111    <ulink url="http://www.softwareag.com/">Adabas</ulink>,
     112    <ulink url="http://www.frontbase.com/">FrontBase</ulink>,
     113    <ulink url="http://caudium.net/">Caudium</ulink>,
     114    <ulink url="http://www.openwddx.org/">WDDX</ulink>,
     115    <ulink url="http://partners.adobe.com/asn/acrobat/forms.jsp">
     116    FDF Toolkit</ulink>,
     117    <ulink url="http://www.hyperwave.com/">Hyperwave</ulink>,
     118    <ulink url="http://www.mainstreetsoftworks.com/">Monetra</ulink>,
     119    <xref linkend="expat"/> and
     120    <ulink url="../server/mail.html">MTA</ulink></para>
     121
     122  </sect2>
     123
     124  <sect2 role="installation">
     125    <title>Installation of PHP</title>
     126
     127    <note>
     128      <para>You can use <application>PHP</application>
     129      for server-side scripting, command line scripting or client-side
     130      GUI applications. The book provides instructions for
     131      setting up <application>PHP</application> for
     132      server-side scripting as it is the most common form.</para>
     133    </note>
     134
     135    <para>If you have <application>Berkeley DB</application> installed and
     136    wish to utilize it, apply the following patch:</para>
     137
     138<screen><userinput>patch -Np1 -i ../php-&php-version;-db43-1.patch</userinput></screen>
     139
     140    <para>Install <application>PHP</application> by
     141    running the following commands:</para>
     142
     143<screen><userinput>./configure --prefix=/usr \
    133144            --sysconfdir=/etc \
    134145            --with-apxs2 \
    … …  
    147158            --with-readline \
    148159            --disable-libxml &amp;&amp;
    149 make</command></userinput></screen>
    150 
    151 <para>Now, as the root user:</para>
    152 
    153 <screen><userinput role='root'><command>make install &amp;&amp;
    154 cp php.ini-recommended /etc/php.ini</command></userinput></screen>
    155 
    156 <para>Remove the <parameter>--disable-libxml</parameter> switch if you
    157 have <xref linkend="libxml2"/> installed otherwise
    158 <command>pear</command> will not be built.</para>
    159 
    160 <note><para><acronym>PHP</acronym> has many more configure options that
    161 will enable support for certain things. You can use
    162 <command>./configure --help</command> to see a full list of the
    163 available options. Also, use of the
    164 <ulink url="http://www.php.net/"><acronym>PHP</acronym> web site</ulink>
    165 is highly recommended, as their online docs are very good.</para></note>
    166 
    167 </sect2>
    168 
    169 <sect2>
    170 <title>Configuring <application><acronym>PHP</acronym></application></title>
    171 
    172 <sect3 id="php-config"><title>Config files</title>
    173 <para><filename>/etc/php.ini</filename>,
    174 <filename>/etc/pear.conf</filename></para>
    175 <indexterm zone="php php-config">
    176 <primary sortas="e-etc-php.ini">/etc/php.ini</primary></indexterm>
    177 <indexterm zone="php php-config">
    178 <primary sortas="e-etc-pear.conf">/etc/pear.conf</primary></indexterm>
    179 </sect3>
    180 
    181 <sect3><title>Configuration Information</title>
    182 
    183 <para>To enable <acronym>PHP</acronym> support in the
    184 <application>Apache</application> web server,
    185 a new LoadModule (which should be handled automatically by the
    186 <command>make install</command> command) and AddType directives must be added
    187 to the <filename>httpd.conf</filename> file:</para>
    188 
    189 <screen><userinput>LoadModule php5_module lib/apache/libphp5.so
    190 AddType application/x-httpd-php .php</userinput></screen>
    191 
    192 <para>Also, it can be useful to add an entry for
    193 <filename>index.php</filename> to the DirectoryIndex directive of the
    194 <filename>httpd.conf</filename> file.</para>
    195 
    196 <para>You'll need to restart the <application>Apache</application> web server
    197 after making any modifications to the <filename>httpd.conf</filename>
    198 file.</para>
    199 </sect3>
    200 
    201 </sect2>
    202 
    203 <sect2>
    204 <title>Contents</title>
    205 
    206 <segmentedlist>
    207 <segtitle>Installed Programs</segtitle>
    208 <segtitle>Installed Library</segtitle>
    209 <segtitle>Installed Directories</segtitle>
    210 
    211 <seglistitem>
    212 <seg>pear, php, php-config, phpextdist and phpize</seg>
    213 <seg>libphp5.so</seg>
    214 <seg>/usr/include/php and /usr/lib/php</seg>
    215 </seglistitem>
    216 </segmentedlist>
    217 
    218 <variablelist>
    219 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    220 <?dbfo list-presentation="list"?>
    221 
    222 <varlistentry id="php-prog">
    223 <term><command>php</command></term>
    224 <listitem><para>is a command line interface that enables you to parse and
    225 execute <acronym>PHP</acronym> code.</para>
    226 <indexterm zone="php php-prog">
    227 <primary sortas="b-php">php</primary>
    228 </indexterm></listitem>
    229 </varlistentry>
    230 
    231 <varlistentry id="pear">
    232 <term><command>pear</command></term>
    233 <listitem><para>is the <acronym>PHP</acronym> Extension and Application
    234 Repository (<acronym>PEAR</acronym>) package manager.</para>
    235 <indexterm zone="php pear">
    236 <primary sortas="b-pear">pear</primary>
    237 </indexterm></listitem>
    238 </varlistentry>
    239 </variablelist>
    240 
    241 </sect2>
     160make</userinput></screen>
     161
     162    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     163
     164<screen role="root"><userinput>make install &amp;&amp;
     165cp php.ini-recommended /etc/php.ini</userinput></screen>
     166
     167    <para>Remove the <option>--disable-libxml</option> switch if you
     168    have <xref linkend="libxml2"/> installed otherwise
     169    <command>pear</command> will not be built.</para>
     170
     171    <note>
     172      <para><application>PHP</application> has many more configure
     173      options that will enable support for certain things. You can use
     174      <command>./configure --help</command> to see a full list of the
     175      available options. Also, use of the
     176      <ulink url="http://www.php.net/">PHP web site</ulink>
     177      is highly recommended, as their online docs are very good.</para>
     178    </note>
     179
     180  </sect2>
     181
     182  <sect2 role="configuration">
     183    <title>Configuring PHP</title>
     184
     185    <sect3 id="php-config">
     186      <title>Config Files</title>
     187
     188      <para><filename>/etc/php.ini</filename>,
     189      <filename>/etc/pear.conf</filename></para>
     190
     191      <indexterm zone="php php-config">
     192        <primary sortas="e-etc-php.ini">/etc/php.ini</primary>
     193      </indexterm>
     194
     195      <indexterm zone="php php-config">
     196        <primary sortas="e-etc-pear.conf">/etc/pear.conf</primary>
     197      </indexterm>
     198
     199    </sect3>
     200
     201    <sect3>
     202      <title>Configuration Information</title>
     203
     204      <para>To enable PHP support in the <application>Apache</application>
     205      web server, a new LoadModule (which should be handled automatically by the
     206      <command>make install</command> command) and AddType directives
     207      must be added to the <filename>httpd.conf</filename> file:</para>
     208
     209<screen><literal>LoadModule php5_module lib/apache/libphp5.so
     210AddType application/x-httpd-php .php</literal></screen>
     211
     212      <para>Also, it can be useful to add an entry for
     213      <filename>index.php</filename> to the DirectoryIndex directive of the
     214      <filename>httpd.conf</filename> file.</para>
     215
     216      <para>You'll need to restart the <application>Apache</application> web server
     217      after making any modifications to the <filename>httpd.conf</filename>
     218      file.</para>
     219
     220    </sect3>
     221
     222  </sect2>
     223
     224  <sect2 role="content">
     225    <title>Contents</title>
     226
     227    <segmentedlist>
     228      <segtitle>Installed Programs</segtitle>
     229      <segtitle>Installed Library</segtitle>
     230      <segtitle>Installed Directories</segtitle>
     231
     232      <seglistitem>
     233        <seg>pear, php, php-config, phpextdist, and phpize</seg>
     234        <seg>libphp5.so</seg>
     235        <seg>/usr/include/php and /usr/lib/php</seg>
     236      </seglistitem>
     237    </segmentedlist>
     238
     239    <variablelist>
     240      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     241      <?dbfo list-presentation="list"?>
     242      <?dbhtml list-presentation="table"?>
     243
     244      <varlistentry id="php-prog">
     245        <term><command>php</command></term>
     246        <listitem>
     247          <para>is a command line interface that enables you to parse and
     248          execute PHP code.</para>
     249          <indexterm zone="php php-prog">
     250            <primary sortas="b-php">php</primary>
     251          </indexterm>
     252        </listitem>
     253      </varlistentry>
     254
     255      <varlistentry id="pear">
     256        <term><command>pear</command></term>
     257        <listitem>
     258          <para>is the PHP Extension and Application
     259          Repository (PEAR) package manager.</para>
     260          <indexterm zone="php pear">
     261            <primary sortas="b-pear">pear</primary>
     262          </indexterm>
     263        </listitem>
     264      </varlistentry>
     265
     266    </variablelist>
     267
     268  </sect2>
    242269
    243270</sect1>
Note: See TracChangeset for help on using the changeset viewer.