source: general/prog/php.xml@ 07f3f60

12.1 ken/TL2024 lazarus trunk xry111/llvm18
Last change on this file since 07f3f60 was 4671375, checked in by Bruce Dubbs <bdubbs@…>, 4 months ago

Archive pth.
  • 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 <ulink url="https://wiki.ubuntu.com/AppArmor">AppArmor</ulink>,
195 <ulink url="https://dmalloc.com/">Dmalloc</ulink>,
196 <ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>,
197 <ulink url="https://github.com/kkos/oniguruma">oniguruma</ulink>,
198 <ulink url="http://www.ossp.org/pkg/lib/mm/">OSSP mm</ulink>,
199 <ulink url="https://re2c.org/">re2c</ulink>, and
200 <ulink url="https://xmlrpc-epi.sourceforge.net/main.php?t=php_about">XMLRPC-EPI</ulink>
201 </para>
202
203 <bridgehead renderas="sect4">Optional Graphics Utilities and Libraries</bridgehead>
204 <para role="optional">
205 <xref linkend="freetype2"/>,
206 <xref linkend="libexif"/>,
207 <xref linkend="libjpeg"/>,
208 <xref linkend="libpng"/>,
209 <xref linkend="libtiff"/>,
210 <xref linkend="libwebp"/>,
211 <xref linkend="x-window-system"/>,
212 <!--<ulink url="http://www.fastio.com/">ClibPDF</ulink>, - site asks for username/password-->
213 <ulink url="https://opensource.adobe.com/dc-acrobat-sdk-docs/acrobatsdk/">FDF Toolkit</ulink>,
214 <ulink url="https://github.com/libgd/libgd">GD</ulink>, and
215 <ulink url="https://www.t1lib.org/">t1lib</ulink>
216 </para>
217
218 <bridgehead renderas="sect4">Optional Web Utilities</bridgehead>
219 <para role="optional">
220 <xref linkend="curl"/>,
221 <xref linkend="tidy-html5"/>,
222 <ulink url="https://sourceforge.net/projects/caudium/">Caudium</ulink>,
223 <ulink url="https://www.hyperwave.com/en/">Hyperwave</ulink>,
224 <ulink url="https://download.roxen.com/6.1/">Roxen WebServer</ulink>, and
225 <ulink url="https://github.com/Bilal-S/WDDX.net">WDDX</ulink>
226 </para>
227
228 <bridgehead renderas="sect4">Optional Data Management Utilities and Libraries</bridgehead>
229 <para role="optional">
230 <xref linkend="libiodbc"/>,
231 <xref linkend="lmdb"/>,
232 <xref linkend="mariadb"/> or <ulink url="https://www.mysql.com/">MySQL</ulink>,
233 <xref linkend="openldap"/>,
234 <xref linkend="postgresql"/>,
235 <xref linkend="sqlite"/>,
236 <xref linkend="unixodbc"/>,
237 &berkeley-db;
238 <ulink url="https://www.softwareag.com/en_corporate/platform/adabas-natural.html">Adabas</ulink>,
239 <ulink url="https://raima.com/product-overview/">Birdstep</ulink>,
240 <ulink url="https://cr.yp.to/cdb.html">cdb</ulink>,
241 <ulink url="https://www.dbmaker.com/">DBMaker</ulink>,
242 <ulink url="http://www.empress.com/">Empress</ulink>,
243 <ulink url="http://www.frontbase.com/cgi-bin/WebObjects/FBWebSite">FrontBase</ulink>,
244 <ulink url="https://www.ibm.com/analytics/us/en/db2/">IBM DB2</ulink>,
245 <ulink url="https://hughestech.com.au/products/msql/">Mini SQL</ulink>,
246 <ulink url="https://www.monetra.com/">Monetra</ulink>, and
247 <ulink url="https://sourceforge.net/projects/qdbm">QDBM</ulink>
248 </para>
249
250 <para>
251 <application>PHP</application> also provides support for many
252 commercial database tools such as <application>Oracle</application>,
253 <application>SAP</application> and
254 <application>ODBC Router</application>.
255 </para>
256
257 <bridgehead renderas="sect4">Optional Security/Encryption Utilities and Libraries</bridgehead>
258 <para role="optional">
259 <xref linkend="cyrus-sasl"/>,
260 <xref linkend="mitkrb"/>,
261 <ulink url="https://mcrypt.sourceforge.net/">libmcrypt</ulink>, and
262 <ulink url="https://mhash.sourceforge.net/">mhash</ulink>
263 </para>
264
265 <para condition="html" role="usernotes">
266 Editor Notes: <ulink url="&blfs-wiki;/php"/>
267 </para>
268
269 </sect2>
270
271 <sect2 role="installation">
272 <title>Installation of PHP</title>
273
274 <para>
275 You can use <application>PHP</application> for server-side
276 scripting, command-line scripting or client-side GUI applications. This
277 book provides instructions for setting up <application>PHP</application>
278 for server-side scripting as it is the most common form.
279 </para>
280
281 <note>
282 <para>
283 <application>PHP</application> has many more
284 <command>configure</command> options that will enable support for
285 various things. You can use <command>./configure --help</command> to
286 see a full list of the available options. Also, use of the
287 <ulink url="https://www.php.net/">PHP web site</ulink>
288 is highly recommended, as their online docs are very good. An example
289 of a <command>configure</command> command that utilizes many of the
290 most common dependencies can be found at <ulink
291 url="&sources-anduin-http;/files/php_configure.txt"/>.
292 </para>
293
294 <para>
295 If, for whatever reason, you don't have <xref linkend="libxml2"/>
296 installed, you need to add <option>--disable-libxml</option> to the
297 <command>configure</command> command in the instructions below. Note
298 that this will prevent the <command>pear</command> command from being
299 built.
300 </para>
301 </note>
302
303 <para>
304 Install <application>PHP</application> by running the following commands:
305 </para>
306
307<screen revision="sysv"><userinput>./configure --prefix=/usr \
308 --sysconfdir=/etc \
309 --localstatedir=/var \
310 --datadir=/usr/share/php \
311 --mandir=/usr/share/man \
312 --without-pear \
313 --enable-fpm \
314 --with-fpm-user=apache \
315 --with-fpm-group=apache \
316 --with-config-file-path=/etc \
317 --with-zlib \
318 --enable-bcmath \
319 --with-bz2 \
320 --enable-calendar \
321 --enable-dba=shared \
322 --with-gdbm \
323 --with-gmp \
324 --enable-ftp \
325 --with-gettext \
326 --enable-mbstring \
327 --disable-mbregex \
328 --with-readline &amp;&amp;
329make</userinput></screen>
330
331<screen revision="systemd"><userinput>./configure --prefix=/usr \
332 --sysconfdir=/etc \
333 --localstatedir=/var \
334 --datadir=/usr/share/php \
335 --mandir=/usr/share/man \
336 --enable-fpm \
337 --without-pear \
338 --with-fpm-user=apache \
339 --with-fpm-group=apache \
340 --with-fpm-systemd \
341 --with-config-file-path=/etc \
342 --with-zlib \
343 --enable-bcmath \
344 --with-bz2 \
345 --enable-calendar \
346 --enable-dba=shared \
347 --with-gdbm \
348 --with-gmp \
349 --enable-ftp \
350 --with-gettext \
351 --enable-mbstring \
352 --disable-mbregex \
353 --with-readline &amp;&amp;
354make</userinput></screen>
355 <para>
356 To test the results, issue: <command>make test</command>. Several
357 tests (out of over 18000) may fail, in which case you are asked
358 whether you want to send the report to the PHP developers. If you
359 want to automate the test, you may prefix the command with
360 <command>yes "n" | </command>.
361 </para>
362
363 <para>
364 Now, as the <systemitem class="username">root</systemitem> user:
365 </para>
366
367<!-- dev note: make INSTALL_ROOT=<DESTDIR> install -->
368
369<screen role="root"><userinput>make install &amp;&amp;
370install -v -m644 php.ini-production /etc/php.ini &amp;&amp;
371
372install -v -m755 -d /usr/share/doc/php-&php-version; &amp;&amp;
373install -v -m644 CODING_STANDARDS* EXTENSIONS NEWS README* UPGRADING* \
374 /usr/share/doc/php-&php-version;</userinput></screen>
375
376 <para>
377 The default configuration files for the fastCGI process manager are
378 installed only if they do not already exist on the system. If this is
379 the first installation, they should be renamed, as the
380 <systemitem class='username'>root</systemitem> user:
381 </para>
382
383<screen role="root"><userinput>if [ -f /etc/php-fpm.conf.default ]; then
384 mv -v /etc/php-fpm.conf{.default,} &amp;&amp;
385 mv -v /etc/php-fpm.d/www.conf{.default,}
386fi</userinput></screen>
387
388 <para>
389 The pre-built HTML documentation is packaged in two forms: a tarball
390 containing many individual files, useful for quick loading into your
391 browser, and one large individual file, which is useful for using the
392 search utility of your browser. If you downloaded either, or both, of the
393 documentation files, issue the following commands as the
394 <systemitem class='username'>root</systemitem> user to install them (note
395 these instructions assume English docs, modify the tarball names below if
396 necessary).
397 </para>
398
399 <para>
400 For the <quote>Single HTML</quote> file:
401 </para>
402
403<screen role="root"><userinput>install -v -m644 ../php_manual_en.html.gz \
404 /usr/share/doc/php-&php-version; &amp;&amp;
405gunzip -v /usr/share/doc/php-&php-version;/php_manual_en.html.gz</userinput></screen>
406
407 <para>
408 For the <quote>Many HTML files</quote> tarball:
409 </para>
410
411<screen role="root"><userinput>tar -xvf ../php_manual_en.tar.gz \
412 -C /usr/share/doc/php-&php-version; --no-same-owner</userinput></screen>
413
414 <para>
415 The bundled pear is not installed because of a bug which might
416 pollute the filesystem with several hidden files and directories.
417 If pear is needed, execute the following commands to install it:
418 </para>
419
420<screen role="nodump"><userinput>wget https://pear.php.net/go-pear.phar
421php ./go-pear.phar</userinput></screen>
422
423 </sect2>
424
425 <sect2 role="commands">
426 <title>Command Explanations</title>
427
428 <para>
429 <parameter>--datadir=/usr/share/php</parameter>: This works
430 around a bug in the build machinery, which installs some data to a
431 wrong location.
432 </para>
433
434 <para>
435 <parameter>--enable-fpm</parameter>: This parameter allows
436 building the fastCGI Process Manager.
437 </para>
438
439 <para revision="systemd">
440 <parameter>--with-fpm-systemd</parameter>: This parameter allows
441 the FastCGI Process Manager to integrate with systemd.
442 </para>
443
444 <para>
445 <parameter>--without-pear</parameter>: This switch disables
446 installation of bundled pear software.
447 </para>
448
449 <para>
450 <parameter>--with-config-file-path=/etc</parameter>: This parameter
451 makes <application>PHP</application> look for the
452 <filename>php.ini</filename> configuration file in
453 <filename class='directory'>/etc</filename>.
454 </para>
455
456 <para>
457 <parameter>--with-zlib</parameter>: This parameter adds
458 support for <application>Zlib</application> compression.
459 </para>
460
461 <para>
462 <parameter>--enable-bcmath</parameter>: Enables
463 <command>bc</command> style precision math functions.
464 </para>
465
466 <para>
467 <parameter>--with-bz2</parameter>: Adds support for
468 <application>Bzip2</application> compression functions.
469 </para>
470
471 <para>
472 <parameter>--enable-calendar</parameter>: This parameter
473 provides support for calendar conversion.
474 </para>
475
476 <para>
477 <parameter>--enable-dba=shared</parameter>: This parameter enables
478 support for database (dbm-style) abstraction layer functions.
479 </para>
480
481 <para>
482 <parameter>--enable-ftp</parameter>: This parameter
483 enables FTP functions.
484 </para>
485
486 <para>
487 <parameter>--with-gettext</parameter>: Enables functions
488 that use <application>Gettext</application> text translation.
489 </para>
490
491 <para>
492 <parameter>--enable-mbstring</parameter>: This parameter
493 enables multibyte string support.
494 </para>
495
496<!--
497 <para>
498 <parameter>- -disable-mbstring</parameter>: This parameter
499 disables multibyte string regular expression support. It
500 requires the external
501 <ulink url="https://github.com/kkos/oniguruma">oniguruma</ulink>
502 library.
503 </para>
504-->
505 <para>
506 <parameter>--with-readline</parameter>: This parameter
507 enables command line <application>Readline</application> support.
508 </para>
509
510 <para>
511 <option>--disable-libxml</option>: This option
512 allows building PHP without <application>libxml2</application>
513 installed.
514 </para>
515
516 <para>
517 <option>--with-apxs2</option>: Instead of building the fastCGI process
518 manager, it is possible to build an <application>apache</application>
519 module. This has some performance penalty for heavy loaded servers,
520 but may be easier to set up. This switch is incompatible with the
521 <parameter>--enable-fpm</parameter> and
522 <parameter>--with-fpm-...</parameter> switches.
523 </para>
524
525 <para>
526 <option>--with-mysqli=shared</option>: This option includes MySQLi
527 support.
528 </para>
529
530 <para>
531 <option>--with-mysql-sock=/run/mysqld/mysqld.sock</option>: Location of
532 the MySQL unix socket pointer.
533 </para>
534
535 <para>
536 <option>--with-pdo-mysql=shared</option>: This option includes PDO:
537 MySQL support.
538 </para>
539
540 <para>
541 <option>--with-tidy=shared</option>: This option includes tidy library
542 support.
543 </para>
544
545 </sect2>
546
547 <sect2 role="configuration">
548 <title>Configuring PHP</title>
549
550 <sect3 id="php-config">
551 <title>Config Files</title>
552
553 <para>
554 <filename>/etc/php.ini</filename>,
555 <filename>/etc/pear.conf</filename>,
556 <filename>/etc/php-fpm.conf</filename>, and
557 <filename>/etc/php-fpm.d/www.conf</filename>
558 </para>
559
560 <indexterm zone="php php-config">
561 <primary sortas="e-etc-php.ini">/etc/php.ini</primary>
562 </indexterm>
563
564 <indexterm zone="php php-config">
565 <primary sortas="e-etc-pear.conf">/etc/pear.conf</primary>
566 </indexterm>
567
568 <indexterm zone="php php-config">
569 <primary sortas="e-etc-php-fpm.d-www.conf">
570 /etc/php-fpm.d/www.conf</primary>
571 </indexterm>
572
573 <indexterm zone="php php-config">
574 <primary sortas="e-etc-php-fpm.conf">/etc/php-fpm.conf</primary>
575 </indexterm>
576
577 </sect3>
578
579 <sect3>
580 <title>Configuration Information</title>
581
582 <para>
583 The file used as the default <filename>/etc/php.ini</filename>
584 configuration file is recommended by the <application>PHP</application>
585 development team. This file modifies the default behavior of
586 <application>PHP</application>. If no <filename>/etc/php.ini</filename>
587 is used, all configuration settings fall to the defaults. You should
588 review the comments in this file and ensure the changes are acceptable
589 in your particular environment.
590 </para>
591
592 <para>
593 The fastCGI process manager uses the configuration file
594 <filename>/etc/php-fpm.conf</filename>. The default file shipped with
595 PHP includes all the <filename>/etc/php-fpm.d/*.conf</filename> in turn.
596 There is a shipped <filename>/etc/php-fpm.d/www.conf</filename> file,
597 that contains the parameters related to the interaction with the Apache
598 Web server.
599 </para>
600
601 <para>
602 You may have noticed the following from the output of the
603 <command>make install</command> command:
604 </para>
605
606<screen><computeroutput>You may want to add: /usr/lib/php to your php.ini include_path</computeroutput></screen>
607
608 <para>
609 If desired, add the entry using the following command as the
610 <systemitem class="username">root</systemitem> user:
611 </para>
612
613<screen role="root"><userinput>sed -i 's@php/includes"@&amp;\ninclude_path = ".:/usr/lib/php"@' \
614 /etc/php.ini</userinput></screen>
615
616 <para>
617 To enable fastCGI support in the <application>Apache</application>
618 web server, two LoadModule directives must be added to the
619 <filename>httpd.conf</filename> file. They are commented out, so just
620 issue the following command as
621 <systemitem class="username">root</systemitem> user:
622 </para>
623
624<screen role="root"><userinput>sed -i -e '/proxy_module/s/^#//' \
625 -e '/proxy_fcgi_module/s/^#//' \
626 /etc/httpd/httpd.conf</userinput></screen>
627
628 <para>
629 Those modules accept various <command>ProxyPass</command>
630 directives. One possibility is (as the
631 <systemitem class="username">root</systemitem> user):
632 </para>
633
634<screen role="root"><userinput>echo \
635'ProxyPassMatch ^/(.*\.php)$ fcgi://127.0.0.1:9000/srv/www/$1' >> \
636/etc/httpd/httpd.conf</userinput></screen>
637
638 <para>
639 Additionally, it may be useful to add an entry for
640 <filename>index.php</filename> to the DirectoryIndex directive of the
641 <filename>httpd.conf</filename> file. Lastly, adding a line to set up the
642 <filename class='extension'>.phps</filename> extension to show
643 highlighted <application>PHP</application> source may be
644 desirable:
645 </para>
646
647<screen><literal>AddType application/x-httpd-php-source .phps</literal></screen>
648
649 <para>
650 You'll need to restart the <application>Apache</application> web server
651 after making any modifications to the <filename>httpd.conf</filename>
652 file.
653 </para>
654
655 </sect3>
656
657 <sect3 id="php-init">
658 <title><phrase revision="sysv">Boot Script</phrase>
659 <phrase revision="systemd">Systemd Unit</phrase></title>
660
661 <para revision="sysv">
662 To automatically start the <command>php-fpm</command> daemon when the
663 system is rebooted, install the
664 <filename>/etc/rc.d/init.d/php</filename> bootscript from the
665 <xref linkend="bootscripts"/> package as the
666 <systemitem class="username">root</systemitem> user:
667 </para>
668
669 <para revision="systemd">
670 To start the <command>php-fpm</command> daemon at boot,
671 install the systemd unit from the <xref linkend="systemd-units"/>
672 package by running the following command as the
673 <systemitem class="username">root</systemitem> user:
674 </para>
675
676
677 <indexterm zone="php php-init">
678 <primary sortas="f-php">php</primary>
679 </indexterm>
680
681<screen role="root" revision="sysv"><userinput>make install-php</userinput></screen>
682
683<screen role="root" revision="systemd"><userinput>make install-php-fpm</userinput></screen>
684
685 </sect3>
686
687 </sect2>
688
689 <sect2 role="content">
690 <title>Contents</title>
691
692 <segmentedlist>
693 <segtitle>Installed Programs</segtitle>
694 <segtitle>Installed Libraries</segtitle>
695 <segtitle>Installed Directories</segtitle>
696
697 <seglistitem>
698 <seg><!-- not built anymore pear, peardev, pecl,-->
699 phar (symlink), phar.phar, php,
700 php-cgi, php-config, php-fpm, phpdbg, and phpize</seg>
701
702 <seg>dba.so and opcache.so in
703 /usr/lib/php/extensions/no-debug-non-zts-20220829</seg>
704
705 <seg>/etc/php-fpm.d, /usr/{include,lib,share}/php, and
706 /usr/share/doc/php-&php-version;</seg>
707 </seglistitem>
708 </segmentedlist>
709
710 <variablelist>
711 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
712 <?dbfo list-presentation="list"?>
713 <?dbhtml list-presentation="table"?>
714
715 <varlistentry id="php-prog">
716 <term><command>php</command></term>
717 <listitem>
718 <para>
719 is a command line interface that enables you to parse and
720 execute PHP code
721 </para>
722 <indexterm zone="php php-prog">
723 <primary sortas="b-php">php</primary>
724 </indexterm>
725 </listitem>
726 </varlistentry>
727
728 <varlistentry id="pear">
729 <term><command>pear</command></term>
730 <listitem>
731 <para>
732 is the PHP Extension and Application Repository (PEAR) package
733 manager. This isn't installed by default
734 </para>
735 <indexterm zone="php pear">
736 <primary sortas="b-pear">pear</primary>
737 </indexterm>
738 </listitem>
739 </varlistentry>
740
741 <varlistentry id="php-fpm">
742 <term><command>php-fpm</command></term>
743 <listitem>
744 <para>
745 is the fastCGI process manager for PHP
746 </para>
747 <indexterm zone="php php-fpm">
748 <primary sortas="b-php-fpm">php-fpm</primary>
749 </indexterm>
750 </listitem>
751 </varlistentry>
752
753 <varlistentry id="phpdbg">
754 <term><command>phpdbg</command></term>
755 <listitem>
756 <para>
757 is the interactive PHP debugger
758 </para>
759 <indexterm zone="php phpdbg">
760 <primary sortas="b-phpdbg">phpdbg</primary>
761 </indexterm>
762 </listitem>
763 </varlistentry>
764
765 </variablelist>
766
767 </sect2>
768
769</sect1>
Note: See TracBrowser for help on using the repository browser.