source: general/prog/php.xml@ a1f2d184

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.6 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind 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 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since a1f2d184 was a9e8da9, checked in by Igor Živković <igor@…>, 10 years ago

Update to php-5.6.0.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@14185 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 18.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY php-download-http "http://us2.php.net/distributions/php-&php-version;.tar.bz2">
8 <!ENTITY php-download-ftp "ftp://ftp.isu.edu.tw/pub/Unix/Web/PHP/distributions/php-&php-version;.tar.bz2">
9 <!ENTITY php-md5sum "1f889357528809a6675e2f23995832d7">
10 <!ENTITY php-size "13 MB">
11 <!ENTITY php-buildsize "442 MB (additional 1 MB to run the test suite and 102 MB for documentation)">
12 <!ENTITY php-time "4 SBU (additional 1.9 SBU to run the test suite)">
13]>
14
15<sect1 id="php" xreflabel="PHP-&php-version;">
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. It is also useful as a
35 general purpose scripting language.</para>
36
37 &lfs75_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>Download (HTTP): <ulink url="&php-download-http;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download (FTP): <ulink url="&php-download-ftp;"/></para>
46 </listitem>
47 <listitem>
48 <para>Download MD5 sum: &php-md5sum;</para>
49 </listitem>
50 <listitem>
51 <para>Download size: &php-size;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated disk space required: &php-buildsize;</para>
55 </listitem>
56 <listitem>
57 <para>Estimated build time: &php-time;</para>
58 </listitem>
59 </itemizedlist>
60
61 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
62 <itemizedlist spacing="compact">
63 <listitem>
64 <para>Pre-built documentation (optional): <ulink
65 url="http://www.php.net/download-docs.php"/></para>
66 </listitem>
67 </itemizedlist>
68
69 <bridgehead renderas="sect3">PHP Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Recommended</bridgehead>
72 <para role="recommended">
73 <xref linkend="apache"/> and
74 <xref linkend="libxml2"/>
75 </para>
76
77 <bridgehead renderas="sect4">Optional System Utilities and Libraries</bridgehead>
78 <para role="optional"><xref linkend="libxslt"/>,
79 <!-- <xref linkend="gamin"/>, -->
80 <xref linkend="pcre"/>,
81 <xref linkend="aspell"/>,
82 <xref linkend="enchant"/>,
83 <xref linkend="pth"/>,
84 an <xref linkend="server-mail"/> (that provides a
85 <command>sendmail</command> command)
86 <ulink url="http://www.ossp.org/pkg/lib/mm/">OSSP mm</ulink>,
87 <ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>,
88 <ulink url="http://re2c.org/">re2c</ulink>,
89 <ulink url="http://xmlrpc-epi.sourceforge.net/main.php?t=php_about">XMLRPC-EPI</ulink>, and
90 <ulink url="http://dmalloc.com/">Dmalloc</ulink></para>
91
92 <bridgehead renderas="sect4">Optional Graphics Utilities and Libraries</bridgehead>
93 <para role="optional"><xref linkend="libjpeg"/>,
94 <xref linkend="libtiff"/>,
95 <xref linkend="libpng"/>,
96 <xref linkend="libexif"/>,
97 <xref linkend="freetype2"/>,
98 <xref linkend="x-window-system"/>,
99 <ulink url="http://www.fastio.com/">ClibPDF</ulink>,
100 <ulink url="https://bitbucket.org/libgd/gd-libgd/downloads">GD</ulink>,
101 <ulink url="http://fossies.org/linux/misc/t1lib-5.1.2.tar.gz/">t1lib</ulink>, and
102 <ulink url="http://www.adobe.com/devnet/acrobat/fdftoolkit.html">FDF Toolkit</ulink></para>
103
104 <bridgehead renderas="sect4">Optional Web Utilities</bridgehead>
105 <para role="optional"><xref linkend="curl"/>,
106 <xref linkend="html-tidy"/>,
107 <ulink url="http://www.mnogosearch.org/">mnoGoSearch</ulink>,
108 <ulink url="http://www.hyperwave.com/">Hyperwave</ulink>,
109 <ulink url="http://www.roxen.com/products/webserver/">Roxen WebServer</ulink>,
110 <ulink url="http://sourceforge.net/projects/caudium/">Caudium</ulink>, and
111 <ulink url="https://wddxnet.codeplex.com/">WDDX</ulink></para>
112
113 <bridgehead renderas="sect4">Optional Data Management Utilities and Libraries</bridgehead>
114 <para role="optional"><xref linkend="openldap"/>,
115 <!-- <xref linkend="gdbm"/>, -->
116 <xref linkend="db"/>,
117 <xref linkend="mariadb"/> or <ulink url="http://www.mysql.com/">MySQL</ulink>,
118 <xref linkend="postgresql"/>,
119 <xref linkend="unixodbc"/>,
120 <xref linkend="sqlite"/>,
121 <ulink url="http://sourceforge.net/projects/qdbm">QDBM</ulink>,
122 <ulink url="http://cr.yp.to/cdb.html">cdb</ulink>,
123 <ulink url="http://www.hughes.com.au/products/msql/">Mini SQL</ulink>,
124 <ulink url="http://www.empress.com/">Empress</ulink>,
125 <ulink url="http://www.birdstep.com/">Birdstep</ulink>,
126 <ulink url="http://www.dbmaker.com/">DBMaker</ulink>,
127 <ulink url="http://www.softwareag.com/">Adabas</ulink>,
128 <ulink url="http://www.frontbase.com/">FrontBase</ulink>, and
129 <ulink url="http://www.mainstreetsoftworks.com/">Monetra</ulink></para>
130
131 <para><application>PHP</application> also provides support for many
132 commercial database tools such as <application>Oracle</application>,
133 <application>SAP</application> and
134 <application>ODBC Router</application>.</para>
135
136 <bridgehead renderas="sect4">Optional Security/Encryption Utilities and Libraries</bridgehead>
137 <para role="optional"><xref linkend="openssl"/>,
138 <xref linkend="cyrus-sasl"/>,
139 <xref linkend="mitkrb"/>,
140 <ulink url="http://mcrypt.sourceforge.net/">libmcrypt</ulink>, and
141 <ulink url="http://mhash.sourceforge.net/">mhash</ulink></para>
142
143 <para condition="html" role="usernotes">User Notes:
144 <ulink url="&blfs-wiki;/php"/></para>
145
146 </sect2>
147
148 <sect2 role="installation">
149 <title>Installation of PHP</title>
150
151 <para>You can use <application>PHP</application> for server-side
152 scripting, command-line scripting or client-side GUI applications. This
153 book provides instructions for setting up <application>PHP</application>
154 for server-side scripting as it is the most common form.</para>
155
156 <note>
157 <para><application>PHP</application> has many more
158 <command>configure</command> options that will enable support for various
159 things. You can use <command>./configure --help</command> to see a full
160 list of the available options. Also, use of the
161 <ulink url="http://www.php.net/">PHP web site</ulink>
162 is highly recommended, as their online docs are very good. An example of
163 a <command>configure</command> command that utilizes many of the most
164 common dependencies can be found at <ulink
165 url="&files-anduin;/php_configure.txt"/>.
166 </para>
167
168 <para>If, for whatever reason, you don't have <xref linkend="libxml2"/>
169 installed, you need to add <option>--disable-libxml</option> to the
170 <command>configure</command> command in the instructions below. Note that
171 this will prevent the <command>pear</command> command from being
172 built.</para>
173 </note>
174
175 <para>Install <application>PHP</application> by
176 running the following commands:</para>
177
178<screen><userinput>./configure --prefix=/usr \
179 --sysconfdir=/etc \
180 --localstatedir=/var \
181 --datadir=/usr/share/php \
182 --mandir=/usr/share/man \
183 --enable-fpm \
184 --with-fpm-user=apache \
185 --with-fpm-group=apache \
186 --with-config-file-path=/etc \
187 --with-zlib \
188 --enable-bcmath \
189 --with-bz2 \
190 --enable-calendar \
191 --enable-dba=shared \
192 --with-gdbm \
193 --with-gmp \
194 --enable-ftp \
195 --with-gettext \
196 --enable-mbstring \
197 --with-readline &amp;&amp;
198make</userinput></screen>
199
200 <para>To test the results, issue: <command>make test</command>. A few
201 tests may fail, in which case you are asked whether you want to send
202 the report to the PHP developpers. If you want to automate the test,
203 you may prefix the command with <command>yes "n" | </command>.</para>
204
205 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
206
207<!-- dev note: make INSTALL_ROOT=<DESTDIR> install -->
208
209<screen role="root"><userinput>make install &amp;&amp;
210install -v -m644 php.ini-production /etc/php.ini &amp;&amp;
211mv -v /etc/php-fpm.conf{.default,} &amp;&amp;
212
213install -v -m755 -d /usr/share/doc/php-&php-version; &amp;&amp;
214install -v -m644 CODING_STANDARDS EXTENSIONS INSTALL NEWS README* UPGRADING* php.gif \
215 /usr/share/doc/php-&php-version; &amp;&amp;
216ln -v -sfn /usr/lib/php/doc/Archive_Tar/docs/Archive_Tar.txt \
217 /usr/share/doc/php-&php-version; &amp;&amp;
218ln -v -sfn /usr/lib/php/doc/Structures_Graph/docs \
219 /usr/share/doc/php-&php-version;</userinput></screen>
220
221 <para>The pre-built HTML documentation is packaged in two forms: a tarball
222 containing many individual files, useful for quick loading into your
223 browser, and one large individual file, which is useful for using the
224 search utility of your browser. If you downloaded either, or both, of the
225 documentation files, issue the following commands as the
226 <systemitem class='username'>root</systemitem> user to install them (note
227 these instructions assume English docs, modify the tarball names below if
228 necessary).</para>
229
230 <para>For the <quote>Single HTML</quote> file:</para>
231
232<screen role="root"><userinput>install -v -m644 ../php_manual_en.html.gz \
233 /usr/share/doc/php-&php-version; &amp;&amp;
234gunzip -v /usr/share/doc/php-&php-version;/php_manual_en.html.gz</userinput></screen>
235
236 <para>For the <quote>Many HTML files</quote> tarball:</para>
237
238<screen role="root"><userinput>tar -xvf ../php_manual_en.tar.gz \
239 -C /usr/share/doc/php-&php-version; --no-same-owner</userinput></screen>
240
241 </sect2>
242
243 <sect2 role="commands">
244 <title>Command Explanations</title>
245
246 <para><parameter>--with-datadir=/usr/share/php</parameter>: This works
247 around a bug in the build machinery, which installs some data to a
248 wrong location.</para>
249
250 <para><parameter>--enable-fpm</parameter>: This parameter allows
251 building the fastCGI Process Manager.</para>
252
253 <para><parameter>--with-config-file-path=/etc</parameter>: This parameter
254 makes <application>PHP</application> look for the
255 <filename>php.ini</filename> configuration file in
256 <filename class='directory'>/etc</filename>.</para>
257
258 <para><parameter>--with-zlib</parameter>: This parameter adds
259 support for <application>Zlib</application> compression.</para>
260
261 <para><parameter>--enable-bcmath</parameter>: Enables
262 <command>bc</command> style precision math functions.</para>
263
264 <para><parameter>--with-bz2</parameter>: Adds support for
265 <application>Bzip2</application> compression functions.</para>
266
267 <para><parameter>--enable-calendar</parameter>: This parameter
268 provides support for calendar conversion.</para>
269
270 <para><parameter>--enable-dba=shared</parameter>: This parameter enables
271 support for database (dbm-style) abstraction layer functions.</para>
272
273 <para><parameter>--enable-ftp</parameter>: This parameter
274 enables FTP functions.</para>
275
276 <para><parameter>--with-gettext</parameter>: Enables functions
277 that use <application>Gettext</application> text translation.</para>
278
279 <para><parameter>--enable-mbstring</parameter>: This parameter
280 enables multibyte string support.</para>
281
282 <para><parameter>--with-readline</parameter>: This parameter
283 enables command line <application>Readline</application> support.</para>
284
285 <para><option>--with-mysql</option>: This option
286 includes <application>MariaDB/MySQL</application> support.</para>
287
288 <para><option>--disable-libxml</option>: This option
289 allows building PHP without <application>libxml2</application>
290 installed.</para>
291
292 <para><option>--with-apxs2</option>: Instead of building the fastCGI process
293 manager, it is possible to build an <application>apache</application> module.
294 This has some performance penalty for heavy loaded servers, but may be easier
295 to set up. This switch is incompatible with the
296 <parameter>--enable-fpm</parameter> and <parameter>--with-fpm-...</parameter>
297 switches.</para>
298
299 </sect2>
300
301 <sect2 role="configuration">
302 <title>Configuring PHP</title>
303
304 <sect3 id="php-config">
305 <title>Config Files</title>
306
307 <para><filename>/etc/php.ini</filename>,
308 <filename>/etc/pear.conf</filename> and
309 <filename>/etc/php-fpm.conf</filename></para>
310
311 <indexterm zone="php php-config">
312 <primary sortas="e-etc-php.ini">/etc/php.ini</primary>
313 </indexterm>
314
315 <indexterm zone="php php-config">
316 <primary sortas="e-etc-pear.conf">/etc/pear.conf</primary>
317 </indexterm>
318
319 <indexterm zone="php php-config">
320 <primary sortas="e-etc-php-fpm.conf">/etc/php-fpm.conf</primary>
321 </indexterm>
322
323 </sect3>
324
325 <sect3>
326 <title>Configuration Information</title>
327
328 <para>The file used as the default <filename>/etc/php.ini</filename>
329 configuration file is recommended by the <application>PHP</application>
330 development team. This file modifies the default behavior of
331 <application>PHP</application>. If no <filename>/etc/php.ini</filename>
332 is used, all configuration settings fall to the defaults. You should
333 review the comments in this file and ensure the changes are acceptable
334 in your particular environment.</para>
335
336 <para>You may have noticed the following from the output of the
337 <command>make install</command> command:</para>
338
339<screen><computeroutput>You may want to add: /usr/lib/php to your php.ini include_path</computeroutput></screen>
340
341 <para>If desired, add the entry using the following command as the
342 <systemitem class="username">root</systemitem> user:</para>
343
344<screen role="root"><userinput>sed -i 's@php/includes"@&amp;\ninclude_path = ".:/usr/lib/php"@' \
345 /etc/php.ini</userinput></screen>
346
347 <para>To enable fastCGI support in the <application>Apache</application>
348 web server, two LoadModule directives must be added to the
349 <filename>httpd.conf</filename> file. They are commented out, so just issue the
350 following command as <systemitem class="username">root</systemitem> user:</para>
351
352<screen role="root"><userinput>sed -i -e '/proxy_module/s/^#//' \
353 -e '/proxy_fcgi_module/s/^#//' \
354 /etc/httpd/httpd.conf</userinput></screen>
355
356 <para>Those modules accept various <command>ProxyPass</command>
357 directives. One possibility is (as the
358 <systemitem class="username">root</systemitem> user):</para>
359
360<screen role="root"><userinput>echo \
361'ProxyPassMatch ^/(.*\.php)$ fcgi://127.0.0.1:9000/srv/www/$1' >> \
362/etc/httpd/httpd.conf</userinput></screen>
363
364 <para>Additionally, it may be useful to add an entry for
365 <filename>index.php</filename> to the DirectoryIndex directive of the
366 <filename>httpd.conf</filename> file. Lastly, adding a line to setup the
367 <filename class='extension'>.phps</filename> extension to show
368 highlighted <application>PHP</application> source may be
369 desirable:</para>
370
371<screen><literal>AddType application/x-httpd-php-source .phps</literal></screen>
372
373 <para>You'll need to restart the <application>Apache</application> web server
374 after making any modifications to the <filename>httpd.conf</filename>
375 file.</para>
376
377 </sect3>
378
379 <sect3 id="php-init">
380 <title>Boot Script</title>
381
382 <para>
383 To automatically start the <command>php-fpm</command> daemon when the
384 system is rebooted, install the
385 <filename>/etc/rc.d/init.d/php</filename> bootscript from the
386 <xref linkend="bootscripts"/> package as the
387 <systemitem class="username">root</systemitem> user:
388 </para>
389
390 <indexterm zone="php php-init">
391 <primary sortas="f-php">php</primary>
392 </indexterm>
393
394<screen role="root"><userinput>make install-php</userinput></screen>
395 </sect3>
396
397 </sect2>
398
399 <sect2 role="content">
400 <title>Contents</title>
401
402 <segmentedlist>
403 <segtitle>Installed Programs</segtitle>
404 <segtitle>Installed Libraries</segtitle>
405 <segtitle>Installed Directories</segtitle>
406
407 <seglistitem>
408 <seg>pear, peardev, pecl, phar (symlink), phar.phar,
409 php, php-cgi, php-config, php-fpm, and phpize</seg>
410 <seg>dba.{so,a} and opcache.{so,a} in
411 /usr/lib/php/extensions/no-debug-non-zts-20121212/</seg>
412 <seg>/usr/include/php, /usr/lib/php, /usr/share/php and
413 /usr/share/doc/php-&php-version;</seg>
414 </seglistitem>
415 </segmentedlist>
416
417 <variablelist>
418 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
419 <?dbfo list-presentation="list"?>
420 <?dbhtml list-presentation="table"?>
421
422 <varlistentry id="php-prog">
423 <term><command>php</command></term>
424 <listitem>
425 <para>is a command line interface that enables you to parse and
426 execute PHP code.</para>
427 <indexterm zone="php php-prog">
428 <primary sortas="b-php">php</primary>
429 </indexterm>
430 </listitem>
431 </varlistentry>
432
433 <varlistentry id="pear">
434 <term><command>pear</command></term>
435 <listitem>
436 <para>is the PHP Extension and Application
437 Repository (PEAR) package manager.</para>
438 <indexterm zone="php pear">
439 <primary sortas="b-pear">pear</primary>
440 </indexterm>
441 </listitem>
442 </varlistentry>
443
444 <varlistentry id="php-fpm">
445 <term><command>php-fpm</command></term>
446 <listitem>
447 <para>is the fastCGI process manager for PHP.</para>
448 <indexterm zone="php php-fpm">
449 <primary sortas="b-php-fpm">php-fpm</primary>
450 </indexterm>
451 </listitem>
452 </varlistentry>
453
454 </variablelist>
455
456 </sect2>
457
458</sect1>
Note: See TracBrowser for help on using the repository browser.