-
Notifications
You must be signed in to change notification settings - Fork 708
/
configure.xml
157 lines (154 loc) · 4.96 KB
/
configure.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="image.installation" xmlns="http://docbook.org/ns/docbook">
&reftitle.install;
<para>
To enable GD-support configure PHP
<option role="configure">--with-gd[=DIR]</option>, where DIR is the GD base
install directory. To use the recommended bundled version of the GD library,
use the configure option
<option role="configure">--with-gd</option>.
GD library requires <productname>libpng</productname> and
<productname>libjpeg</productname> to compile.
As of PHP 7.4.0, <option role="configure">--with-gd</option> becomes
<option role="configure">--enable-gd</option> (whether to enable the
extension at all) and <option role="configure">--with-external-gd</option>
(to opt into using an external <productname>libgd</productname>, rather than
the bundled one).
</para>
<para>
In Windows, you'll include the GD DLL <filename>php_gd.dll</filename> as
an extension in &php.ini;.
Prior to PHP 8.0.0, the DLL was named <filename>php_gd2.dll</filename>.
</para>
<para>
Enhance the capabilities of GD to handle more image formats by specifying
the <literal>--with-XXXX</literal> configure switch to your PHP configure
line.
<table>
<title>Supported image formats</title>
<tgroup cols="2">
<thead>
<row>
<entry>Image Format</entry>
<entry>Configure Switch</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>avif</literal></entry>
<entry>
To enable support for avif add
<option role="configure">--with-avif</option>.
Available as of PHP 8.1.0.
</entry>
</row>
<row>
<entry><literal>jpeg</literal></entry>
<entry>
To enable support for jpeg add
<option role="configure">--with-jpeg-dir=DIR</option>. Jpeg 6b, 7 or 8
are supported.
As of PHP 7.4.0, use <option role="configure">--with-jpeg</option>
instead.
</entry>
</row>
<row>
<entry><literal>png</literal></entry>
<entry>
To enable support for png add
<option role="configure">--with-png-dir=DIR</option>. Note, libpng
requires the <link linkend="zlib.requirements">zlib library</link>,
therefore add <option role="configure">--with-zlib-dir[=DIR]</option>
to your configure line.
As of PHP 7.4.0, <option role="configure">--with-png-dir</option> and
<option role="configure">--with-zlib-dir</option> have been removed.
<productname>libpng</productname> and <productname>zlib</productname>
are required.
</entry>
</row>
<row>
<entry><literal>xpm</literal></entry>
<entry>
To enable support for xpm add
<option role="configure">--with-xpm-dir=DIR</option>. If configure
is not able to find the required libraries, you may add the path to
your X11 libraries.
As of PHP 7.4.0, use <option role="configure">--with-xpm</option>
instead.
</entry>
</row>
<row>
<entry><literal>webp</literal></entry>
<entry>
To enable support for webp add <option role="configure">--with-webp-dir=DIR</option>.
As of PHP 7.4.0, use <option role="configure">--with-webp</option>
instead.
</entry>
</row>
</tbody>
</tgroup>
</table>
<note>
<simpara>
When compiling PHP with libpng, you must use the same version that was
linked with the GD library.
</simpara>
</note>
</para>
<para>
Enhance the capabilities of GD to deal with different fonts by specifying
the <literal>--with-XXXX</literal> configure switch to your PHP configure
line.
<table>
<title>Supported font libraries</title>
<tgroup cols="2">
<thead>
<row>
<entry>Font library</entry>
<entry>Configure Switch</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>FreeType 2</literal></entry>
<entry>
To enable support for FreeType 2 add
<option role="configure">--with-freetype-dir=DIR</option>.
As of PHP 7.4.0 use <option role="configure">--with-freetype</option>
instead, which relies on <productname>pkg-config</productname>.
</entry>
</row>
<row>
<entry><literal>Native TrueType string function</literal></entry>
<entry>
To enable support for native TrueType string function add
<option role="configure">--enable-gd-native-ttf</option>.
(This option has no effect and has been removed as of PHP 7.2.0.)
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->