Forum und email
Référence des fonctions
PHP Manual

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.

Avec l'extension exif, vous pourrez travailler avec les informations stockées dans les en-têtes des images JPEG et TIFF. De cette façon, vous pourrez lire les méta-données générées par les appareils numériques. Les fonctions exif ne nécessitent pas la bibliothèque GD.

Note: Lisez la section sur les besoins pour savoir comment étendre les capacités des fonctions sur les images pour lire, écrire et modifier les images. Pour lire les méta-données des photos prises avec des appareils numériques, vous devez utiliser l'extension exif mentionnée ci-dessus.

Pré-requis

Si vous disposez de la bibliothèque GD (disponible à » https://www.libgd.org/) 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. À 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.

Note: Le support pour GD 1.x a été supprimé à partir de PHP 6.0.0, qui requiert 2.0.33 ou supérieur.

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

Formats d'images supportés
Format d'image Bibliothèque à télécharger Notes
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-6b » ftp://ftp.uu.net/graphics/jpeg/ Lors de la compilation de la bibliothèque jpeg-v6b (avant celle de PHP), vous devez utiliser l'option de configuration --enable-shared. Dans le cas contraire, vous recevrez une erreur disant que libjpeg.(a|so) not found lorsque vous tenterez de configurer PHP avant de le compiler.
png » https://www.libpng.org/pub/png/libpng.html Uniquement supporté avec GD plus récente que la version 1.6.
xpm » ftp://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 :

Bibliothèques de polices supportées
Bibliothèque de police Téléchargement Notes
FreeType 1.x » https://www.freetype.org/  
FreeType 2 » https://www.freetype.org/ Le support a été supprimé à partir de PHP 6.0.0
T1lib » ftp://sunsite.unc.edu/pub/Linux/libs/graphics/) Support des polices Postscript Type 1.

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 requiert 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.

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 :

Formats d'image supportés
Format d'image Option 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 :

Bibliothèques des polices de caractères supportées
Bibliothèque Option 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 (Postscript 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

Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.

Image Options de configuration
Nom Défaut Modifiable Historique
gd.jpeg_ignore_warning "0" PHP_INI_ALL Disponible depuis PHP 5.1.4.
Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à Directives du php.ini.

Voici un éclaircissement sur l'utilisation des directives de configuration.

gd.jpeg_ignore_warning bool

Ignore les alertes créées par la fonction jpeg2wbmp() et la fonction imagecreatefromjpeg()

Voir aussi les directives de configuration exif.

Warning

Les fonctions sur les images sont très gourmandes en terme de mémoire. Assurez-vous de définir une valeur assez importante pour memory_limit.

Types de ressources

Cette extension définit deux types de ressources : un identifiant d'image et un identifiant de police.

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)
IMG_GD2_RAW (entier)
IMG_GD2_COMPRESSED (entier)
IMG_EFFECT_REPLACE (entier)
IMG_EFFECT_ALPHABLEND (entier)
IMG_EFFECT_NORMAL (entier)
IMG_EFFECT_OVERLAY (entier)
IMG_FILTER_NEGATE (entier)
IMG_FILTER_GRAYSCALE (entier)
IMG_FILTER_BRIGHTNESS (entier)
IMG_FILTER_CONTRAST (entier)
IMG_FILTER_COLORIZE (entier)
IMG_FILTER_EDGEDETECT (entier)
IMG_FILTER_GAUSSIAN_BLUR (entier)
IMG_FILTER_SELECTIVE_BLUR (entier)
IMG_FILTER_EMBOSS (entier)
IMG_FILTER_MEAN_REMOVAL (entier)
IMG_FILTER_SMOOTH (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)
PNG_NO_FILTER (entier)
PNG_FILTER_NONE (entier)
PNG_FILTER_SUB (entier)
PNG_FILTER_UP (entier)
PNG_FILTER_AVG (entier)
PNG_FILTER_PAETH (entier)
PNG_ALL_FILTERS (entier)

Exemples

Example#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 of Contents

Référence des fonctions
PHP Manual