LII. Images

Introduction

PHP ne se limite pas à la génération de pages HTML. Il peut aussi servir à créer et manipuler des images, dans un grand choix de formats, comme GIF, PNG, JPEG, WBMP et XPM. Et PHP peut même générer directement des images pour le navigateur, avec la bibliothèque GD. GD et PHP auront aussi besoin d'autres bibliothèques, en fonction des formats que vous souhaitez utiliser.

Vous pouvez utiliser les fonctions PHP pour obtenir les tailles des images aux formats JPEG, GIF, PNG, SWF, TIFF et JPEG2000.

Note : Lisez la section sur les pré-requis pour savoir comment améliorer les possibilités de lecture, modification et écriture d'images, ainsi que les possibilités de lecture d'images prises par des appareils numériques.

Pré-requis

Si vous disposez de la bibliothèque GD (disponible à http://www.boutell.com/gd/) vous pourrez aussi créer et manipuler des images.

Les formats des images que vous pourrez manipuler dépendent de la version de GD que vous installerez, et de toutes autres bibliothèques dont GD a besoin pour traiter ces images. Les versions antérieures à la version 1.6 supportent le GIF, mais pas le PNG. A partir des version de GD supérieures à 1.6 et inférieures à 2.0.28, c'est le contraire. Le support du GIF a été rajouté à partir de la verison 2.0.28.

Note : Depuis PHP 4.3, il existe une version de GD qui est distribuée avec PHP. Cette version contient des fonctionnalités supplémentaires, comme les canaux alpha, et il est recommandé de l'utiliser de préférence à la bibliothèque externe, car elle est mieux supportée, et bien plus stable.

Vous pouvez aussi améliorer GD en lui ajoutant des formats d'images supplémentaires.

Tableau 1. Formats d'images supportés

Format d'imageBibliothèque à téléchargerNotes
gif  Uniquement supporté en versions de GD antérieures à la version 1.6 et supérieures ou égales à la version 2.0.28. Le support des images GIF est disponible en lecture seule depuis PHP 4.3.0, et dans la version de la bibliothèque qui est fournie avec la distribution de PHP. L'écriture est supportée depuis PHP 4.3.9 et PHP 5.0.1.
jpeg-6bftp://ftp.uu.net/graphics/jpeg/ 
pnghttp://www.libpng.org/pub/png/libpng.html Uniquement supporté avec GD plus récente que la version 1.6.
xpmftp://metalab.unc.edu/pub/Linux/libs/X/!INDEX.html Il est probable que vous ayez déjà cette bibliothèque disponible si votre système dispose d'un environnement X.

Vous pouvez aussi améliorer GD en lui ajoutant des fonctionnalités de manipulation de polices. Les bibliothèques suivantes sont supportées :

Tableau 2. Bibliothèques de polices supportées

Bibliothèque de policeTéléchargementNotes
FreeType 1.xhttp://www.freetype.org/ 
FreeType 2http://www.freetype.org/ 
T1libftp://sunsite.unc.edu/pub/Linux/libs/graphics/) Support des polices de Type 1.

Si vous avez compilé PHP avec l'option --enable-exif vous serez capable d'accéder aux données stockées dans les en-têtes des images JPEG et TIFF. De cette façon, vous pouvez lire les méta données générées par les appareils numériques. Ces fonctions ne requièrent par la bibliothèque GD.

Installation

Pour activer le support de GD, vous devez compiler PHP avec l'option --with-gd[=DIR], où DIR est le dossier d'installation de GD. Il est recommandé d'utiliser la version de GD qui est distribuée avec PHP, en utilisant simplement l'option --with-gd. La bibliothèque GD requière libpng et libjpeg pour compiler.

Sous Windows, vous devez inclure la bibliothèque php_gd2.dll comme extension dans le fichier php.ini. La bibliothèque php_gd.dll a été supprimée de PHP 4.3.2. Notez aussi que les fonctions conseillées truecolor, comme imagecreatetruecolor(), requièrent GD2.

Note : Pour activer le support exif sur Windows, php_mbstring.dll doit être chargée avant php_exif.dll dans le php.ini.

Pour désactiver le support de GD en PHP 3, ajoutez simplement l'option --without-gd dans votre ligne de configuration.

Augmentez les possibilités des GD de gérer d'autres formats d'images en spécifiant les options --with-XXXX de compilation suivantes :

Tableau 3. Formats d'image supportés

Format d'imageOption de compilation
jpeg-6b Pour activer le support de la bibliothèque JPEG-6b, ajouter l'option --with-jpeg-dir=DIR.
png Pour activer le support de la bibliothèque PNG, ajouter l'option --with-png-dir=DIR. Notez que libpng requiert la bibliothèque zlib et, donc, il vous faudra ajouter aussi --with-zlib-dir[=DIR] dans votre ligne de compilation.
xpm Pour activer le support de la bibliothèque XPM, ajoutez l'option --with-xpm-dir=DIR. Si le script de compilation n'est pas capable de trouver les bibliothèques nécessaires, il vous faudra ajouter le chemin vers les bibliothèques X11.

Note : Lorsque vous compilez PHP avec libpng, vous devez utiliser la même version que celle liée à la bibliothèque GD.

Augmentez les possibilités de GD pour qu'elle manipule différents types de polices de caractères en ajoutant les options --with-XXXX de compilation suivantes :

Tableau 4. Bibliothèques des polices de caractères supportées

BibliothèqueOption de configuration
FreeType 1.x Pour activer le support de FreeType 1.x, ajoutez l'option --with-ttf[=DIR].
FreeType 2 Pour activer le support de FreeType 2, ajoutez l'option --with-freetype-dir=DIR.
T1lib Pour activer le support de T1lib (Type 1 fonts), ajoutez l'option --with-t1lib[=DIR].
Chaînes TrueType Pour activer le support des chaînes de caractères TrueType, ajoutez l'option --enable-gd-native-ttf.

Configuration à l'exécution

Il n'y a pas de configuration spécifique pour les images mais vous êtes peut être intéressé par les directives de l'extension exif.

Types de ressources

Cette extension ne définit aucune ressource.

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

IMG_GIF (entier)

IMG_JPG (entier)

IMG_JPEG (entier)

IMG_PNG (entier)

IMG_WBMP (entier)

IMG_XPM (entier)

IMG_COLOR_TILED (entier)

IMG_COLOR_STYLED (entier)

IMG_COLOR_BRUSHED (entier)

IMG_COLOR_STYLEDBRUSHED (entier)

IMG_COLOR_TRANSPARENT (entier)

IMG_ARC_ROUNDED (entier)

IMG_ARC_PIE (entier)

IMG_ARC_CHORD (entier)

IMG_ARC_NOFILL (entier)

IMG_ARC_EDGED (entier)

IMAGETYPE_GIF (entier)

IMAGETYPE_JPEG (entier)

IMAGETYPE_PNG (entier)

IMAGETYPE_SWF (entier)

IMAGETYPE_PSD (entier)

IMAGETYPE_BMP (entier)

IMAGETYPE_WBMP (entier)

IMAGETYPE_XBM (entier)

IMAGETYPE_TIFF_II (entier)

IMAGETYPE_TIFF_MM (entier)

IMAGETYPE_IFF (entier)

IMAGETYPE_JB2 (entier)

IMAGETYPE_JPC (entier)

IMAGETYPE_JP2 (entier)

IMAGETYPE_JPX (entier)

IMAGETYPE_SWC (entier)

Exemples

Exemple 1. Création d'une image PNG avec PHP

<?php

header
("Content-type: image/png");
$string = $_GET['text'];
$im     = imagecreatefrompng("images/button1.png");
$orange = imagecolorallocate($im, 220, 210, 60);
$px     = (imagesx($im) - 7.5 * strlen($string)) / 2;
imagestring($im, 3, $px, 9, $string, $orange);
imagepng($im);
imagedestroy($im);

?>
Cet exemple doit être appelé depuis une page HTML avec une balise image telle que : <img src="button.php?text">. Le script ci-dessus, button.php, prend la chaîne "texte" et l'inscrit sur le fond d'image appelé "images/button1.png", puis l'affiche. C'est une méthode très pratique pour éviter de redessiner un nouveau bouton, dès que vous changez son texte. De cette façon, ils sont générés dynamiquement.

Table des matières
gd_info --  Retourne des informations à propos de la bibliothèque GD installée
getimagesize -- Retourne la taille d'une image
image_type_to_extension --  Retourne l'extension du fichier pour le type d'image
image_type_to_mime_type -- Lit le Mime-Type d'un type d'image
image2wbmp -- Crée une image WBMP
imagealphablending -- Modifie le mode de blending d'une image
imageantialias --  Utiliser ou non les fonctions d'antialias
imagearc -- Dessine une ellipse partielle
imagechar -- Dessine un caractère horizontalement
imagecharup -- Dessine un caractère verticalement
imagecolorallocate -- Alloue une couleur pour une image
imagecolorallocatealpha -- Alloue une couleur à une image
imagecolorat -- Retourne l'index de la couleur d'un pixel donné
imagecolorclosest --  Retourne l'index de la couleur la plus proche d'une couleur donnée
imagecolorclosestalpha --  Retourne la couleur la plus proche, en tenant compte du canal alpha
imagecolorclosesthwb --  Lit l'index de la couleur la plus proche d'une couleur spécifiée avec sa teinte, blanc et noir
imagecolordeallocate -- Supprime une couleur d'une image
imagecolorexact -- Retourne l'index de la couleur donnée
imagecolorexactalpha -- Retourne l'index d'une couleur avec son canal alpha
imagecolormatch --  Fait correspondre un peu plus les couleurs de la version palette d'une image aux couleurs de sa version truecolor
imagecolorresolve --  Retourne l'index de la couleur donnée, ou la plus proche possible
imagecolorresolvealpha --  Retourne un index de couleur ou son alternative la plus proche, y compris le canal alpha
imagecolorset --  Change la couleur dans une palette à l'index donné
imagecolorsforindex -- Retourne la couleur associée à un index
imagecolorstotal -- Calcule le nombre de couleurs d'une palette
imagecolortransparent -- Définit la couleur transparente
imagecopy --  Copie une partie d'une image
imagecopymerge --  Copie et fusionne une partie d'une image
imagecopymergegray --  Copie et fusionne une partie d'une image en niveaux de gris
imagecopyresampled -- Copie, redimensionne, rééchantillonne une image
imagecopyresized -- Copie et redimensionne une partie d'une image
imagecreate -- Crée une nouvelle image à palette
imagecreatefromgd2 -- Crée une nouvelle image à partir d'un fichier GD2 ou d'une URL
imagecreatefromgd2part -- Crée une nouvelle image à partir d'une partie de fichier GD2 ou d'une URL
imagecreatefromgd -- Crée une nouvelle image à partir d'un fichier GD ou d'une URL
imagecreatefromgif --  Crée une nouvelle image à partir d'un fichier ou d'une URL
imagecreatefromjpeg --  Crée une nouvelle image JPEG à partir d'un fichier ou d'une URL
imagecreatefrompng --  Crée une nouvelle image PNG à partir d'un fichier ou d'une URL
imagecreatefromstring -- Crée une image à partir d'une chaîne
imagecreatefromwbmp --  Crée une nouvelle image WBMP à partir d'un fichier ou d'une URL
imagecreatefromxbm --  Crée une nouvelle image XBM à partir d'un fichier ou d'une URL
imagecreatefromxpm --  Crée une nouvelle image XPM à partir d'un fichier ou d'une URL
imagecreatetruecolor -- Crée une nouvelle image en vraies couleurs
imagedashedline -- Dessine une ligne pointillée
imagedestroy -- détruit une image
imageellipse -- Dessine une ellipse
imagefill -- Remplit
imagefilledarc -- Dessine une ellipse partielle et la remplit
imagefilledellipse -- Dessine une ellipse pleine
imagefilledpolygon -- Dessine un polygone rempli
imagefilledrectangle -- Dessine un rectangle rempli
imagefilltoborder -- Remplit une région avec une couleur spécifique
imagefilter --  Applique un filtre à une image
imagefontheight -- Retourne la hauteur de la police
imagefontwidth -- Retourne la largeur de la police
imageftbbox -- Calcule le rectangle d'encadrement pour un texte, en utilisant la police courante et freetype2
imagefttext -- Ecrit du texte dans une image avec la police courante FreeType 2
imagegammacorrect --  Applique une correction gamma à l'image
imagegd2 -- Génère une image au format GD2, vers le navigateur ou un fichier
imagegd -- Génère une image au format GD, vers le navigateur ou un fichier
imagegif -- Envoie une image GIF vers un navigateur ou un fichier
imageinterlace -- Active ou désactive l'entrelacement
imageistruecolor -- Détermine si une image est une image truecolor
imagejpeg --  Envoie une image JPEG vers un navigateur ou un fichier
imagelayereffect --  Active l'option d'alpha blending, pour utiliser les effets de libgd
imageline -- Dessine une ligne
imageloadfont -- Charge une nouvelle police
imagepalettecopy -- Copie la palette d'une image à l'autre
imagepng --  Envoie une image PNG vers un navigateur ou un fichier
imagepolygon -- Dessine un polygone
imagepsbbox --  Retourne le rectangle entourant un texte et dessiné avec une police PostScript Type1
imagepscopyfont --  Fait une copie d'une police chargée pour modification ultérieure
imagepsencodefont --  Change le codage vectoriel d'un caractère dans une police
imagepsextendfont --  Etend ou condense une police de caractères
imagepsfreefont --  Libère la mémoire occupée par une police PostScript Type 1
imagepsloadfont -- Charge une police PostScript Type 1 depuis un fichier
imagepsslantfont --  Incline une police de caractères PostScript
imagepstext -- Dessine un texte sur une image avec une police PostScript Type1
imagerectangle -- Dessine un rectangle
imagerotate -- Fait tourner une image d'un angle
imagesavealpha --  Configure l'enregistrement des informations complètes du canal alpha lors de sauvegardes d'images PNG
imagesetbrush -- Modifie la brosse pour le dessin des lignes
imagesetpixel -- Dessine un pixel
imagesetstyle -- Configure le style pour le dessin des lignes
imagesetthickness -- Modifie l'épaisseur d'un trait
imagesettile -- Modifie l'image utilisée pour le carrelage
imagestring -- Dessine une chaîne horizontale
imagestringup -- Dessine une chaîne verticale
imagesx -- Retourne la largeur d'une image
imagesy -- Retourne la hauteur de l'image
imagetruecolortopalette -- Convertit une image en vraies couleurs en image à palette
imagettfbbox --  Retourne le rectangle entourant un texte et dessiné avec une police TrueType
imagettftext -- Dessine un texte avec une police TrueType
imagetypes --  Retourne les types d'images supportés par la version courante de PHP
imagewbmp -- Affiche une image WBMP
imagexbm --  Génère une image au format XBM
iptcembed -- Intègre des données binaires IPTC dans une image JPEG
iptcparse --  Analyse un bloc binaire IPTC http://www.iptc.org/ et recherche les balises simples
jpeg2wbmp -- Convertit une image JPEG en image WBMP
png2wbmp -- Convertit une image PNG en image WBMP