<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Installation</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="image.requirements.html">Requirements</a></div>
<div class="next" style="text-align: right; float: right;"><a href="image.configuration.html">Runtime Configuration</a></div>
<div class="up"><a href="image.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="image.installation" class="section">
<h2 class="title">Installation</h2>
<p class="para">
To enable GD-support configure PHP
<strong class="option configure">--with-gd[=DIR]</strong>
, where DIR is the GD base
install directory. To use the recommended bundled version of the GD library,
use the configure option
<strong class="option configure">--with-gd</strong>
.
GD library requires <span class="productname">libpng</span> and
<span class="productname">libjpeg</span> to compile.
</p>
<p class="para">
In Windows, you'll include the GD2 DLL <var class="filename">php_gd2.dll</var> as
an extension in <var class="filename">php.ini</var>.
</p>
<p class="para">
Enhance the capabilities of GD to handle more image formats by specifying
the <em>--with-XXXX</em> configure switch to your PHP configure
line.
<table class="doctable table">
<caption><strong>Supported image formats</strong></caption>
<thead>
<tr>
<th>Image Format</th>
<th>Configure Switch</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td><em>jpeg</em></td>
<td>
To enable support for jpeg add
<strong class="option configure">--with-jpeg-dir=DIR</strong>
. Jpeg 6b, 7 or 8
are supported.
</td>
</tr>
<tr>
<td><em>png</em></td>
<td>
To enable support for png add
<strong class="option configure">--with-png-dir=DIR</strong>
. Note, libpng
requires the <a href="zlib.requirements.html" class="link">zlib library</a>,
therefore add <strong class="option configure">--with-zlib-dir[=DIR]</strong>
to your configure line.
</td>
</tr>
<tr>
<td><em>xpm</em></td>
<td>
To enable support for xpm add
<strong class="option configure">--with-xpm-dir=DIR</strong>
. If configure
is not able to find the required libraries, you may add the path to
your X11 libraries.
</td>
</tr>
<tr>
<td><em>webp</em></td>
<td>
To enable support for webp add
<strong class="option configure">--with-vpx-dir=DIR</strong>
. Available as of PHP
5.5.
As of PHP 7.0.0 <strong class="option configure">--with-webp-dir=DIR</strong>
has
to be added, i.e. support for libvpx has been removed in favor of libwebp.
</td>
</tr>
</tbody>
</table>
<blockquote class="note"><p><strong class="note">Note</strong>:
<span class="simpara">
When compiling PHP with libpng, you must use the same version that was
linked with the GD library.
</span>
</p></blockquote>
</p>
<p class="para">
Enhance the capabilities of GD to deal with different fonts by specifying
the <em>--with-XXXX</em> configure switch to your PHP configure
line.
<table class="doctable table">
<caption><strong>Supported font libraries</strong></caption>
<thead>
<tr>
<th>Font library</th>
<th>Configure Switch</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td><em>FreeType 2</em></td>
<td>
To enable support for FreeType 2 add
<strong class="option configure">--with-freetype-dir=DIR</strong>
.
</td>
</tr>
<tr>
<td><em>T1lib</em></td>
<td>
To enable support for T1lib (Postscript Type 1 fonts) add
<strong class="option configure">--with-t1lib[=DIR]</strong>
(Removed
as of PHP 7.0.0).
</td>
</tr>
<tr>
<td><em>Native TrueType string function</em></td>
<td>
To enable support for native TrueType string function add
<strong class="option configure">--enable-gd-native-ttf</strong>
.
(Effectless as of PHP 5.5.0; removed as of PHP 7.2.0.)
</td>
</tr>
</tbody>
</table>
</p>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="image.requirements.html">Requirements</a></div>
<div class="next" style="text-align: right; float: right;"><a href="image.configuration.html">Runtime Configuration</a></div>
<div class="up"><a href="image.setup.html">Installing/Configuring</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
