<!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 (which was first bundled in PHP 4.3.0), 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>. The GD1 DLL <var class="filename">php_gd.dll</var> was removed in PHP 4.3.2. Also note that the preferred truecolor image functions, such as <span class="function"><a href="function.imagecreatetruecolor.html" class="function">imagecreatetruecolor()</a></span>, require GD2. </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> </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> . </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> . </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>