reference/image/configure.xml
9ba738103b63ee4f129dadf3f8585568609e63b7
9ba738103b63ee4f129dadf3f8585568609e63b7
...
...
@@ -5,17 +5,21 @@
5
5
<para>
6
6
To enable GD-support configure PHP
7
7
<option role="configure">--with-gd[=DIR]</option>, where DIR is the GD base
8
-
install directory. To use the recommended bundled version of the GD library
9
-
(which was first bundled in PHP 4.3.0), use the configure option
8
+
install directory. To use the recommended bundled version of the GD library,
9
+
use the configure option
10
10
<option role="configure">--with-gd</option>.
11
11
GD library requires <productname>libpng</productname> and
12
12
<productname>libjpeg</productname> to compile.
13
+
As of PHP 7.4.0, <option role="configure">--with-gd</option> becomes
14
+
<option role="configure">--enable-gd</option> (whether to enable the
15
+
extension at all) and <option role="configure">--with-external-gd</option>
16
+
(to opt into using an external <productname>libgd</productname>, rather than
17
+
the bundled one).
13
18
</para>
14
19
<para>
15
-
In Windows, you'll include the GD2 DLL <filename>php_gd2.dll</filename> as
16
-
an extension in &php.ini;. The GD1 DLL <filename>php_gd.dll</filename> was
17
-
removed in PHP 4.3.2. Also note that the preferred truecolor image
18
-
functions, such as <function>imagecreatetruecolor</function>, require GD2.
20
+
In Windows, you'll include the GD DLL <filename>php_gd.dll</filename> as
21
+
an extension in &php.ini;.
22
+
Prior to PHP 8.0.0, the DLL was named <filename>php_gd2.dll</filename>.
19
23
</para>
20
24
21
25
<para>
...
...
@@ -33,10 +37,21 @@
33
37
</thead>
34
38
<tbody>
35
39
<row>
36
-
<entry><literal>jpeg-6b</literal></entry>
40
+
<entry><literal>avif</literal></entry>
37
41
<entry>
38
-
To enable support for jpeg-6b add
39
-
<option role="configure">--with-jpeg-dir=DIR</option>.
42
+
To enable support for avif add
43
+
<option role="configure">--with-avif</option>.
44
+
Available as of PHP 8.1.0.
45
+
</entry>
46
+
</row>
47
+
<row>
48
+
<entry><literal>jpeg</literal></entry>
49
+
<entry>
50
+
To enable support for jpeg add
51
+
<option role="configure">--with-jpeg-dir=DIR</option>. Jpeg 6b, 7 or 8
52
+
are supported.
53
+
As of PHP 7.4.0, use <option role="configure">--with-jpeg</option>
54
+
instead.
40
55
</entry>
41
56
</row>
42
57
<row>
...
...
@@ -47,6 +62,10 @@
47
62
requires the <link linkend="zlib.requirements">zlib library</link>,
48
63
therefore add <option role="configure">--with-zlib-dir[=DIR]</option>
49
64
to your configure line.
65
+
As of PHP 7.4.0, <option role="configure">--with-png-dir</option> and
66
+
<option role="configure">--with-zlib-dir</option> have been removed.
67
+
<productname>libpng</productname> and <productname>zlib</productname>
68
+
are required.
50
69
</entry>
51
70
</row>
52
71
<row>
...
...
@@ -56,6 +75,16 @@
56
75
<option role="configure">--with-xpm-dir=DIR</option>. If configure
57
76
is not able to find the required libraries, you may add the path to
58
77
your X11 libraries.
78
+
As of PHP 7.4.0, use <option role="configure">--with-xpm</option>
79
+
instead.
80
+
</entry>
81
+
</row>
82
+
<row>
83
+
<entry><literal>webp</literal></entry>
84
+
<entry>
85
+
To enable support for webp add <option role="configure">--with-webp-dir=DIR</option>.
86
+
As of PHP 7.4.0, use <option role="configure">--with-webp</option>
87
+
instead.
59
88
</entry>
60
89
</row>
61
90
</tbody>
...
...
@@ -83,24 +112,12 @@
83
112
</thead>
84
113
<tbody>
85
114
<row>
86
-
<entry><literal>FreeType 1.x</literal></entry>
87
-
<entry>
88
-
To enable support for FreeType 1.x add
89
-
<option role="configure">--with-ttf[=DIR]</option>.
90
-
</entry>
91
-
</row>
92
-
<row>
93
115
<entry><literal>FreeType 2</literal></entry>
94
116
<entry>
95
117
To enable support for FreeType 2 add
96
118
<option role="configure">--with-freetype-dir=DIR</option>.
97
-
</entry>
98
-
</row>
99
-
<row>
100
-
<entry><literal>T1lib</literal></entry>
101
-
<entry>
102
-
To enable support for T1lib (Postscript Type 1 fonts) add
103
-
<option role="configure">--with-t1lib[=DIR]</option>.
119
+
As of PHP 7.4.0 use <option role="configure">--with-freetype</option>
120
+
instead, which relies on <productname>pkg-config</productname>.
104
121
</entry>
105
122
</row>
106
123
<row>
...
...
@@ -108,6 +125,7 @@
108
125
<entry>
109
126
To enable support for native TrueType string function add
110
127
<option role="configure">--enable-gd-native-ttf</option>.
128
+
(This option has no effect and has been removed as of PHP 7.2.0.)
111
129
</entry>
112
130
</row>
113
131
</tbody>
114
132