Manuel PHP
Précédent |  | Suivant

# XLII. 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, jpg, wbmp et xpm. Et `PHP` peut même générer directement des images pour le navigateur, avec la librarie GD. GD et `PHP` auront aussi besoin d'autres librairies, 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 librairie 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 toute autre librairie 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 de GD 1.6, c'est le contraire.

> 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 librairie 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'image | Librairie à télécharger | Notes
--- | --- | ---
`gif` |  | Uniquement supporté en versions de GD antérieures à gd-1.6. Le support des images GIF est disponible en lecture seule depuis `PHP` 4.3.0, et dans la version de la librairie qui est fournie avec la distribution de `PHP`.
`jpeg-6b` | ftp://ftp.uu.net/graphics/jpeg/ |
`png` | http://www.libpng.org/pub/png/libpng.html | Uniquement supporté avec GD plus récente que gd-1.6.
`xpm` | ftp://metalab.unc.edu/pub/Linux/libs/X/!INDEX.html | Il est probable que vous ayez déjà cette librairie disponible si votre système dispose d'un environnement X.

Vous pouvez aussi améliorer GD en lui ajoutant des fonctionalités de manipulation de polices. Les librairies suivantes sont supportées :

Tableau 2. Supported font libraries

Librarie de police | Téléchargement | Notes
--- | --- | ---
`FreeType 1.x` | http://www.freetype.org/ |
`FreeType 2` | http://www.freetype.org/ |
`T1lib` | ftp://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 librairie GD.

> Note : `PHP` ne nécessite aucune librairie supplémentaire pour gérer les données EXIF.

# 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`.

Sous Windows, vous devez inclure la librairie `php_gd2.dll` comme extension dans le fichier `php.ini`. La librairie `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 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'image | Option de compilation
--- | ---
`jpeg-6b` | Pour activer le support de la librairie JPEG-6b, ajouter l'option `--with-jpeg-dir=DIR`.
`png` | Pour activer le support de la librairie PNG, ajouter l'option `--with-png-dir=DIR`. Notez que libpng requiert la librairie zlib et, donc, il vous faudra ajouter aussi `--with-zlib-dir[=DIR]` dans votre ligne de compilation.
`xpm` | Pour activer le support de la librairie XPM, ajoutez l'option `--with-xpm-dir=DIR`. Si le script de compilation n'est pas capable de trouver les librairies nécessaires, il vous faudra ajouter le chemin vers les librairies X11.

> Note : Lorsque vous compilez `PHP` avec libpng, vous devez utiliser la même version que celle liée à la librairie 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. Librairies des polices de caractères supportées

Librairie | 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 (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`.

Exif supporte automatiquement la conversion en Unicode et JIS pour les commentaires des utilisateurs, lorsque le module mbstring est disponible. Cela se fait en décodant le commentaire avec le bon jeu de caractères. Le résultat peut alors être encodé dans le jeu de caractères de votre sortie HTTP.

Tableau 5. Options de configuration

Nom | Par défaut | Modifiable
--- | --- | ---
exif.encode_unicode | "ISO-8859-15" | PHP_INI_ALL
exif.decode_unicode_motorola | "UCS-2BE" | PHP_INI_ALL
exif.decode_unicode_intel | "UCS-2LE" | PHP_INI_ALL
exif.encode_jis | "" | PHP_INI_ALL
exif.decode_jis_motorola | "JIS" | PHP_INI_ALL
exif.decode_jis_intel | "JIS" | PHP_INI_ALL

Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à ini_set().

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

`exif.encode_unicode` string

  `exif.encode_unicode` définit le jeu de caractères UNICODE utilisé pour les commentaires. Par défaut, c'est `ISO-8859-15`, qui devrait fonctionner pour les pays non asiatiques. Cette option peut être vide, ou bien contenir un jeu de caractères qui est supporté par mbstring. Si cette option est vide, la configuration de mbstring sera utilisée.

`exif.decode_unicode_motorola` string

  `exif.decode_unicode_motorola` définit le jeu de caractères interne pour les utilisateurs Unicode, si le commentaire de l'image est en big-endian (ordre de motorola). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est `UCS-2BE`.

`exif.decode_unicode_intel` string

  `exif.decode_unicode_intel` définit le jeu de caractères interne pour les utilisateurs Unicode, si le commentaire de l'image est en little-endian (ordre d'intel). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est `UCS-2LE`.

`exif.encode_jis` string

  `exif.encode_jis` définit le jeu de caractères pour les commentaires en JIS. Par défaut, c'est une valeur vide, ce qui force la fonction à utiliser le jeu de caractères interne de mbstring.

`exif.decode_jis_motorola` string

  `exif.decode_jis_motorola` définit le jeu de caractères interne pour les utilisateurs JIS, si le commentaire de l'image est en big-endian (ordre de motorola). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est `JIS`.

`exif.decode_jis_intel` string

  `exif.decode_jis_intel` définit le jeu de caractères interne pour les utilisateurs JIS, si le commentaire de l'image est en little-endian (ordre d'intel). Cette option ne peut être vide, mais vous pouvez y spécifier une liste de jeux de caractères utilisés par mbstring. Par défaut, c'est `JIS`.

# Types de ressources

Cette extension ne définit aucune ressource.

# Constantes prédefinies

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 "text" 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.

Précédent | Sommaire | Suivant
ob_iconv_handler | Niveau supérieur | exif_imagetype