source: general/prog/php.xml@ 15dd0b70

12.1 ken/TL2024 lazarus rahul/power-profiles-daemon trunk xry111/llvm18
Last change on this file since 15dd0b70 was ab4fdfc, checked in by Pierre Labastie <pierre.labastie@…>, 4 months ago

Change all xml decl to encoding=utf-8
  • Property mode set to 100644
File size: 26.6 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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 "https://www.php.net/distributions/php-&php-version;.tar.xz">
8 <!ENTITY php-download-ftp " ">
9 <!ENTITY php-md5sum "c6de74ddce25bcea59cf297c8f136ef2">
10 <!ENTITY php-size "12 MB">
11 <!ENTITY php-buildsize "525 MB (with documentation)">
12 <!ENTITY php-time "2.0 SBU (with parallelism=4; add 1.7 SBU for tests)">
13 <!-- Tests were run for 8.0.1 at -j4, had two timeouts as well.
14 Results were otherwise normal though, so I'm unsure of what caused the
15 increase in time. -renodr
16 No timeout for 8.0.2. Tests run at -j4 too. -pierre
17 No timeouts on 8.0.3 for me this time. -renodr
18 No timeouts on 8.0.5 -bdubbs
19 No timeouts, one failure on 8.0.9 -bdubbs
20 No timeouts on 8.0.10 - thomas
21 No timeouts on 8.0.11 - thomas
22
23TEST RESULT SUMMARY 8.1.0
24
25Exts skipped : 36
26Exts tested : 36
27
28Number of tests : 17060 12551
29Tests skipped : 4509 ( 26.4%)
30Tests warned : 2 ( 0.0%) ( 0.0%)
31Tests failed : 4 ( 0.0%) ( 0.0%)
32Expected fail : 28 ( 0.2%) ( 0.2%)
33Tests passed : 12517 ( 73.4%) ( 99.7%)
34
35Time taken : 165 seconds
36
37Stats for tests changed slightly for 8.1.1, but not significantly.
38Stats for tests changed slightly for 8.1.2, but not significantly.
39 Tests failed : 1
40For 8.1.4, ran tests at -j4. One test still fails.
41For 8.1.5, ran tests at -j4. One test still fails.
42
43Running tests at -j4 does nothing. The jobs cound is not passed to the
44actual routine running the tests.
45
46For 8.1.7:
47Number of tests : 17250 12714
48Tests skipped : 4536 ( 26.3%)
49Tests warned : 2 ( 0.0%) ( 0.0%)
50Tests failed : 1 ( 0.0%) ( 0.0%)
51Expected fail : 27 ( 0.2%) ( 0.2%)
52Tests passed : 12684 ( 73.5%) ( 99.8%)
53
54Time taken : 162 seconds
55
56The warnings are really XFAIL. The FAIL is ext/phar/tests/bug69958.phpt.
57It appears to be mission a test file.
58
59For 8.1.10:
60Number of tests : 17315 12768
61Tests skipped : 4547 ( 26.3%) - - - - - - - -
62Tests warned : 2 ( 0.0%) ( 0.0%)
63Tests failed : 5 ( 0.0%) ( 0.0%)
64Expected fail : 27 ( 0.2%) ( 0.2%)
65Tests passed : 12734 ( 73.5%) ( 99.7%)
66
67Time taken : 162 seconds
68
69For 8.2.0:
70Number of tests : 17768 13167
71Tests skipped : 4601 ( 25.9%) - - - - - - - -
72Tests warned : 3 ( 0.0%) ( 0.0%)
73Tests failed : 1 ( 0.0%) ( 0.0%)
74Expected fail : 25 ( 0.1%) ( 0.2%)
75Tests passed : 13138 ( 73.9%) ( 99.8%)
76
77Time taken : 166 seconds
78
79For 8.3.0:
80Number of tests : 18682 13904
81Tests skipped : 4778 ( 25.6%) - - - - - - - -
82Tests warned : 1 ( 0.0%) ( 0.0%)
83Tests failed : 8 ( 0.0%) ( 0.1%)
84Expected fail : 9 ( 0.0%) ( 0.1%)
85Tests passed : 13886 ( 74.3%) ( 99.9%)
86
87Time taken : 183 seconds
88
89For 8.3.1: [rahul] (Ryzen 7 1700)
90
91Number of tests : 18706 13767
92Tests skipped : 4939 ( 26.4%)
93Tests warned : 0 ( 0.0%) ( 0.0%)
94Tests failed : 1 ( 0.0%) ( 0.0%)
95Expected fail : 9 ( 0.0%) ( 0.1%)
96Tests passed : 13757 ( 73.5%) ( 99.9%)
97
98Time taken : 301 seconds
99
100-->
101
102]>
103
104<sect1 id="php" xreflabel="PHP-&php-version;">
105 <?dbhtml filename="php.html"?>
106
107
108 <title>PHP-&php-version;</title>
109
110 <indexterm zone="php">
111 <primary sortas="a-PHP">PHP</primary>
112 </indexterm>
113
114 <sect2 role="package">
115 <title>Introduction to PHP</title>
116
117 <para>
118 <application>PHP</application> is the PHP Hypertext Preprocessor.
119 Primarily used in dynamic web sites, it allows for programming code to be
120 directly embedded into the HTML markup. It is also useful as a
121 general purpose scripting language.
122 </para>
123
124 &lfs120_checked;
125
126 <bridgehead renderas="sect3">Package Information</bridgehead>
127 <itemizedlist spacing="compact">
128 <listitem>
129 <para>
130 Download (HTTP): <ulink url="&php-download-http;"/>
131 </para>
132 </listitem>
133 <listitem>
134 <para>
135 Download (FTP): <ulink url="&php-download-ftp;"/>
136 </para>
137 </listitem>
138 <listitem>
139 <para>
140 Download MD5 sum: &php-md5sum;
141 </para>
142 </listitem>
143 <listitem>
144 <para>
145 Download size: &php-size;
146 </para>
147 </listitem>
148 <listitem>
149 <para>
150 Estimated disk space required: &php-buildsize;
151 </para>
152 </listitem>
153 <listitem>
154 <para>
155 Estimated build time: &php-time;
156 </para>
157 </listitem>
158 </itemizedlist>
159
160 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
161 <itemizedlist spacing="compact">
162 <listitem>
163 <para>
164 Optional pre-built documentation (single file html): <ulink
165 url="https://www.php.net/distributions/manual/php_manual_en.html.gz"/>
166 </para>
167 </listitem>
168 <listitem>
169 <para>
170 Optional pre-built documentation (chunked html): <ulink
171 url="https://www.php.net/distributions/manual/php_manual_en.tar.gz"/>.
172 Note that the documentation can be found in languages other than
173 English at <ulink url="https://www.php.net/download-docs.php"/>
174 </para>
175 </listitem>
176 </itemizedlist>
177
178 <bridgehead renderas="sect3">PHP Dependencies</bridgehead>
179
180 <bridgehead renderas="sect4">Recommended</bridgehead>
181 <para role="recommended">
182 <xref linkend="apache"/> and
183 <xref linkend="libxml2"/>
184 </para>
185
186 <bridgehead renderas="sect4">Optional System Utilities and Libraries</bridgehead>
187 <para role="optional">
188 <xref linkend="aspell"/>,
189 <xref linkend="enchant"/>,
190 <xref linkend="libxslt"/>,
191 an <xref linkend="server-mail"/> (that provides a
192 <command>sendmail</command> command),
193 <xref linkend="pcre2"/>,
194 <xref linkend="pth"/>,
195 <ulink url="https://wiki.ubuntu.com/AppArmor">AppArmor</ulink>,
196 <ulink url="https://dmalloc.com/">Dmalloc</ulink>,
197 <ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>,
198 <ulink url="https://github.com/kkos/oniguruma">oniguruma</ulink>,
199 <ulink url="http://www.ossp.org/pkg/lib/mm/">OSSP mm</ulink>,
200 <ulink url="https://re2c.org/">re2c</ulink>, and
201 <ulink url="https://xmlrpc-epi.sourceforge.net/main.php?t=php_about">XMLRPC-EPI</ulink>
202 </para>
203
204 <bridgehead renderas="sect4">Optional Graphics Utilities and Libraries</bridgehead>
205 <para role="optional">
206 <xref linkend="freetype2"/>,
207 <xref linkend="libexif"/>,
208 <xref linkend="libjpeg"/>,
209 <xref linkend="libpng"/>,
210 <xref linkend="libtiff"/>,
211 <xref linkend="libwebp"/>,
212 <xref linkend="x-window-system"/>,
213 <!--<ulink url="http://www.fastio.com/">ClibPDF</ulink>, - site asks for username/password-->
214 <ulink url="https://opensource.adobe.com/dc-acrobat-sdk-docs/acrobatsdk/">FDF Toolkit</ulink>,
215 <ulink url="https://github.com/libgd/libgd">GD</ulink>, and
216 <ulink url="https://www.t1lib.org/">t1lib</ulink>
217 </para>
218
219 <bridgehead renderas="sect4">Optional Web Utilities</bridgehead>
220 <para role="optional">
221 <xref linkend="curl"/>,
222 <xref linkend="tidy-html5"/>,
223 <ulink url="https://sourceforge.net/projects/caudium/">Caudium</ulink>,
224 <ulink url="https://www.hyperwave.com/en/">Hyperwave</ulink>,
225 <ulink url="https://download.roxen.com/6.1/">Roxen WebServer</ulink>, and
226 <ulink url="https://github.com/Bilal-S/WDDX.net">WDDX</ulink>
227 </para>
228
229 <bridgehead renderas="sect4">Optional Data Management Utilities and Libraries</bridgehead>
230 <para role="optional">
231 <xref linkend="libiodbc"/>,
232 <xref linkend="lmdb"/>,
233 <xref linkend="mariadb"/> or <ulink url="https://www.mysql.com/">MySQL</ulink>,
234 <xref linkend="openldap"/>,
235 <xref linkend="postgresql"/>,
236 <xref linkend="sqlite"/>,
237 <xref linkend="unixodbc"/>,
238 &berkeley-db;
239 <ulink url="https://www.softwareag.com/en_corporate/platform/adabas-natural.html">Adabas</ulink>,
240 <ulink url="https://raima.com/product-overview/">Birdstep</ulink>,
241 <ulink url="https://cr.yp.to/cdb.html">cdb</ulink>,
242 <ulink url="https://www.dbmaker.com/">DBMaker</ulink>,
243 <ulink url="http://www.empress.com/">Empress</ulink>,
244 <ulink url="http://www.frontbase.com/cgi-bin/WebObjects/FBWebSite">FrontBase</ulink>,
245 <ulink url="https://www.ibm.com/analytics/us/en/db2/">IBM DB2</ulink>,
246 <ulink url="https://hughestech.com.au/products/msql/">Mini SQL</ulink>,
247 <ulink url="https://www.monetra.com/">Monetra</ulink>, and
248 <ulink url="https://sourceforge.net/projects/qdbm">QDBM</ulink>
249 </para>
250
251 <para>
252 <application>PHP</application> also provides support for many
253 commercial database tools such as <application>Oracle</application>,
254 <application>SAP</application> and
255 <application>ODBC Router</application>.
256 </para>
257
258 <bridgehead renderas="sect4">Optional Security/Encryption Utilities and Libraries</bridgehead>
259 <para role="optional">
260 <xref linkend="cyrus-sasl"/>,
261 <xref linkend="mitkrb"/>,
262 <ulink url="https://mcrypt.sourceforge.net/">libmcrypt</ulink>, and
263 <ulink url="https://mhash.sourceforge.net/">mhash</ulink>
264 </para>
265
266 <para condition="html" role="usernotes">
267 Editor Notes: <ulink url="&blfs-wiki;/php"/>
268 </para>
269
270 </sect2>
271
272 <sect2 role="installation">
273 <title>Installation of PHP</title>
274
275 <para>
276 You can use <application>PHP</application> for server-side
277 scripting, command-line scripting or client-side GUI applications. This
278 book provides instructions for setting up <application>PHP</application>
279 for server-side scripting as it is the most common form.
280 </para>
281
282 <note>
283 <para>
284 <application>PHP</application> has many more
285 <command>configure</command> options that will enable support for
286 various things. You can use <command>./configure --help</command> to
287 see a full list of the available options. Also, use of the
288 <ulink url="https://www.php.net/">PHP web site</ulink>
289 is highly recommended, as their online docs are very good. An example
290 of a <command>configure</command> command that utilizes many of the
291 most common dependencies can be found at <ulink
292 url="&sources-anduin-http;/files/php_configure.txt"/>.
293 </para>
294
295 <para>
296 If, for whatever reason, you don't have <xref linkend="libxml2"/>
297 installed, you need to add <option>--disable-libxml</option> to the
298 <command>configure</command> command in the instructions below. Note
299 that this will prevent the <command>pear</command> command from being
300 built.
301 </para>
302 </note>
303
304 <para>
305 Install <application>PHP</application> by running the following commands:
306 </para>
307
308<screen revision="sysv"><userinput>./configure --prefix=/usr \
309 --sysconfdir=/etc \
310 --localstatedir=/var \
311 --datadir=/usr/share/php \
312 --mandir=/usr/share/man \
313 --without-pear \
314 --enable-fpm \
315 --with-fpm-user=apache \
316 --with-fpm-group=apache \
317 --with-config-file-path=/etc \
318 --with-zlib \
319 --enable-bcmath \
320 --with-bz2 \
321 --enable-calendar \
322 --enable-dba=shared \
323 --with-gdbm \
324 --with-gmp \
325 --enable-ftp \
326 --with-gettext \
327 --enable-mbstring \
328 --disable-mbregex \
329 --with-readline &amp;&amp;
330make</userinput></screen>
331
332<screen revision="systemd"><userinput>./configure --prefix=/usr \
333 --sysconfdir=/etc \
334 --localstatedir=/var \
335 --datadir=/usr/share/php \
336 --mandir=/usr/share/man \
337 --enable-fpm \
338 --without-pear \
339 --with-fpm-user=apache \
340 --with-fpm-group=apache \
341 --with-fpm-systemd \
342 --with-config-file-path=/etc \
343 --with-zlib \
344 --enable-bcmath \
345 --with-bz2 \
346 --enable-calendar \
347 --enable-dba=shared \
348 --with-gdbm \
349 --with-gmp \
350 --enable-ftp \
351 --with-gettext \
352 --enable-mbstring \
353 --disable-mbregex \
354 --with-readline &amp;&amp;
355make</userinput></screen>
356 <para>
357 To test the results, issue: <command>make test</command>. Several
358 tests (out of over 18000) may fail, in which case you are asked
359 whether you want to send the report to the PHP developers. If you
360 want to automate the test, you may prefix the command with
361 <command>yes "n" | </command>.
362 </para>
363
364 <para>
365 Now, as the <systemitem class="username">root</systemitem> user:
366 </para>
367
368<!-- dev note: make INSTALL_ROOT=<DESTDIR> install -->
369
370<screen role="root"><userinput>make install &amp;&amp;
371install -v -m644 php.ini-production /etc/php.ini &amp;&amp;
372
373install -v -m755 -d /usr/share/doc/php-&php-version; &amp;&amp;
374install -v -m644 CODING_STANDARDS* EXTENSIONS NEWS README* UPGRADING* \
375 /usr/share/doc/php-&php-version;</userinput></screen>
376
377 <para>
378 The default configuration files for the fastCGI process manager are
379 installed only if they do not already exist on the system. If this is
380 the first installation, they should be renamed, as the
381 <systemitem class='username'>root</systemitem> user:
382 </para>
383
384<screen role="root"><userinput>if [ -f /etc/php-fpm.conf.default ]; then
385 mv -v /etc/php-fpm.conf{.default,} &amp;&amp;
386 mv -v /etc/php-fpm.d/www.conf{.default,}
387fi</userinput></screen>
388
389 <para>
390 The pre-built HTML documentation is packaged in two forms: a tarball
391 containing many individual files, useful for quick loading into your
392 browser, and one large individual file, which is useful for using the
393 search utility of your browser. If you downloaded either, or both, of the
394 documentation files, issue the following commands as the
395 <systemitem class='username'>root</systemitem> user to install them (note
396 these instructions assume English docs, modify the tarball names below if
397 necessary).
398 </para>
399
400 <para>
401 For the <quote>Single HTML</quote> file:
402 </para>
403
404<screen role="root"><userinput>install -v -m644 ../php_manual_en.html.gz \
405 /usr/share/doc/php-&php-version; &amp;&amp;
406gunzip -v /usr/share/doc/php-&php-version;/php_manual_en.html.gz</userinput></screen>
407
408 <para>
409 For the <quote>Many HTML files</quote> tarball:
410 </para>
411
412<screen role="root"><userinput>tar -xvf ../php_manual_en.tar.gz \
413 -C /usr/share/doc/php-&php-version; --no-same-owner</userinput></screen>
414
415 <para>
416 The bundled pear is not installed because of a bug which might
417 pollute the filesystem with several hidden files and directories.
418 If pear is needed, execute the following commands to install it:
419 </para>
420
421<screen role="nodump"><userinput>wget https://pear.php.net/go-pear.phar
422php ./go-pear.phar</userinput></screen>
423
424 </sect2>
425
426 <sect2 role="commands">
427 <title>Command Explanations</title>
428
429 <para>
430 <parameter>--datadir=/usr/share/php</parameter>: This works
431 around a bug in the build machinery, which installs some data to a
432 wrong location.
433 </para>
434
435 <para>
436 <parameter>--enable-fpm</parameter>: This parameter allows
437 building the fastCGI Process Manager.
438 </para>
439
440 <para revision="systemd">
441 <parameter>--with-fpm-systemd</parameter>: This parameter allows
442 the FastCGI Process Manager to integrate with systemd.
443 </para>
444
445 <para>
446 <parameter>--without-pear</parameter>: This switch disables
447 installation of bundled pear software.
448 </para>
449
450 <para>
451 <parameter>--with-config-file-path=/etc</parameter>: This parameter
452 makes <application>PHP</application> look for the
453 <filename>php.ini</filename> configuration file in
454 <filename class='directory'>/etc</filename>.
455 </para>
456
457 <para>
458 <parameter>--with-zlib</parameter>: This parameter adds
459 support for <application>Zlib</application> compression.
460 </para>
461
462 <para>
463 <parameter>--enable-bcmath</parameter>: Enables
464 <command>bc</command> style precision math functions.
465 </para>
466
467 <para>
468 <parameter>--with-bz2</parameter>: Adds support for
469 <application>Bzip2</application> compression functions.
470 </para>
471
472 <para>
473 <parameter>--enable-calendar</parameter>: This parameter
474 provides support for calendar conversion.
475 </para>
476
477 <para>
478 <parameter>--enable-dba=shared</parameter>: This parameter enables
479 support for database (dbm-style) abstraction layer functions.
480 </para>
481
482 <para>
483 <parameter>--enable-ftp</parameter>: This parameter
484 enables FTP functions.
485 </para>
486
487 <para>
488 <parameter>--with-gettext</parameter>: Enables functions
489 that use <application>Gettext</application> text translation.
490 </para>
491
492 <para>
493 <parameter>--enable-mbstring</parameter>: This parameter
494 enables multibyte string support.
495 </para>
496
497<!--
498 <para>
499 <parameter>- -disable-mbstring</parameter>: This parameter
500 disables multibyte string regular expression support. It
501 requires the external
502 <ulink url="https://github.com/kkos/oniguruma">oniguruma</ulink>
503 library.
504 </para>
505-->
506 <para>
507 <parameter>--with-readline</parameter>: This parameter
508 enables command line <application>Readline</application> support.
509 </para>
510
511 <para>
512 <option>--disable-libxml</option>: This option
513 allows building PHP without <application>libxml2</application>
514 installed.
515 </para>
516
517 <para>
518 <option>--with-apxs2</option>: Instead of building the fastCGI process
519 manager, it is possible to build an <application>apache</application>
520 module. This has some performance penalty for heavy loaded servers,
521 but may be easier to set up. This switch is incompatible with the
522 <parameter>--enable-fpm</parameter> and
523 <parameter>--with-fpm-...</parameter> switches.
524 </para>
525
526 <para>
527 <option>--with-mysqli=shared</option>: This option includes MySQLi
528 support.
529 </para>
530
531 <para>
532 <option>--with-mysql-sock=/run/mysqld/mysqld.sock</option>: Location of
533 the MySQL unix socket pointer.
534 </para>
535
536 <para>
537 <option>--with-pdo-mysql=shared</option>: This option includes PDO:
538 MySQL support.
539 </para>
540
541 <para>
542 <option>--with-tidy=shared</option>: This option includes tidy library
543 support.
544 </para>
545
546 </sect2>
547
548 <sect2 role="configuration">
549 <title>Configuring PHP</title>
550
551 <sect3 id="php-config">
552 <title>Config Files</title>
553
554 <para>
555 <filename>/etc/php.ini</filename>,
556 <filename>/etc/pear.conf</filename>,
557 <filename>/etc/php-fpm.conf</filename>, and
558 <filename>/etc/php-fpm.d/www.conf</filename>
559 </para>
560
561 <indexterm zone="php php-config">
562 <primary sortas="e-etc-php.ini">/etc/php.ini</primary>
563 </indexterm>
564
565 <indexterm zone="php php-config">
566 <primary sortas="e-etc-pear.conf">/etc/pear.conf</primary>
567 </indexterm>
568
569 <indexterm zone="php php-config">
570 <primary sortas="e-etc-php-fpm.d-www.conf">
571 /etc/php-fpm.d/www.conf</primary>
572 </indexterm>
573
574 <indexterm zone="php php-config">
575 <primary sortas="e-etc-php-fpm.conf">/etc/php-fpm.conf</primary>
576 </indexterm>
577
578 </sect3>
579
580 <sect3>
581 <title>Configuration Information</title>
582
583 <para>
584 The file used as the default <filename>/etc/php.ini</filename>
585 configuration file is recommended by the <application>PHP</application>
586 development team. This file modifies the default behavior of
587 <application>PHP</application>. If no <filename>/etc/php.ini</filename>
588 is used, all configuration settings fall to the defaults. You should
589 review the comments in this file and ensure the changes are acceptable
590 in your particular environment.
591 </para>
592
593 <para>
594 The fastCGI process manager uses the configuration file
595 <filename>/etc/php-fpm.conf</filename>. The default file shipped with
596 PHP includes all the <filename>/etc/php-fpm.d/*.conf</filename> in turn.
597 There is a shipped <filename>/etc/php-fpm.d/www.conf</filename> file,
598 that contains the parameters related to the interaction with the Apache
599 Web server.
600 </para>
601
602 <para>
603 You may have noticed the following from the output of the
604 <command>make install</command> command:
605 </para>
606
607<screen><computeroutput>You may want to add: /usr/lib/php to your php.ini include_path</computeroutput></screen>
608
609 <para>
610 If desired, add the entry using the following command as the
611 <systemitem class="username">root</systemitem> user:
612 </para>
613
614<screen role="root"><userinput>sed -i 's@php/includes"@&amp;\ninclude_path = ".:/usr/lib/php"@' \
615 /etc/php.ini</userinput></screen>
616
617 <para>
618 To enable fastCGI support in the <application>Apache</application>
619 web server, two LoadModule directives must be added to the
620 <filename>httpd.conf</filename> file. They are commented out, so just
621 issue the following command as
622 <systemitem class="username">root</systemitem> user:
623 </para>
624
625<screen role="root"><userinput>sed -i -e '/proxy_module/s/^#//' \
626 -e '/proxy_fcgi_module/s/^#//' \
627 /etc/httpd/httpd.conf</userinput></screen>
628
629 <para>
630 Those modules accept various <command>ProxyPass</command>
631 directives. One possibility is (as the
632 <systemitem class="username">root</systemitem> user):
633 </para>
634
635<screen role="root"><userinput>echo \
636'ProxyPassMatch ^/(.*\.php)$ fcgi://127.0.0.1:9000/srv/www/$1' >> \
637/etc/httpd/httpd.conf</userinput></screen>
638
639 <para>
640 Additionally, it may be useful to add an entry for
641 <filename>index.php</filename> to the DirectoryIndex directive of the
642 <filename>httpd.conf</filename> file. Lastly, adding a line to set up the
643 <filename class='extension'>.phps</filename> extension to show
644 highlighted <application>PHP</application> source may be
645 desirable:
646 </para>
647
648<screen><literal>AddType application/x-httpd-php-source .phps</literal></screen>
649
650 <para>
651 You'll need to restart the <application>Apache</application> web server
652 after making any modifications to the <filename>httpd.conf</filename>
653 file.
654 </para>
655
656 </sect3>
657
658 <sect3 id="php-init">
659 <title><phrase revision="sysv">Boot Script</phrase>
660 <phrase revision="systemd">Systemd Unit</phrase></title>
661
662 <para revision="sysv">
663 To automatically start the <command>php-fpm</command> daemon when the
664 system is rebooted, install the
665 <filename>/etc/rc.d/init.d/php</filename> bootscript from the
666 <xref linkend="bootscripts"/> package as the
667 <systemitem class="username">root</systemitem> user:
668 </para>
669
670 <para revision="systemd">
671 To start the <command>php-fpm</command> daemon at boot,
672 install the systemd unit from the <xref linkend="systemd-units"/>
673 package by running the following command as the
674 <systemitem class="username">root</systemitem> user:
675 </para>
676
677
678 <indexterm zone="php php-init">
679 <primary sortas="f-php">php</primary>
680 </indexterm>
681
682<screen role="root" revision="sysv"><userinput>make install-php</userinput></screen>
683
684<screen role="root" revision="systemd"><userinput>make install-php-fpm</userinput></screen>
685
686 </sect3>
687
688 </sect2>
689
690 <sect2 role="content">
691 <title>Contents</title>
692
693 <segmentedlist>
694 <segtitle>Installed Programs</segtitle>
695 <segtitle>Installed Libraries</segtitle>
696 <segtitle>Installed Directories</segtitle>
697
698 <seglistitem>
699 <seg><!-- not built anymore pear, peardev, pecl,-->
700 phar (symlink), phar.phar, php,
701 php-cgi, php-config, php-fpm, phpdbg, and phpize</seg>
702
703 <seg>dba.so and opcache.so in
704 /usr/lib/php/extensions/no-debug-non-zts-20220829</seg>
705
706 <seg>/etc/php-fpm.d, /usr/{include,lib,share}/php, and
707 /usr/share/doc/php-&php-version;</seg>
708 </seglistitem>
709 </segmentedlist>
710
711 <variablelist>
712 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
713 <?dbfo list-presentation="list"?>
714 <?dbhtml list-presentation="table"?>
715
716 <varlistentry id="php-prog">
717 <term><command>php</command></term>
718 <listitem>
719 <para>
720 is a command line interface that enables you to parse and
721 execute PHP code
722 </para>
723 <indexterm zone="php php-prog">
724 <primary sortas="b-php">php</primary>
725 </indexterm>
726 </listitem>
727 </varlistentry>
728
729 <varlistentry id="pear">
730 <term><command>pear</command></term>
731 <listitem>
732 <para>
733 is the PHP Extension and Application Repository (PEAR) package
734 manager. This isn't installed by default
735 </para>
736 <indexterm zone="php pear">
737 <primary sortas="b-pear">pear</primary>
738 </indexterm>
739 </listitem>
740 </varlistentry>
741
742 <varlistentry id="php-fpm">
743 <term><command>php-fpm</command></term>
744 <listitem>
745 <para>
746 is the fastCGI process manager for PHP
747 </para>
748 <indexterm zone="php php-fpm">
749 <primary sortas="b-php-fpm">php-fpm</primary>
750 </indexterm>
751 </listitem>
752 </varlistentry>
753
754 <varlistentry id="phpdbg">
755 <term><command>phpdbg</command></term>
756 <listitem>
757 <para>
758 is the interactive PHP debugger
759 </para>
760 <indexterm zone="php phpdbg">
761 <primary sortas="b-phpdbg">phpdbg</primary>
762 </indexterm>
763 </listitem>
764 </varlistentry>
765
766 </variablelist>
767
768 </sect2>
769
770</sect1>
Note: See TracBrowser for help on using the repository browser.