# php_manual

id: imagecolordeallocate
type: function
doc:
<comment>Description:</comment>
  Supprime une couleur d'une image
  
  Supprime la couleur <strong>$color</strong> précédemment allouée avec la fonction <strong>imagecolorallocate()</strong>, pour
  l'image <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$color</strong>  L'identifiant de la couleur.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagecolorallocate()</strong>
   * <strong>imagecolorallocatealpha()</strong>


id: imagecolorexact
type: function
doc:
<comment>Description:</comment>
  Retourne l'index de la couleur donnée
  
  Retourne l'index de la couleur spécifiée dans la palette de l'image <strong>$image</strong>.
  
  Si vous créez l'image depuis un fichier, seules les couleurs utilisées dans l'image seront
  résolues. Les couleurs uniquement présentes dans la palette ne le seront pas.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Valeur du composant rouge.
  <info>int</info>      <strong>$green</strong>  Valeur du composant vert.
  <info>int</info>      <strong>$blue</strong>   Valeur du composant bleu.

<comment>Return:</comment>
  <info>int</info>  Retourne l'index de la couleur spécifié dans la palette, ou -1 si la couleur n'existe pas.

<comment>See Also:</comment>
   * <strong>imagecolorclosest()</strong>


id: imagecolorexactalpha
type: function
doc:
<comment>Description:</comment>
  Retourne l'index d'une couleur avec son canal alpha
  
  Retourne l'index d'une couleur avec son canal alpha.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Valeur du composant rouge.
  <info>int</info>      <strong>$green</strong>  Valeur du composant vert.
  <info>int</info>      <strong>$blue</strong>   Valeur du composant bleu.
  <info>int</info>      <strong>$alpha</strong>  Une valeur comprise entre <return>0</return> et <return>127</return>. <return>0</return> indique une opacité complète tandis que <return>127</return>
                   indique une transparence complète.

<comment>Return:</comment>
  <info>int</info>  Retourne l'index de la couleur fournie et son canal alpha dans la palette de l'image, ou -1
       si la couleur n'existe pas dans la palette de l'image.

<comment>See Also:</comment>
   * <strong>imagecolorclosestalpha()</strong>


id: imagecolormatch
type: function
doc:
<comment>Description:</comment>
  Fait correspondre un peu plus les couleurs de la version palette d'une image
     aux couleurs de sa version truecolor
  
  Fait correspondre un peu plus les couleurs de la version palette d'une image aux couleurs de sa
  version truecolor.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image1</strong>  Un objet d'image truecolor.
  <info>GdImage</info>  <strong>$image2</strong>  Un objet de palette d'image pointant sur une image qui a la même taille que
                    <strong>$image1</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>


id: imagecolorresolve
type: function
doc:
<comment>Description:</comment>
  Retourne l'index de la couleur donnée, ou la plus proche possible
  
  <strong>imagecolorresolve()</strong> retourne un index de couleur à tous les coups. Soit il arrive à trouver la
  couleur demandée dans la palette, soit il trouve la couleur la plus proche.
  
  Si vous créez l'image depuis un fichier, seules les couleurs utilisées dans l'image seront
  résolues. Les couleurs uniquement présentes dans la palette ne le seront pas.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Valeur du composant rouge.
  <info>int</info>      <strong>$green</strong>  Valeur du composant vert.
  <info>int</info>      <strong>$blue</strong>   Valeur du composant bleu.

<comment>Return:</comment>
  <info>int</info>  Retourne un index de couleur.

<comment>See Also:</comment>
   * <strong>imagecolorclosest()</strong>


id: imagecolorresolvealpha
type: function
doc:
<comment>Description:</comment>
  Retourne un index de couleur ou son alternative la plus proche,
     y compris le canal alpha
    
  
  <strong>imagecolorresolvealpha()</strong> retourne toujours un index de couleur, disponible dans la palette de
  l'image <strong>$image</strong> : soit c'est la couleur exacte, soit c'est la meilleure approximation.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$red</strong>    Valeur du composant rouge.
  <info>int</info>      <strong>$green</strong>  Valeur du composant vert.
  <info>int</info>      <strong>$blue</strong>   Valeur du composant bleu.
  <info>int</info>      <strong>$alpha</strong>  Une valeur comprise entre <return>0</return> et <return>127</return>. <return>0</return> indique une opacité complète tandis que <return>127</return>
                   indique une transparence complète.

<comment>Return:</comment>
  <info>int</info>  Retourne un index de couleur.

<comment>See Also:</comment>
   * <strong>imagecolorclosestalpha()</strong>


id: imagecolorset
type: function
doc:
<comment>Description:</comment>
  Change la couleur dans une palette à l'index donné
  
  Permet d'attribuer à un index d'une palette une couleur spécifique. C'est une fonction très
  pratique pour effectuer du remplissage de couleur sans le faire réellement.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$color</strong>  Un index de la palette.
  <info>int</info>      <strong>$red</strong>    Valeur du composant rouge.
  <info>int</info>      <strong>$green</strong>  Valeur du composant vert.
  <info>int</info>      <strong>$blue</strong>   Valeur du composant bleu.
  <info>int</info>      <strong>$alpha</strong>  Valeur du composant alpha.

<comment>Return:</comment>
  <info>false|null</info>  The function returns <info>null</info> on success,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagecolorat()</strong>


id: imagecolorsforindex
type: function
doc:
<comment>Description:</comment>
  Retourne la couleur associée à un index
  
  Retourne la couleur associée à un index spécifié.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$color</strong>  L'index de la couleur.

<comment>Return:</comment>
  <info>array</info>  Retourne un tableau associatif avec les clés <return>"red"</return>,  <return>"green"</return>, <return>"blue"</return> et <return>"alpha"</return> qui
         contiennent les valeurs pour l'index de la couleur spécifiée.

<comment>See Also:</comment>
   * <strong>imagecolorat()</strong>
   * <strong>imagecolorexact()</strong>


id: imagecolorstotal
type: function
doc:
<comment>Description:</comment>
  Calcule le nombre de couleurs d'une palette
  
  Retourne le nombre de couleurs de la palette de l'image.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>int</info>  Retourne le nombre de couleurs de la palette pour l'image <strong>$image</strong> ou 0 pour les images
       truecolor.

<comment>See Also:</comment>
   * <strong>imagecolorat()</strong>
   * <strong>imagecolorsforindex()</strong>
   * <strong>imageistruecolor()</strong>


id: imagecolortransparent
type: function
doc:
<comment>Description:</comment>
  Définit la couleur transparente
  
  Récupère ou définit la couleur transparente pour l'<strong>$image</strong> fournit.

<comment>Param:</comment>
  <info>GdImage</info>   <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                    <strong>imagecreatetruecolor()</strong>.
  <info>int|null</info>  <strong>$color</strong>  Un identificateur de couleur créé avec <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>int</info>  L'identifiant de la nouvelle couleur transparente (ou l'actuelle, si aucune n'est spécifiée)
       est retourné. Si le paramètre <strong>$color</strong> est <info>null</info>, et que l'image n'a pas de couleur
       transparente, l'identifiant retourné sera <return>-1</return>.


id: imageconvolution
type: function
doc:
<comment>Description:</comment>
  Applique une matrice de la convolution 3x3, en utilisant le coefficient et l'excentrage
  
  <strong>imageconvolution()</strong> applique une matrice de la convolution 3x3, en utilisant le coefficient <strong>$div</strong> et
  l'excentrage <strong>$offset</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>    Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                     <strong>imagecreatetruecolor()</strong>.
  <info>array</info>    <strong>$matrix</strong>   Une matrice 3x3 : un tableau contenant trois tableaux de trois nombres à
                     virgules flottantes.
  <info>float</info>    <strong>$divisor</strong>  Le diviseur du résultat de la convolution, utilisé pour la normalisation.
  <info>float</info>    <strong>$offset</strong>   La position de la couleur.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagefilter()</strong>


id: imagecopy
type: function
doc:
<comment>Description:</comment>
  Copie une partie d'une image
  
  Copie une partie de l'image <strong>$src_image</strong> sur l'image de destination <strong>$dst_image</strong>, en commençant aux
  coordonnées <strong>$src_x</strong>, <strong>$src_y</strong> et sur la largeur de <strong>$src_width</strong> et la hauteur de <strong>$src_height</strong>. La
  portion ainsi définie sera copiée et placée aux coordonnées <strong>$dst_x</strong> et <strong>$dst_y</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst_image</strong>   Ressource cible de l'image.
  <info>GdImage</info>  <strong>$src_image</strong>   Ressource source de l'image.
  <info>int</info>      <strong>$dst_x</strong>       X : coordonnées du point de destination.
  <info>int</info>      <strong>$dst_y</strong>       Y : coordonnées du point de destination.
  <info>int</info>      <strong>$src_x</strong>       X : coordonnées du point source.
  <info>int</info>      <strong>$src_y</strong>       Y : coordonnées du point source.
  <info>int</info>      <strong>$src_width</strong>   Largeur de la source.
  <info>int</info>      <strong>$src_height</strong>  Hauteur de la source.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagecrop()</strong>


id: imagecopymerge
type: function
doc:
<comment>Description:</comment>
  Copie et fusionne une partie d'une image
  
  Copie une partie de l'image <strong>$src_image</strong> dans l'image de destination <strong>$dst_image</strong> en commençant aux
  coordonnées (<strong>$src_x</strong>, <strong>$src_y</strong>), avec la largeur <strong>$src_width</strong> et la hauteur <strong>$src_height</strong>. La zone de
  l'image ainsi définie sera copiée aux coordonnées (<strong>$dst_x</strong>, <strong>$dst_y</strong>), dans l'image de destination.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst_image</strong>   Ressource cible de l'image.
  <info>GdImage</info>  <strong>$src_image</strong>   Ressource source de l'image.
  <info>int</info>      <strong>$dst_x</strong>       X : coordonnée du point de destination.
  <info>int</info>      <strong>$dst_y</strong>       Y : coordonnée du point de destination.
  <info>int</info>      <strong>$src_x</strong>       X : coordonnée du point source.
  <info>int</info>      <strong>$src_y</strong>       Y : coordonnée du point source.
  <info>int</info>      <strong>$src_width</strong>   Largeur de la source.
  <info>int</info>      <strong>$src_height</strong>  Hauteur de la source.
  <info>int</info>      <strong>$pct</strong>         Les deux images seront fusionnées suivant le paramètre <strong>$pct</strong>, qui peut valoir
                        de 0 à 100. Si <strong>$pct</strong> = 0, aucune action n'est faite, alors que si <strong>$pct</strong> = 100,
                        <strong>imagecopymerge()</strong> se comporte exactement comme <strong>imagecopy()</strong> pour les images de
                        palette, sauf pour l'ignorance des composants alpha, tandis qu'il implémente
                        la transparence alpha pour les  images en couleur vraies.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imagecopymergegray
type: function
doc:
<comment>Description:</comment>
  Copie et fusionne une partie d'une image en niveaux de gris
  
  <strong>imagecopymergegray()</strong> copie une partie de l'image <strong>$src_image</strong> dans l'image de destination <strong>$dst_image</strong>
  commençant aux coordonnées (<strong>$src_x</strong>, <strong>$src_y</strong>), avec la largeur <strong>$src_width</strong> et la hauteur <strong>$src_height</strong>.
  La zone de l'image ainsi définie sera copiée aux coordonnées (<strong>$dst_x</strong>, <strong>$dst_y</strong>), dans l'image de
  destination.
  
  <strong>imagecopymergegray()</strong> est identique à la fonction <strong>imagecopymerge()</strong>, hormis le fait que lors de la
  fusion, le "hue" de l'image sera conservé grâce à la conversion de la zone dans l'image de
  destination en gris, avant l'opération de copie.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst_image</strong>   Ressource cible de l'image.
  <info>GdImage</info>  <strong>$src_image</strong>   Ressource source de l'image.
  <info>int</info>      <strong>$dst_x</strong>       X : coordonnée du point de destination.
  <info>int</info>      <strong>$dst_y</strong>       Y : coordonnée du point de destination.
  <info>int</info>      <strong>$src_x</strong>       X : coordonnée du point source.
  <info>int</info>      <strong>$src_y</strong>       Y : coordonnée du point source.
  <info>int</info>      <strong>$src_width</strong>   Largeur de la source.
  <info>int</info>      <strong>$src_height</strong>  Hauteur de la source.
  <info>int</info>      <strong>$pct</strong>         Le paramètre <strong>$src_image</strong> sera changé en niveaux de gris en accord avec le
                        paramètre <strong>$pct</strong> où 0 correspond à une convertion totale en niveaux de gris et
                        100 ne modifie rien. Lorsque <strong>$pct</strong> = 100, cette fonction se comporte de la
                        même façon que la fonction <strong>imagecopy()</strong> pour les palettes, sauf pour
                        l'ignorance des composants alpha, alors qu'elle implémente la transparence
                        alpha pour les images true colour.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imagecopyresampled
type: function
doc:
<comment>Description:</comment>
  Copie, redimensionne, rééchantillonne une image
  
  <strong>imagecopyresampled()</strong> copie une zone rectangulaire de l'image <strong>$src_im</strong> vers l'image <strong>$dst_im</strong>. Durant
  la copie, la zone est rééchantillonnée de manière à conserver la clarté de l'image durant une
  réduction.
  
  En d'autres termes, <strong>imagecopyresampled()</strong> prendra une forme rectangulaire <strong>$src_image</strong> d'une largeur
  de <strong>$src_width</strong> et d'une hauteur <strong>$src_height</strong> à la position (<strong>$src_x</strong>,<strong>$src_y</strong>) et le placera dans une
  zone rectangulaire <strong>$dst_image</strong> d'une largeur de <strong>$dst_width</strong> et d'une hauteur de <strong>$dst_height</strong> à la
  position (<strong>$dst_x</strong>,<strong>$dst_y</strong>).
  
  Si les hauteurs et largeurs des source et destination diffèrent, l'image copiée sera étirée de
  manière appropriée. Les coordonnées sont celles du coin supérieur gauche. <strong>imagecopyresampled()</strong>
  peut servir à copier des zones d'une image vers elle-même, (si <strong>$dst_image</strong>  est la même que
  <strong>$src_image</strong>) mais si les régions se chevauchent, les résultats sont imprévisibles.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst_image</strong>   Ressource cible de l'image.
  <info>GdImage</info>  <strong>$src_image</strong>   Ressource source de l'image.
  <info>int</info>      <strong>$dst_x</strong>       X : coordonnées du point de destination.
  <info>int</info>      <strong>$dst_y</strong>       Y : coordonnées du point de destination.
  <info>int</info>      <strong>$src_x</strong>       X : coordonnées du point source.
  <info>int</info>      <strong>$src_y</strong>       Y : coordonnées du point source.
  <info>int</info>      <strong>$dst_width</strong>   Largeur de la destination.
  <info>int</info>      <strong>$dst_height</strong>  Hauteur de la destination.
  <info>int</info>      <strong>$src_width</strong>   Largeur de la source.
  <info>int</info>      <strong>$src_height</strong>  Hauteur de la source.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagecopyresized()</strong>
   * <strong>imagescale()</strong>
   * <strong>imagecrop()</strong>


id: imagecopyresized
type: function
doc:
<comment>Description:</comment>
  Copie et redimensionne une partie d'une image
  
  <strong>imagecopyresized()</strong> copie une partie rectangulaire d'une image dans une autre image de destination.
  <strong>$dst_image</strong> est l'image de destination, <strong>$src_image</strong> est l'image source.
  
  En d'autres termes, <strong>imagecopyresized()</strong> prendra une forme rectangulaire <strong>$src_image</strong> d'une largeur de
  <strong>$src_width</strong> et d'une hauteur <strong>$src_height</strong> à la position (<strong>$src_x</strong>,<strong>$src_y</strong>) et le placera dans une zone
  rectangulaire <strong>$dst_image</strong> d'une largeur de <strong>$dst_width</strong> et d'une hauteur de <strong>$dst_height</strong> à la position
  (<strong>$dst_x</strong>,<strong>$dst_y</strong>).
  
  Si les dimensions de la source et de la destination ne sont pas égales, un étirement adéquat est
  effectué pour faire correspondre les deux. Les coordonnées fournies sont définies par rapport au
  coin supérieur gauche. Cette fonction peut être utilisée pour recopier des régions à l'intérieur
  d'une même image (si <strong>$dst_image</strong> et <strong>$src_image</strong> sont identiques), mais si les régions se
  chevauchent, le résultat risque d'être incohérent.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst_image</strong>   Ressource cible de l'image.
  <info>GdImage</info>  <strong>$src_image</strong>   Ressource source de l'image.
  <info>int</info>      <strong>$dst_x</strong>       X : coordonnée du point de destination.
  <info>int</info>      <strong>$dst_y</strong>       Y : coordonnée du point de destination.
  <info>int</info>      <strong>$src_x</strong>       X : coordonnée du point source.
  <info>int</info>      <strong>$src_y</strong>       Y : coordonnée du point source.
  <info>int</info>      <strong>$dst_width</strong>   Largeur de la destination.
  <info>int</info>      <strong>$dst_height</strong>  Hauteur de la destination.
  <info>int</info>      <strong>$src_width</strong>   Largeur de la source.
  <info>int</info>      <strong>$src_height</strong>  Hauteur de la source.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagecopyresampled()</strong>
   * <strong>imagescale()</strong>
   * <strong>imagecrop()</strong>


id: imagecreate
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image à palette
  
  <strong>imagecreate()</strong> retourne un identifiant d'image représentant une image vide.
  
  En général, nous recommandons l'utilisation de la fonction <strong>imagecreatetruecolor()</strong> au lieu de la
  fonction <strong>imagecreate()</strong> afin que l'opération sur l'image s'effectue avec une qualité la plus haute
  possible. Si vous voulez sortir une palette, alors la fonction <strong>imagetruecolortopalette()</strong> doit être
  appelée immédiatement avant l'enregistrement de l'image avec la fonction <strong>imagepng()</strong> ou la fonction
  <strong>imagegif()</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$width</strong>   La largeur de l'image.
  <info>int</info>  <strong>$height</strong>  La hauteur de l'image.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagedestroy()</strong>
   * <strong>imagecreatetruecolor()</strong>


id: imagecreatefromavif
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image depuis un fichier ou une URL
  
  <strong>imagecreatefromavif()</strong> retourne un objet image obtenu à partir du fichier <strong>$filename</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers l'image AVIF.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefrombmp
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image depuis un fichier ou une URL
  
  <strong>imagecreatefrombmp()</strong> retourne un identifiant d'image représentant l'image obtenue à partir du nom
  de fichier fournit.
  
  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a
  été activé. Voyez <strong>fopen()</strong> pour plus de détails sur la façon de spécifier le nom du fichier.
  Reportez-vous aux  pour plus d'informations sur les capacités des différents gestionnaires, les
  notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles
  fournissent.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin de l'image BMP.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefromgd
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image à partir d'un fichier GD ou d'une URL
  
  Crée une nouvelle image depuis un fichier GD ou une URL.
  
  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a
  été activé. Voyez <strong>fopen()</strong> pour plus de détails sur la façon de spécifier le nom du fichier.
  Reportez-vous aux  pour plus d'informations sur les capacités des différents gestionnaires, les
  notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles
  fournissent.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers un fichier GD.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefromgd2
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image à partir d'un fichier GD2 ou d'une URL
  
  Crée une nouvelle image depuis un fichier GD2 ou une URL.
  
  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a
  été activé. Voyez <strong>fopen()</strong> pour plus de détails sur la façon de spécifier le nom du fichier.
  Reportez-vous aux  pour plus d'informations sur les capacités des différents gestionnaires, les
  notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles
  fournissent.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers l'image GD2.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefromgd2part
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image à partir d'une partie de fichier GD2 ou d'une URL
  
  Crée une nouvelle image depuis une partie d'un fichier GD2 ou d'une URL.
  
  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a
  été activé. Voyez <strong>fopen()</strong> pour plus de détails sur la façon de spécifier le nom du fichier.
  Reportez-vous aux  pour plus d'informations sur les capacités des différents gestionnaires, les
  notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles
  fournissent.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers l'image GD2.
  <info>int</info>     <strong>$x</strong>         Coordonnée en X du point source.
  <info>int</info>     <strong>$y</strong>         Coordonnée en Y du point source.
  <info>int</info>     <strong>$width</strong>     Largeur de la source.
  <info>int</info>     <strong>$height</strong>    Hauteur de la source.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefromgif
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image depuis un fichier ou une URL
  
  <strong>imagecreatefromgif()</strong> retourne un identifiant d'image qui représente l'image obtenue à partir du
  fichier dont le nom est donné par <strong>$filename</strong>.
  
  Lors de la lecture en mémoire de fichiers GIF animés, seule la première frame est retournée par
  l'objet de l'image. La taille de l'image n'est pas forcément ce qui est rapporté par
  <strong>getimagesize()</strong>.
  
  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a
  été activé. Voyez <strong>fopen()</strong> pour plus de détails sur la façon de spécifier le nom du fichier.
  Reportez-vous aux  pour plus d'informations sur les capacités des différents gestionnaires, les
  notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles
  fournissent.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers l'image GIF.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefromjpeg
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image depuis un fichier ou une URL
  
  <strong>imagecreatefromjpeg()</strong> retourne un identifiant d'image représentant une image obtenue à partir du
  fichier <strong>$filename</strong>.
  
  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a
  été activé. Voyez <strong>fopen()</strong> pour plus de détails sur la façon de spécifier le nom du fichier.
  Reportez-vous aux  pour plus d'informations sur les capacités des différents gestionnaires, les
  notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles
  fournissent.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers l'image JPEG.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefrompng
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image depuis un fichier ou une URL
  
  <strong>imagecreatefrompng()</strong> retourne un identifiant d'image représentant une image obtenue à partir du
  fichier <strong>$filename</strong>.
  
  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a
  été activé. Voyez <strong>fopen()</strong> pour plus de détails sur la façon de spécifier le nom du fichier.
  Reportez-vous aux  pour plus d'informations sur les capacités des différents gestionnaires, les
  notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles
  fournissent.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers l'image PNG.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefromstring
type: function
doc:
<comment>Description:</comment>
  Crée une image à partir d'une chaîne
  
  <strong>imagecreatefromstring()</strong> retourne un identifiant d'image représentant l'image obtenue depuis la
  chaîne <strong>$data</strong>. Le type de l'image sera automatiquement détecté si vous avez compilé PHP avec les
  supports : JPEG, PNG, GIF, BMP, WBMP, GD2, et WEBP.

<comment>Param:</comment>
  <info>string</info>  <strong>$data</strong>  Une chaîne contenant les données de l'image.

<comment>Return:</comment>
  <info>GdImage|false</info>  Un objet d'image sera retourné en cas de succès. <info>false</info> est retourné si le type de
                 l'image n'est pas supporté, si les données ne sont pas dans un format reconnu ou si
                 l'image est corrompue et donc ne peut être chargée.

<comment>See Also:</comment>
   * <strong>imagecreatefromjpeg()</strong>
   * <strong>imagecreatefrompng()</strong>
   * <strong>imagecreatefromgif()</strong>
   * <strong>imagecreatetruecolor()</strong>


id: imagecreatefromtga
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image depuis un fichier ou une URL
  
  <strong>imagecreatefromtga()</strong> retourne un objet image représentant l'image obtenue à partir du nom de
  fichier donné.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin d'accès à l'image TGA Truevision.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefromwbmp
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image depuis un fichier ou une URL
  
  <strong>imagecreatefromwbmp()</strong> retourne une ressource d'image PHP, représentant l'image <strong>$filename</strong>.
  
  Les images WBMP sont Wireless Bitmaps, et non Windows Bitmaps. Le dernier peut être chargé grâce à
  <strong>imagecreatefrombmp()</strong>.
  
  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a
  été activé. Voyez <strong>fopen()</strong> pour plus de détails sur la façon de spécifier le nom du fichier.
  Reportez-vous aux  pour plus d'informations sur les capacités des différents gestionnaires, les
  notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles
  fournissent.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers l'image WBMP.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefromwebp
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image depuis un fichier ou une URL
  
  <strong>imagecreatefromwebp()</strong> retourne un identifiant d'image représentant l'image obtenue depuis le
  fichier fourni. Notez que les fichiers WebP animés ne peuvent pas être lus.
  
  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a
  été activé. Voyez <strong>fopen()</strong> pour plus de détails sur la façon de spécifier le nom du fichier.
  Reportez-vous aux  pour plus d'informations sur les capacités des différents gestionnaires, les
  notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles
  fournissent.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers l'image WebP.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefromxbm
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image depuis un fichier ou une URL
  
  <strong>imagecreatefromxbm()</strong> retourne un identifiant d'image représentant l'image obtenue à partir du
  fichier <strong>$filename</strong>.
  
  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a
  été activé. Voyez <strong>fopen()</strong> pour plus de détails sur la façon de spécifier le nom du fichier.
  Reportez-vous aux  pour plus d'informations sur les capacités des différents gestionnaires, les
  notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles
  fournissent.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers l'image XBM.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatefromxpm
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image depuis un fichier ou une URL
  
  <strong>imagecreatefromxpm()</strong> retourne un identifiant d'image représentant l'image obtenue à partir du
  fichier <strong>$filename</strong>.
  
  Vous pouvez utiliser une URL comme nom de fichier avec cette fonction, si le gestionnaire fopen a
  été activé. Voyez <strong>fopen()</strong> pour plus de détails sur la façon de spécifier le nom du fichier.
  Reportez-vous aux  pour plus d'informations sur les capacités des différents gestionnaires, les
  notes sur leur utilisation, ainsi que les informations sur les variables prédéfinies qu'elles
  fournissent.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers l'image XPM.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.


id: imagecreatetruecolor
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle image en couleurs vraies
  
  <strong>imagecreatetruecolor()</strong> retourne un objet représentant une image noire.

<comment>Param:</comment>
  <info>int</info>  <strong>$width</strong>   Largeur de l'image.
  <info>int</info>  <strong>$height</strong>  Hauteur de l'image.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image en cas de succès, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagedestroy()</strong>
   * <strong>imagecreate()</strong>


id: imagecrop
type: function
doc:
<comment>Description:</comment>
  Recadre une image sur le rectangle donné
  
  Recadre une image à la zone rectangulaire donnée et retourne l'image  résultante. L'<strong>$image</strong> n'est
  pas modifiée.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>      Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                       <strong>imagecreatetruecolor()</strong>.
  <info>array</info>    <strong>$rectangle</strong>  <info>array</info> contenant les clés <return>x</return>,  <return>y</return>, <return>width</return> et <return>height</return>.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne l'objet' de l'image recadrée en cas de succès ou <info>false</info> si une erreur
                 survient.

<comment>See Also:</comment>
   * <strong>imagecropauto()</strong>


id: imagecropauto
type: function
doc:
<comment>Description:</comment>
  Recadre une image automatiquement en utilisant un des modes disponibles
  
  Rogne automatiquement une image selon le <strong>$mode</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>      Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                       <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$mode</strong>       Une constante parmi :
                       
                       Identique à <info>IMG_CROP_TRANSPARENT</info>. Antérieur à PHP 7.4.0, la bibliothèque
                       libgd intégré utilisait <info>IMG_CROP_SIDES</info> en tant que solution de replis, si
                       l'image n'avait pas de couleur de transparance.
                       
                       Rogne le fond transparent.
                       
                       Rogne le fond noir.
                       
                       Rogne le fond blanc.
                       
                       Utilise les 4 coins de l'image pour tenter de détecter l'arrière-plan  à
                       rogner.
                       
                       Rogne l'image en utilisant le seuil <strong>$threshold</strong> et  <strong>$color</strong>.
  <info>float</info>    <strong>$threshold</strong>  Rogne l'image en utilisant le seuil <strong>$threshold</strong> et  <strong>$color</strong>.
  <info>float</info>    <strong>$threshold</strong>  Spécifie la tolérance en pourcentage à utiliser lors de la comparaison de  la
                       couleur d'image et de la couleur à rogner. La méthode utilisée pour  calculer
                       la différence de couleur est basée sur la distance des couleurs  dans le cube
                       RVB(a).
                       
                       Utilisé uniquement en mode <info>IMG_CROP_THRESHOLD</info>.
                       
                       Antérieur à PHP 7.4.0, la bibliothèque libgd intégré utilisait un algorithme
                       quelque peu différent, donc le même <strong>$threshold</strong> produisait des résultats
                       différents pour libgd système et intégré.
  <info>int</info>      <strong>$color</strong>      Soit une valeur de couleur RVB, soit un index de palette.
                       
                       Utilisé uniquement en mode <info>IMG_CROP_THRESHOLD</info>.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne l'objet' de l'image rognée en cas de succès ou <info>false</info> si une erreur
                 survient. Si l'image complète a été rognée, <strong>imagecrop()</strong> retourne <info>false</info>.

<comment>See Also:</comment>
   * <strong>imagecrop()</strong>


id: imagedashedline
type: function
doc:
<comment>Description:</comment>
  Dessine une ligne pointillée
  
  <strong>imagedashedline()</strong> est obsolète. Utilisez plutôt une combinaison des fonctions <strong>imagesetstyle()</strong> et
  <strong>imageline()</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x1</strong>     Coordonnée en X : En haut, à gauche.
  <info>int</info>      <strong>$y1</strong>     Coordonnée en Y : En haut, à gauche. 0 est le coin en haut à gauche de l'image.
  <info>int</info>      <strong>$x2</strong>     Coordonnée en X : En bas, à droite.
  <info>int</info>      <strong>$y2</strong>     Coordonnée en Y : En bas, à droite.
  <info>int</info>      <strong>$color</strong>  La couleur de remplissage. Un identificateur de couleur créé avec
                   <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagesetstyle()</strong>
   * <strong>imageline()</strong>


id: imagedestroy
type: function
doc:
<comment>Description:</comment>
  Détruit une image
  
  Cette fonction n'a aucun effet. Antérieur à PHP 8.0.0, cette fonction était utilisé pour fermer
  une ressource.
  
  Antérieur à PHP 8.0.0, <strong>imagedestroy()</strong> libère toute la mémoire associée à l'image <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imageellipse
type: function
doc:
<comment>Description:</comment>
  Dessine une ellipse
  
  Dessine une ellipse centrée sur le point spécifié.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>     Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                      <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$center_x</strong>  X : coordonnée du centre.
  <info>int</info>      <strong>$center_y</strong>  Y : coordonnée du centre.
  <info>int</info>      <strong>$width</strong>     La largeur de l'ellipse.
  <info>int</info>      <strong>$height</strong>    La hauteur de l'ellipse.
  <info>int</info>      <strong>$color</strong>     La couleur de l'ellipse. Un identificateur de couleur créé avec
                      <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagefilledellipse()</strong>
   * <strong>imagearc()</strong>


id: imagefill
type: function
doc:
<comment>Description:</comment>
  Remplissage
  
  Effectue un remplissage avec la couleur <strong>$color</strong>, dans l'image <strong>$image</strong>, à partir du point de
  coordonnées (<strong>$x</strong>, <strong>$y</strong>) (le coin supérieur gauche est l'origine (0,0)).

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x</strong>      X : coordonnée du point de départ.
  <info>int</info>      <strong>$y</strong>      Y : coordonnée du point de départ.
  <info>int</info>      <strong>$color</strong>  La couleur de remplissage. Un identificateur de couleur créé avec
                   <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagecolorallocate()</strong>


id: imagefilledarc
type: function
doc:
<comment>Description:</comment>
  Dessine un arc partiel et le remplit
  
  Dessine un arc partiel, centré aux coordonnées spécifiées dans l'image fournie.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>        Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images,
                         comme <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$center_x</strong>     X : coordonnée du centre.
  <info>int</info>      <strong>$center_y</strong>     Y : coordonnée du centre.
  <info>int</info>      <strong>$width</strong>        La largeur de l'arc.
  <info>int</info>      <strong>$height</strong>       La hauteur de l'arc.
  <info>int</info>      <strong>$start_angle</strong>  L'angle de début de l'arc, en degrés.
  <info>int</info>      <strong>$end_angle</strong>    L'angle de fin de l'arc, en degrés. 0° est situé à une position de 3 heures
                         sur un cadran horaire, et l'arc est dessiné dans le sens des aiguilles
                         d'une montre.
  <info>int</info>      <strong>$color</strong>        Un identificateur de couleur créé avec <strong>imagecolorallocate()</strong>.
  <info>int</info>      <strong>$style</strong>        Un champ d'octets, combiné avec l'opérateur OR :
                         <info>IMG_ARC_PIE</info><info>IMG_ARC_CHORD</info><info>IMG_ARC_NOFILL</info><info>IMG_ARC_EDGED</info> <info>IMG_ARC_PIE</info> et
                         <info>IMG_ARC_CHORD</info> sont mutuellement exclusives; <info>IMG_ARC_CHORD</info> ne fait que
                         connecter les angles de début et de fin avec une ligne droite, tandis que
                         <info>IMG_ARC_PIE</info> produit une ligne courbe. <info>IMG_ARC_NOFILL</info> indique que l'arc (ou
                         corde) doit être dessiné mais pas rempli. <info>IMG_ARC_EDGED</info>, utilisé
                         conjointement avec <info>IMG_ARC_NOFILL</info>, indique que les angles de début et de
                         fin doivent être connectés au centre. Cette fonction est recommandée pour
                         faire les graphiques de type camembert.
                         
                         <info>IMG_ARC_PIE</info>
                         
                         <info>IMG_ARC_CHORD</info>
                         
                         <info>IMG_ARC_NOFILL</info>
                         
                         <info>IMG_ARC_EDGED</info>

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imagefilledellipse
type: function
doc:
<comment>Description:</comment>
  Dessine une ellipse pleine
  
  Dessine une ellipse centrée sur les coordonnées spécifiées sur l'image fournie.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>     Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                      <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$center_x</strong>  X : coordonnée du centre.
  <info>int</info>      <strong>$center_y</strong>  Y : coordonnée du centre.
  <info>int</info>      <strong>$width</strong>     La largeur de l'ellipse.
  <info>int</info>      <strong>$height</strong>    La hauteur de l'ellipse.
  <info>int</info>      <strong>$color</strong>     La couleur de remplissage. Un identificateur de couleur créé avec
                      <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imageellipse()</strong>
   * <strong>imagefilledarc()</strong>


id: imagefilledpolygon
type: function
doc:
<comment>Description:</comment>
  Dessine un polygone rempli
  
  Signature à partir de PHP 8.0.0 (non supportée avec les arguments nommés)
  
  Signature alternative (obsolète à partir de PHP 8.1.0)
  
  <strong>imagefilledpolygon()</strong> dessine un polygone rempli dans l'image <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>       Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images,
                        comme <strong>imagecreatetruecolor()</strong>.
  <info>array</info>    <strong>$points</strong>      Un tableau qui contient les coordonnées <return>x</return> et <return>y</return> du sommet des polygones.
  <info>int</info>      <strong>$num_points</strong>  Nombre total de points (sommets), qui doivent être d'au moins 3.
                        
                        Si ce paramètre est omis conformément à la deuxième signature, <strong>$points</strong> doit
                        avoir un nombre pair d'éléments, et <strong>$num_points</strong> est assumé d'être
                        count($points)/2.
  <info>int</info>      <strong>$color</strong>       Un identificateur de couleur créé avec <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagepolygon()</strong>


id: imagefilledrectangle
type: function
doc:
<comment>Description:</comment>
  Dessine un rectangle rempli
  
  Dessine un rectangle de couleur <strong>$color</strong> dans l'image <strong>$image</strong>, en commençant par le sommet supérieur
  gauche (1) et finissant au sommet inférieur droit (2). Le coin supérieur gauche est l'origine (0,
  0).

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x1</strong>     X : coordonné du point 1.
  <info>int</info>      <strong>$y1</strong>     Y : coordonné du point 1.
  <info>int</info>      <strong>$x2</strong>     X : coordonné du point 2.
  <info>int</info>      <strong>$y2</strong>     Y : coordonné du point 2.
  <info>int</info>      <strong>$color</strong>  La couleur de remplissage. Un identificateur de couleur créé avec
                   <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imagefilltoborder
type: function
doc:
<comment>Description:</comment>
  Remplit une région avec une couleur spécifique
  
  <strong>imagefilltoborder()</strong> remplit avec la couleur <strong>$color</strong> toute la région à l'intérieur de la région
  limitée par la couleur <strong>$border_color</strong>. Le point de départ est (<strong>$x</strong>, <strong>$y</strong>) (le coin supérieur gauche
  est l'origine (0,0)) et la couleur de la région est <strong>$color</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>         Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images,
                          comme <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x</strong>             X : coordonné de départ.
  <info>int</info>      <strong>$y</strong>             Y : coordonné de départ.
  <info>int</info>      <strong>$border_color</strong>  La couleur de la bordure. Un identificateur de couleur créé avec
                          <strong>imagecolorallocate()</strong>.
  <info>int</info>      <strong>$color</strong>         La couleur de remplissage. Un identificateur de couleur créé avec
                          <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imagefilter
type: function
doc:
<comment>Description:</comment>
  Applique un filtre à une image
  
  <strong>imagefilter()</strong> applique le filtre donné <strong>$filter</strong> sur l'<strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>   Un objet <class>GdImage</class>, retournée par une des fonctions de création
                                 d'images, comme <strong>imagecreatetruecolor()</strong>.
  <info>int</info>                   <strong>$filter</strong>  <strong>$filter</strong> peut être l'un des éléments suivants : <info>IMG_FILTER_NEGATE</info> :
                                 Inverse toutes les couleurs de l'image. <info>IMG_FILTER_GRAYSCALE</info> :
                                 Convertit l'image en niveaux de gris en changeant les composantes
                                 rouge, verte et bleue en leur somme pondérée en utilisant les mêmes
                                 coefficients que le calcul luma REC.601 (Y'). Les composantes alpha
                                 sont conservées. Pour les images de la palette, le résultat peut
                                 être différent en raison des limitations de la palette.
                                 <info>IMG_FILTER_BRIGHTNESS</info> : Modifie la luminosité de l'image. Utilisez
                                 <strong>$args</strong> pour définir le niveau de luminosité. La plage de luminosité
                                 est comprise entre -255 et 255. <info>IMG_FILTER_CONTRAST</info> : Modifie le
                                 contraste de l'image. Utilisez <strong>$args</strong> pour définir le niveau de
                                 contraste. <info>IMG_FILTER_COLORIZE</info> : similaire à <info>IMG_FILTER_GRAYSCALE</info>,
                                 sauf qu'il est possible de spécifier la couleur. Utilisez <strong>$args</strong>,
                                 <strong>$arg2</strong> et <strong>$arg3</strong> sous la forme <strong>$red</strong>, <strong>$green</strong>, <strong>$blue</strong> et <strong>$arg4</strong> pour le
                                 canal <strong>$alpha</strong>. La plage de chaque couleur est comprise entre 0 et
                                 255. <info>IMG_FILTER_EDGEDETECT</info> : Utilise la détection des contours pour
                                 mettre en évidence les contours de l'image. <info>IMG_FILTER_EMBOSS</info> :
                                 Permet d'embosser l'image. <info>IMG_FILTER_GAUSSIAN_BLUR</info> : Floute
                                 l'image à l'aide de la méthode gaussienne.
                                 <info>IMG_FILTER_SELECTIVE_BLUR</info> : Floute l'image. <info>IMG_FILTER_MEAN_REMOVAL</info>
                                 : Utilise la suppression de la moyenne pour obtenir un effet
                                 "croquis". <info>IMG_FILTER_SMOOTH</info> : Rend l'image plus lisse. Utilisez
                                 <strong>$args</strong> pour définir le niveau de lissage. <info>IMG_FILTER_PIXELATE</info> :
                                 Applique un effet de pixellisation  à l'image, utilisez <strong>$args</strong> pour
                                 définir la taille du bloc et <strong>$arg2</strong> pour définir le mode d'effet de
                                 pixellisation. <info>IMG_FILTER_SCATTER</info> : Applique un effet de dispersion
                                 à l'image, utilisez <strong>$args</strong> et  <strong>$arg2</strong> pour définir l'intensité de
                                 l'effet et  <strong>$arg3</strong> pour n'appliquer l'effet que  sur certaines
                                 couleurs de pixels.
                                 
                                 <info>IMG_FILTER_NEGATE</info> : Inverse toutes les couleurs de l'image.
                                 
                                 <info>IMG_FILTER_GRAYSCALE</info> : Convertit l'image en niveaux de gris en
                                 changeant les composantes rouge, verte et bleue en leur somme
                                 pondérée en utilisant les mêmes coefficients que le calcul luma
                                 REC.601 (Y'). Les composantes alpha sont conservées. Pour les
                                 images de la palette, le résultat peut être différent en raison des
                                 limitations de la palette.
                                 
                                 <info>IMG_FILTER_BRIGHTNESS</info> : Modifie la luminosité de l'image. Utilisez
                                 <strong>$args</strong> pour définir le niveau de luminosité. La plage de luminosité
                                 est comprise entre -255 et 255.
                                 
                                 <info>IMG_FILTER_CONTRAST</info> : Modifie le contraste de l'image. Utilisez
                                 <strong>$args</strong> pour définir le niveau de contraste.
                                 
                                 <info>IMG_FILTER_COLORIZE</info> : similaire à <info>IMG_FILTER_GRAYSCALE</info>, sauf qu'il
                                 est possible de spécifier la couleur. Utilisez <strong>$args</strong>, <strong>$arg2</strong> et
                                 <strong>$arg3</strong> sous la forme <strong>$red</strong>, <strong>$green</strong>, <strong>$blue</strong> et <strong>$arg4</strong> pour le canal
                                 <strong>$alpha</strong>. La plage de chaque couleur est comprise entre 0 et 255.
                                 
                                 <info>IMG_FILTER_EDGEDETECT</info> : Utilise la détection des contours pour
                                 mettre en évidence les contours de l'image.
                                 
                                 <info>IMG_FILTER_EMBOSS</info> : Permet d'embosser l'image.
                                 
                                 <info>IMG_FILTER_GAUSSIAN_BLUR</info> : Floute l'image à l'aide de la méthode
                                 gaussienne.
                                 
                                 <info>IMG_FILTER_SELECTIVE_BLUR</info> : Floute l'image.
                                 
                                 <info>IMG_FILTER_MEAN_REMOVAL</info> : Utilise la suppression de la moyenne pour
                                 obtenir un effet "croquis".
                                 
                                 <info>IMG_FILTER_SMOOTH</info> : Rend l'image plus lisse. Utilisez <strong>$args</strong> pour
                                 définir le niveau de lissage.
                                 
                                 <info>IMG_FILTER_PIXELATE</info> : Applique un effet de pixellisation  à
                                 l'image, utilisez <strong>$args</strong> pour définir la taille du bloc et <strong>$arg2</strong>
                                 pour définir le mode d'effet de pixellisation.
                                 
                                 <info>IMG_FILTER_SCATTER</info> : Applique un effet de dispersion  à l'image,
                                 utilisez <strong>$args</strong> et  <strong>$arg2</strong> pour définir l'intensité de l'effet et
                                 <strong>$arg3</strong> pour n'appliquer l'effet que  sur certaines couleurs de
                                 pixels.
  <info>array|int|float|bool</info>  <strong>$args</strong>    <info>IMG_FILTER_BRIGHTNESS</info> : Niveau de luminosité. <info>IMG_FILTER_CONTRAST</info> :
                                 Niveau de contraste. <info>IMG_FILTER_COLORIZE</info> : Valeur du composant
                                 rouge. <info>IMG_FILTER_SMOOTH</info> : Niveau de lissage. <info>IMG_FILTER_PIXELATE</info> :
                                 Taille du bloc en pixels. <info>IMG_FILTER_SCATTER</info> : Niveau de
                                 soustraction de l'effet.  Il ne doit pas être supérieur ou égal au
                                 niveau d'addition défini avec  <strong>$arg2</strong>.
                                 
                                 <info>IMG_FILTER_BRIGHTNESS</info> : Niveau de luminosité.
                                 
                                 <info>IMG_FILTER_CONTRAST</info> : Niveau de contraste.
                                 
                                 <info>IMG_FILTER_COLORIZE</info> : Valeur du composant rouge.
                                 
                                 <info>IMG_FILTER_SMOOTH</info> : Niveau de lissage.
                                 
                                 <info>IMG_FILTER_PIXELATE</info> : Taille du bloc en pixels.
                                 
                                 <info>IMG_FILTER_SCATTER</info> : Niveau de soustraction de l'effet.  Il ne doit
                                 pas être supérieur ou égal au niveau d'addition défini avec  <strong>$arg2</strong>.
  <info></info>                      <strong>$arg2</strong>    <info>IMG_FILTER_COLORIZE</info> : Valeur du composant vert. <info>IMG_FILTER_PIXELATE</info>
                                 : Utilisation ou non de l'effet de pixellisation  avancé (la valeur
                                 par défaut est <info>false</info>). <info>IMG_FILTER_SCATTER</info> : Niveau d'addition de
                                 l'effet.
                                 
                                 <info>IMG_FILTER_COLORIZE</info> : Valeur du composant vert.
                                 
                                 <info>IMG_FILTER_PIXELATE</info> : Utilisation ou non de l'effet de
                                 pixellisation  avancé (la valeur par défaut est <info>false</info>).
                                 
                                 <info>IMG_FILTER_SCATTER</info> : Niveau d'addition de l'effet.
  <info></info>                      <strong>$arg3</strong>    <info>IMG_FILTER_COLORIZE</info> : Valeur du composant bleu. <info>IMG_FILTER_SCATTER</info>
                                 : Tableau optionnel de valeurs de couleur indexées  pour appliquer
                                 l'effet.
                                 
                                 <info>IMG_FILTER_COLORIZE</info> : Valeur du composant bleu.
                                 
                                 <info>IMG_FILTER_SCATTER</info> : Tableau optionnel de valeurs de couleur
                                 indexées  pour appliquer l'effet.
  <info></info>                      <strong>$arg4</strong>    <info>IMG_FILTER_COLORIZE</info> canal Alpha, une valeur  entre 0 et 127. 0
                                 indique une opacité totale tandis que 127 indique une  transparence
                                 totale.
                                 
                                 <info>IMG_FILTER_COLORIZE</info> canal Alpha, une valeur  entre 0 et 127. 0
                                 indique une opacité totale tandis que 127 indique une  transparence
                                 totale.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imageconvolution()</strong>


id: imageflip
type: function
doc:
<comment>Description:</comment>
  Retourne une image en utilisant le mode fourni
  
  Retourne l'image <strong>$image</strong> en utilisant le <strong>$mode</strong> fourni.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$mode</strong>   Mode de retournement ; peut-être une des constantes <info>IMG_FLIP_*</info> :
                   
                   ConstanteSignification<info>IMG_FLIP_HORIZONTAL</info> Retourne l'image horizontalement.
                   <info>IMG_FLIP_VERTICAL</info> Retourne l'image verticalement. <info>IMG_FLIP_BOTH</info> Retourne l'image
                   à la fois horizontalement et verticalement.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imagefontheight
type: function
doc:
<comment>Description:</comment>
  Retourne la hauteur de la police
  
  Retourne la hauteur de la police <strong>$font</strong> en pixels.

<comment>Param:</comment>
  <info>GdFont|int</info>  <strong>$font</strong>  Peut être 1, 2, 3, 4, 5 pour les polices internes d'encodage Latin2 (où les
                     plus grands nombres correspondent aux polices larges) ou une instance de <class>GdFont</class>
                     retourné par <strong>imageloadfont()</strong>.

<comment>Return:</comment>
  <info>int</info>  Retourne la hauteur de la police, en pixels.

<comment>See Also:</comment>
   * <strong>imagefontwidth()</strong>
   * <strong>imageloadfont()</strong>


id: imagefontwidth
type: function
doc:
<comment>Description:</comment>
  Retourne la largeur de la police
  
  Retourne la largeur de la police <strong>$font</strong> en pixels.

<comment>Param:</comment>
  <info>GdFont|int</info>  <strong>$font</strong>  Peut être 1, 2, 3, 4, 5 pour les polices internes d'encodage Latin2 (où les
                     plus grands nombres correspondent aux polices larges) ou une instance de <class>GdFont</class>
                     retourné par <strong>imageloadfont()</strong>.

<comment>Return:</comment>
  <info>int</info>  Retourne la largeur de la police.

<comment>See Also:</comment>
   * <strong>imagefontheight()</strong>
   * <strong>imageloadfont()</strong>


id: imageftbbox
type: function
doc:
<comment>Description:</comment>
  Calcule le rectangle d'encadrement pour un texte, en utilisant la police courante et freetype2
  
  <strong>imageftbbox()</strong> calcule le rectangle d'encadrement pour le texte <strong>$text</strong>, en utilisant la police
  courante et freetype2.
  
  Antérieur à PHP 8.0.0, <strong>imageftbbox()</strong> était une variante étendue de <strong>imagettfbbox()</strong> qui en plus
  supporte <strong>$extrainfo</strong>. À partir de PHP 8.0.0, <strong>imagettfbbox()</strong> est un alias de <strong>imageftbbox()</strong>.

<comment>Param:</comment>
  <info>float</info>   <strong>$size</strong>           La taille de la police de caractères en point.
  <info>float</info>   <strong>$angle</strong>          Angle, en degrés, dans lequel le paramètre <strong>$string</strong> sera mesuré.
  <info>string</info>  <strong>$font_filename</strong>  Le nom du fichier de la police TrueType (peut être une URL). Suivant la
                          version de GD utilisée par PHP, il sera recherché les fichiers qui ne
                          commencent pas par un '/', en y ajoutant l'extension '.ttf', et suivant le
                          chemin des polices défini par la bibliothèque.
  <info>string</info>  <strong>$string</strong>         La chaîne à mesurer.
  <info>array</info>   <strong>$options</strong>        Index possibles pour le tableau
                          <strong>$options</strong>CléTypeSignification<return>linespacing</return><info>float</info>Représente l'espacement entre
                          les lignes lors du dessin

<comment>Return:</comment>
  <info>array|false</info>  <strong>imageftbbox()</strong> retourne un tableau contenant 8 éléments représentant les 4 points du
               rectangle entourant le texte : 0Coin en bas, à gauche, position en X1Coin en bas, à
               gauche, position en Y2Coin en bas, à droite, position en X3Coin en bas, à droite,
               position en Y4Coin en haut, à droite, position en X5Coin en haut, à droite, position
               en Y6Coin en haut, à gauche, position en X7Coin en haut, à gauche, position en Y
               
               Les points sont relatifs au texte suivant le paramètre <strong>$angle</strong>, aussi, "en haut à
               gauche" signifie le coin en haut à gauche lorsque l'on regarde le texte
               horizontalement.
               
               En cas d'échec, <info>false</info> est retourné.

<comment>See Also:</comment>
   * <strong>imagefttext()</strong>
   * <strong>imagettfbbox()</strong>


id: imagefttext
type: function
doc:
<comment>Description:</comment>
  Écrit du texte dans une image avec la police courante FreeType 2
  
  Antérieur à PHP 8.0.0, <strong>imagefttext()</strong> était une variante étendue de <strong>imagettftext()</strong> qui en plus
  supporte <strong>$extrainfo</strong>. À partir de PHP 8.0.0, <strong>imagefttext()</strong> est un alias de <strong>imagefttext()</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>          Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images,
                           comme <strong>imagecreatetruecolor()</strong>.
  <info>float</info>    <strong>$size</strong>           La taille de la police à utiliser, en nombre de points.
  <info>float</info>    <strong>$angle</strong>          L'angle, en degrés ; 0 degré pour une lecture du texte de gauche à
                           droite. Les grandes valeurs représentent une rotation dans le sens des
                           aiguilles d'une montre. Par exemple, une valeur de 90 aura pour effet de
                           lire le texte du bas vers le haut.
  <info>int</info>      <strong>$x</strong>              Les coordonnées, fournies par <strong>$x</strong> et <strong>$y</strong> définissent le point de départ du
                           premier caractère (et plus précisément, le coin en bas à gauche du
                           caractère). C'est un comportement différent de la fonction <strong>imagestring()</strong>,
                           où <strong>$x</strong> et <strong>$y</strong> définissent le coin en haut, à gauche du premier caractère.
                           Par exemple, en haut à gauche vaut 0, 0.
  <info>int</info>      <strong>$y</strong>              L'ordonnée <return>y-ordinate</return>. Ce paramètre configure la position de base de la
                           police, et non pas le bas de cette dernière.
  <info>int</info>      <strong>$color</strong>          L'index de la couleur désirée pour le texte, voir la fonction
                           <strong>imagecolorexact()</strong>.
  <info>string</info>   <strong>$font_filename</strong>  Le chemin vers la police TrueType à utiliser.
                           
                           Suivant la version de GD utilisée par PHP, il sera recherché les fichiers
                           qui ne commencent pas par un '<return>/</return>', en y ajoutant l'extension '<return>.ttf</return>', et
                           suivant le chemin des polices défini par la bibliothèque.
                           
                           Dans la plupart des cas, lorsque la police se trouve dans le même dossier
                           que le script qui cherche à l'utiliser, la solution suivante permet de
                           s'affranchir de tous les problèmes relatifs à l'inclusion.
                           ]]>
  <info>string</info>   <strong>$text</strong>           Le texte à insérer dans l'image.
  <info>array</info>    <strong>$options</strong>        Indexes possibles pour le tableau
                           <strong>$options</strong>CléTypeSignification<return>linespacing</return><info>float</info>Définit l'espacement entre
                           les lignes lors du dessin

<comment>Return:</comment>
  <info>array|false</info>  Cette fonction retourne un tableau définissant les 4 points d'une boîte, en
               commençant par le coin en bas, à gauche, puis, les suivants, dans le sens des
               aiguilles d'une montre : 0x : coordonnée en bas, à gauche1y : coordonnée en bas, à
               gauche2x : coordonnée en bas, à droite3y : coordonnée en bas, à droite4x : coordonnée
               en haut, à droite5y : coordonnée en haut, à droite6x : coordonnée en haut, à gauche7y
               : coordonnée en haut, à gauche
               
               En cas d'échec, <info>false</info> est retourné.

<comment>See Also:</comment>
   * <strong>imageftbbox()</strong>
   * <strong>imagettftext()</strong>


id: imagegammacorrect
type: function
doc:
<comment>Description:</comment>
  Applique une correction gamma à l'image GD
  
  Applique une correction gamma à l'image GD <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>         Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images,
                          comme <strong>imagecreatetruecolor()</strong>.
  <info>float</info>    <strong>$input_gamma</strong>   Le facteur gamma d'entrée.
  <info>float</info>    <strong>$output_gamma</strong>  Le facteur gamma de sortie.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imagegd
type: function
doc:
<comment>Description:</comment>
  Génère une image au format GD, vers le navigateur ou un fichier
  
  Génère une image GD vers le fichier <strong>$file</strong>.

<comment>Param:</comment>
  <info>GdImage</info>      <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                       <strong>imagecreatetruecolor()</strong>.
  <info>string|null</info>  <strong>$file</strong>   Le chemin ou un flux de ressource ouvert (qui sera automatiquement fermé
                       après le retour de cette fonction) vers lequel le fichier sera sauvegardé. Si
                       non-défini ou <info>null</info>, le flux brute de l'image sera affiché directement.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
        
        Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagegd2()</strong>


id: imagegd2
type: function
doc:
<comment>Description:</comment>
  Génère une image au format GD2, vers le navigateur ou un fichier
  
  Génère une image au format GD2, vers le fichier <strong>$file</strong>.

<comment>Param:</comment>
  <info>GdImage</info>      <strong>$image</strong>       Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images,
                            comme <strong>imagecreatetruecolor()</strong>.
  <info>string|null</info>  <strong>$file</strong>        Le chemin ou un flux de ressource ouvert (qui sera automatiquement fermé
                            après le retour de cette fonction) vers lequel le fichier sera
                            sauvegardé. Si non-défini ou <info>null</info>, le flux brute de l'image sera affiché
                            directement.
  <info>int</info>          <strong>$chunk_size</strong>  Taille de la pièce.
  <info>int</info>          <strong>$mode</strong>        Soit <info>IMG_GD2_RAW</info>, soit <info>IMG_GD2_COMPRESSED</info>. Par défaut, vaut <info>IMG_GD2_RAW</info>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
        
        Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagegd()</strong>


id: imagegetclip
type: function
doc:
<comment>Description:</comment>
  Récupère le rectangle de coupure
  
  <strong>imagegetclip()</strong> récupère le rectangle de coupure actuel, c'est à dire la zone au-delà de laquelle
  aucun pixel ne sera dessiné.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>array</info>  La fonction retourne un tableau indexé avec les coordonnées du rectangle de coupure avec
         les entrées suivantes : la coordonnée x du coin supérieur gauchela coordonnée y du coin
         supérieur gauchela coordonnée x du coin inférieur droitela coordonnée y du coin inférieur
         droite
         
         la coordonnée x du coin supérieur gauche
         
         la coordonnée y du coin supérieur gauche
         
         la coordonnée x du coin inférieur droite
         
         la coordonnée y du coin inférieur droite

<comment>See Also:</comment>
   * <strong>imagesetclip()</strong>


id: imagegetinterpolation
type: function
doc:
<comment>Description:</comment>
  Récupère la méthode d'interpolation
  
  Récupère la méthode d'interpolation actuellement définie pour l'<strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>int</info>  Retourne la méthode d'interpolation.

<comment>See Also:</comment>
   * <strong>imagesetinterpolation()</strong>


id: imagegif
type: function
doc:
<comment>Description:</comment>
  Affichage de l'image vers le navigateur ou dans un fichier
  
  <strong>imagegif()</strong> crée un fichier image GIF dans <strong>$file</strong> d'après l'image <strong>$image</strong>. L'argument <strong>$image</strong> est un
  identifiant valide retourné par la fonction <strong>imagecreate()</strong> ou les fonctions <return>imagecreatefrom*</return>.
  
  Le format de l'image sera GIF87a, à moins que l'image n'ait une couleur transparente (mise en
  place grâce à la fonction <strong>imagecolortransparent()</strong>)), ce qui fera qu'elle sera au format GIF89a.

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création
                                d'images, comme <strong>imagecreatetruecolor()</strong>.
  <info>resource|string|null</info>  <strong>$file</strong>   Le chemin ou un flux de ressource ouvert (qui sera automatiquement
                                fermé après le retour de cette fonction) vers lequel le fichier sera
                                sauvegardé. Si non-défini ou <info>null</info>, le flux brute de l'image sera
                                affiché directement.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
        
        Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagepng()</strong>
   * <strong>imagewbmp()</strong>
   * <strong>imagejpeg()</strong>
   * <strong>imagetypes()</strong>


id: imagegrabscreen
type: function
doc:
<comment>Description:</comment>
  Capture l'écran complet
  
  <strong>imagegrabscreen()</strong> effectue une capture de la totalité de l'écran.
  
  Cette fonction n'est disponible que sous Windows.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet image en cas de succès, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagegrabwindow()</strong>


id: imagegrabwindow
type: function
doc:
<comment>Description:</comment>
  Capture une fenêtre
  
  Capture une fenêtre ou l'espace de son client, en utilisant un gestionnaire de fenêtre (propriété
  HWND de l'instance COM).
  
  Cette fonction n'est disponible que sous Windows.

<comment>Param:</comment>
  <info>int</info>   <strong>$handle</strong>       L'identifiant HWND de la fenêtre.
  <info>bool</info>  <strong>$client_area</strong>  Inclure ou non l'espace du client de la fenêtre de l'application.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet image en cas de succès, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagegrabscreen()</strong>


id: imageinterlace
type: function
doc:
<comment>Description:</comment>
  Active ou désactive l'entrelacement
  
  <strong>imageinterlace()</strong> active ou désactive le bit d'entrelacement.
  
  Si l'entrelacement est à 1 et l'image est JPEG, l'image créée sera un JPEG progressif.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>      Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                       <strong>imagecreatetruecolor()</strong>.
  <info></info>         <strong>$interlace</strong>  Si <info>true</info>, l'image sera entrelacée, si <info>false</info> le bit d'entrelacement est
                       désactivé. Passer <info>null</info> fera que le comportement d'entrelacement n'est pas
                       changé.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si l'entrelacement est activé pour l'image, <info>false</info> sinon.


id: imageistruecolor
type: function
doc:
<comment>Description:</comment>
  Détermine si une image est une image truecolor
  
  <strong>imageistruecolor()</strong>détermine si l'image <strong>$image</strong> est une image truecolor.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si l'image est truecolor, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>imagepalettetotruecolor()</strong>


id: imagejpeg
type: function
doc:
<comment>Description:</comment>
  Affichage de l'image vers le navigateur ou dans un fichier
  
  <strong>imagejpeg()</strong> crée un fichier JPEG depuis l'image fournie.

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>    Un objet <class>GdImage</class>, retournée par une des fonctions de création
                                  d'images, comme <strong>imagecreatetruecolor()</strong>.
  <info>resource|string|null</info>  <strong>$file</strong>     Le chemin ou un flux de ressource ouvert (qui sera automatiquement
                                  fermé après le retour de cette fonction) vers lequel le fichier
                                  sera sauvegardé. Si non-défini ou <info>null</info>, le flux brute de l'image
                                  sera affiché directement.
  <info>int</info>                   <strong>$quality</strong>  <strong>$quality</strong> est optionnel, et prend des valeurs dans l'intervalle 0
                                  (pire qualité, petit fichier) à 100 (meilleure qualité, gros
                                  fichier). Par défaut (<return>-1</return>), utilise la valeur de la qualité IJG par
                                  défaut (environ 75).

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
        
        Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagepng()</strong>
   * <strong>imagegif()</strong>
   * <strong>imagewbmp()</strong>
   * <strong>imageinterlace()</strong>
   * <strong>imagetypes()</strong>


id: imagelayereffect
type: function
doc:
<comment>Description:</comment>
  Active l'option d'alpha blending, pour utiliser les effets de libgd
  
  Active l'option d'alpha blending, pour utiliser les effets libgd.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>   Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                    <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$effect</strong>  Une des constantes suivantes : <info>IMG_EFFECT_REPLACE</info> Utilise le remplacement de
                    pixels (équivalent à passer <info>true</info> à la fonction <strong>imagealphablending()</strong>)
                    <info>IMG_EFFECT_ALPHABLEND</info> Utilise le blending normal de pixels (équivalent à passer
                    <info>false</info> à la fonction <strong>imagealphablending()</strong>) <info>IMG_EFFECT_NORMAL</info> Identique à la
                    constante <info>IMG_EFFECT_ALPHABLEND</info>. <info>IMG_EFFECT_OVERLAY</info> L'overlay a pour effet que
                    les pixels noirs du fond resteront noirs, les blancs du fond resteront blancs,
                    mais les gris du fond prendront la couleur du pixel de premier plan.
                    <info>IMG_EFFECT_MULTIPLY</info> L'overlays avec un effet de multiplication.
                    
                    Utilise le remplacement de pixels (équivalent à passer <info>true</info> à la fonction
                    <strong>imagealphablending()</strong>)
                    
                    Utilise le blending normal de pixels (équivalent à passer <info>false</info> à la fonction
                    <strong>imagealphablending()</strong>)
                    
                    Identique à la constante <info>IMG_EFFECT_ALPHABLEND</info>.
                    
                    L'overlay a pour effet que les pixels noirs du fond resteront noirs, les blancs
                    du fond resteront blancs, mais les gris du fond prendront la couleur du pixel de
                    premier plan.
                    
                    L'overlays avec un effet de multiplication.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imageline
type: function
doc:
<comment>Description:</comment>
  Dessine une ligne
  
  Dessine une ligne entre deux points fournis.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x1</strong>     X : coordonnée du premier point.
  <info>int</info>      <strong>$y1</strong>     Y : coordonnée du premier point.
  <info>int</info>      <strong>$x2</strong>     X : coordonnée du second point.
  <info>int</info>      <strong>$y2</strong>     Y : coordonnée du second point.
  <info>int</info>      <strong>$color</strong>  La couleur de remplissage. Un identificateur de couleur créé avec
                   <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>imagecolorallocate()</strong>


id: imageloadfont
type: function
doc:
<comment>Description:</comment>
  Charge une nouvelle police
  
  <strong>imageloadfont()</strong> charge une nouvelle police utilisateur et retourne son identifiant.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Le format des polices dépend actuellement du système d'exploitation. Ce qui
                     signifie qu'il vous faut générer des fichiers de polices pour la machine qui
                     fait tourner PHP.
                     
                     Format de fichier de policePositionType de données CDescriptionOctets
                     0-3intNombre de caractères de la policeOctets 4-7int Valeur du premier
                     caractère de la police (souvent 32 pour espace) Octets 8-11intLargeur en pixels
                     des caractèresOctets 12-15intHauteur en pixels des caractèresOctets 16-char
                     Tableau avec les données des caractères, un octet par pixel pour chaque
                     caractère, avec un total de (nombre de caractères * largeur * hauteur) octets.

<comment>Return:</comment>
  <info>GdFont|false</info>  Retourne une instance <class>GdFont</class>, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagefontwidth()</strong>
   * <strong>imagefontheight()</strong>


id: imageopenpolygon
type: function
doc:
<comment>Description:</comment>
  Dessine un polygone ouvert
  
  Signature à partir de PHP 8.0.0 (non supportée avec les arguments nommés)
  
  Signature alternative (obsolète à partir de PHP 8.1.0)
  
  <strong>imageopenpolygon()</strong> dessine un polygone ouvert sur l'<strong>$image</strong>. Contrairement à <strong>imagepolygon()</strong>, aucune
  ligne est dessiné entre le dernier et le premier point.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>       Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images,
                        comme <strong>imagecreatetruecolor()</strong>.
  <info>array</info>    <strong>$points</strong>      Un tableau contenant les sommets du polygone, par exemple : points[0]=
                        x0points[1]= y0points[2]= x1points[3]= y1
  <info>int</info>      <strong>$num_points</strong>  Nombre total de points (sommets), qui doivent être d'au moins 3.
                        
                        Si ce paramètre est omis conformément à la deuxième signature, <strong>$points</strong> doit
                        avoir un nombre pair d'éléments, et <strong>$num_points</strong> est assumé d'être
                        count($points)/2.
  <info>int</info>      <strong>$color</strong>       Un identificateur de couleur créé avec <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagepolygon()</strong>


id: imagepalettecopy
type: function
doc:
<comment>Description:</comment>
  Copie la palette d'une image à l'autre
  
  <strong>imagepalettecopy()</strong> copie la palette de l'image <strong>$src</strong> dans l'image <strong>$dst</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$dst</strong>  L'objet de l'image de destination.
  <info>GdImage</info>  <strong>$src</strong>  L'objet de l'image source.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.


id: imagepalettetotruecolor
type: function
doc:
<comment>Description:</comment>
  Convertit une image basée sur une palette en couleur vraie
  
  Convertit une image basée sur une palette, créée par une fonction comme <strong>imagecreate()</strong>, en une
  image en couleur vraie, comme <strong>imagecreatetruecolor()</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si la conversion a été un succès, ou si l'image source est déjà en couleur
        vraie, sinon, retourne <info>false</info>.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>imageistruecolor()</strong>


id: imagepng
type: function
doc:
<comment>Description:</comment>
  Envoie une image PNG vers un navigateur ou un fichier
  
  <strong>imagepng()</strong> affiche ou sauvegarde une  image au format PNG en utilisant  l'image <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>    Un objet <class>GdImage</class>, retournée par une des fonctions de création
                                  d'images, comme <strong>imagecreatetruecolor()</strong>.
  <info>resource|string|null</info>  <strong>$file</strong>     Le chemin ou un flux de ressource ouvert (qui sera automatiquement
                                  fermé après le retour de cette fonction) vers lequel le fichier
                                  sera sauvegardé. Si non-défini ou <info>null</info>, le flux brute de l'image
                                  sera affiché directement.
                                  
                                  La valeur <info>null</info> est invalide si le paramètre <strong>$quality</strong> et le
                                  paramètre <strong>$filters</strong> ne sont pas utilisés.
  <info>int</info>                   <strong>$quality</strong>  Degré de compression : depuis 0 (aucune compression) à 9. La
                                  valeur par défaut (<return>-1</return>) utilise la compression par défaut de zlib.
                                  Pour plus d'informations voir le manuel zlib.
  <info>int</info>                   <strong>$filters</strong>  Permet la réduction de la taille du fichier PNG. C'est un masque
                                  qui peut être défini par une combinaison des constantes
                                  <return>PNG_FILTER_XXX</return>. <info>PNG_NO_FILTER</info> ou <info>PNG_ALL_FILTERS</info> peuvent également
                                  être utilisé pour, respectivement, désactiver ou activer tous les
                                  filtres. La valeur par défaut (<return>-1</return>) désactive le filtrage.
                                  
                                  La paramètre <strong>$filters</strong> est ignoré par system libgd.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
        
        Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne <info>true</info>.

<comment>See Also:</comment>
   * <strong>imagegif()</strong>
   * <strong>imagewbmp()</strong>
   * <strong>imagejpeg()</strong>
   * <strong>imagetypes()</strong>
   * <strong>imagesavealpha()</strong>


id: imagepolygon
type: function
doc:
<comment>Description:</comment>
  Dessine un polygone
  
  Signature à partir de PHP 8.0.0 (non supportée avec les arguments nommés)
  
  Signature alternative (obsolète à partir de PHP 8.1.0)
  
  <strong>imagepolygon()</strong> dessine un polygone dans l'image <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>       Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images,
                        comme <strong>imagecreatetruecolor()</strong>.
  <info>array</info>    <strong>$points</strong>      Un tableau contenant les sommets du polygone, e.g. : points[0]= x0points[1]=
                        y0points[2]= x1points[3]= y1
  <info>int</info>      <strong>$num_points</strong>  Nombre total de points (sommets), qui doivent être d'au moins 3.
                        
                        Si ce paramètre est omis conformément à la deuxième signature, <strong>$points</strong> doit
                        avoir un nombre pair d'éléments, et <strong>$num_points</strong> est assumé d'être
                        count($points)/2.
  <info>int</info>      <strong>$color</strong>       Un identificateur de couleur créé avec <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagefilledpolygon()</strong>
   * <strong>imageopenpolygon()</strong>
   * <strong>imagecreate()</strong>
   * <strong>imagecreatetruecolor()</strong>


id: imagerectangle
type: function
doc:
<comment>Description:</comment>
  Dessine un rectangle
  
  <strong>imagerectangle()</strong> dessine un rectangle aux coordonnées spécifiées.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x1</strong>     X : coordonnée du coin en haut, à gauche.
  <info>int</info>      <strong>$y1</strong>     Y : coordonnée du coin en haut, à gauche. 0, 0 est le coin en haut à gauche de
                   l'image.
  <info>int</info>      <strong>$x2</strong>     X : coordonnée du point en bas, à droite.
  <info>int</info>      <strong>$y2</strong>     Y : coordonnée du point en bas, à droite.
  <info>int</info>      <strong>$color</strong>  Un identificateur de couleur créé avec <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imageresolution
type: function
doc:
<comment>Description:</comment>
  Récupère ou définit la résoltion de l'image
  
  <strong>imageresolution()</strong> permet de définir et récupérer la résolution d'une image en DPI (dots per
  inch/point par pouce). Si les paramètres optionnel sont <info>null</info>, la résolution actuelle est retournée
  dans un tableau indexé, Si uniquement <strong>$resolution_x</strong> n'est pas <info>null</info>, la résolution horizontale et
  verticale sont définit à cette valeur. Si aucun des paramètres optionnels sont <info>null</info>, la résolution
  horizontale et verticale sont définit à ces valeurs respectivement.
  
  La résolution est uniquement utilisé en tant que méta données quand les images sont lu et écrit à
  des formats supportant ce genre d'information (actuellement PNG et JPEG). Ceci n'affecte pas les
  opérations de dessin. La résolution par défaut des nouvelles images est 96 DPI.

<comment>Param:</comment>
  <info>GdImage</info>   <strong>$image</strong>         Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images,
                           comme <strong>imagecreatetruecolor()</strong>.
  <info>int|null</info>  <strong>$resolution_x</strong>  La résolution horizontale en DPI/PPP.
  <info>int|null</info>  <strong>$resolution_y</strong>  La résolution verticale en DPI/PPP.

<comment>Return:</comment>
  <info>array|bool</info>  Quand utilisé en tant que récupérateur, ceci retourne un tableau indexé avec les
              résolutions horizontale et verticale en cas de succès,  ou <info>false</info> si une erreur
              survient. Quand utilisé en tant que définisseur, ceci retourne <info>true</info> en cas de succès,
              ou <info>false</info> si une erreur survient.


id: imagerotate
type: function
doc:
<comment>Description:</comment>
  Fait tourner une image d'un angle
  
  <strong>imagerotate()</strong> fait tourner l'image <strong>$image</strong>  d'un angle de <strong>$angle</strong>, en degrés.
  
  Le centre de rotation est le centre de l'image, et l'image tournée peut avoir des dimensions
  différentes de l'image originale.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>             Un objet <class>GdImage</class>, retournée par une des fonctions de création
                              d'images, comme <strong>imagecreatetruecolor()</strong>.
  <info>float</info>    <strong>$angle</strong>             L'angle de rotation, en degrés. L'angle de rotation est interprété
                              comme étant le nombre de degrés à tourner l'image dans le sens inverse
                              des aiguilles d'une montre.
  <info>int</info>      <strong>$background_color</strong>  Spécifie la couleur des zones qui seront découvertes après la
                              rotation.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne un objet d'image correspondant à l'image après rotation,  ou <info>false</info> si une
                 erreur survient.

<comment>See Also:</comment>
   * <strong>imagesetinterpolation()</strong>


id: imagesavealpha
type: function
doc:
<comment>Description:</comment>
  Détermine si les informations complètes du canal alpha doivent être conservées lors de la
  sauvegardes d'images
  
  <strong>imagesavealpha()</strong> définit le drapeau qui détermine si les informations du canal alpha (en
  opposition à la transparence à couleur unique) doivent être conservées lors de la sauvegarde
  d'images. Cela est supporte seulement pour les formats d'images qui supportent la totalité des
  informations de chaines alpha, par exemple <return>PNG</return>, <return>WebP</return> et <return>AVIF</return>. <strong>imagesavealpha()</strong> est seulement
  significatif pour les images <return>PNG</return>, comme les chaînes alpha pleines sont toujours sauvegardées pour
  <return>WebP</return> et <return>AVIF</return>. Il n'est pas recommendé de se reposer sur ce comportement, cela pourrait changer
  dans le futur. Donc, <strong>imagesavealpha()</strong> devrait être appelé intentionellement aussi pour les images
  <return>WebP</return> et <return>AVIF</return>.
  
  <strong>imagesavealpha()</strong> est seulement significatif pour les images <return>PNG</return>, comme les chaînes alpha pleines
  sont toujours sauvegardées pour <return>WebP</return> et <return>AVIF</return>. Il n'est pas recommendé de se reposer sur ce
  comportement, cela pourrait changer dans le futur. Donc, <strong>imagesavealpha()</strong> devrait être appelé
  intentionellement aussi pour les images <return>WebP</return> et <return>AVIF</return>.
  
  Le alphablending doit être désactivé (imagealphablending($im, false)) pour conserver le canal
  alpha en premier lieu.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>   Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                    <strong>imagecreatetruecolor()</strong>.
  <info>bool</info>     <strong>$enable</strong>  Si l'on doit ou non sauvegarder le canal alpha. Par défaut <info>false</info>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagealphablending()</strong>


id: imagescale
type: function
doc:
<comment>Description:</comment>
  Met à l'échelle une image en utilisant une hauteur et une largeur fournies
  
  <strong>imagescale()</strong> met à l'échelle une image en utilisant  l'algorithme d'interpolation donné.
  
  Contrairement à beaucoup d'autres fonctions d'image, <strong>imagescale()</strong> ne modifie pas l'<strong>$image</strong> fournit
  ; à la place, une nouvelle image est retournée.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>   Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                    <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$width</strong>   La largeur à utiliser pour la mise à l'échelle de l'image.
  <info>int</info>      <strong>$height</strong>  La hauteur à utiliser pour la mise à l'échelle de l'image. Si omis ou  négative,
                    le ratio de l'image sera préservé.
  <info>int</info>      <strong>$mode</strong>    Une des constantes <info>IMG_NEAREST_NEIGHBOUR</info>, <info>IMG_BILINEAR_FIXED</info>, <info>IMG_BICUBIC</info>,
                    <info>IMG_BICUBIC_FIXED</info> ou toute autre (utilisera deux passages). <info>IMG_WEIGHTED4</info> n'est
                    pas encore pris en charge.
                    
                    <info>IMG_WEIGHTED4</info> n'est pas encore pris en charge.

<comment>Return:</comment>
  <info>GdImage|false</info>  Retourne l'objet de l'image mise à l'échelle en cas de succès ou <info>false</info> si une
                 erreur survient.

<comment>See Also:</comment>
   * <strong>imagecopyresized()</strong>
   * <strong>imagecopyresampled()</strong>


id: imagesetbrush
type: function
doc:
<comment>Description:</comment>
  Modifie la brosse pour le dessin des lignes
  
  <strong>imagesetbrush()</strong> remplace la brosse courante pour le dessin des lignes par <strong>$brush</strong>. Cette brosse
  sera alors utilisée avec des fonctions comme <strong>imageline()</strong> ou <strong>imagepolygon()</strong> et avec les couleurs
  spéciales <info>IMG_COLOR_BRUSHED</info> ou <info>IMG_COLOR_STYLEDBRUSHED</info>.
  
  Vous n'avez rien à faire lorsque vous en avez terminé avec une brosse, mais si vous détruisez
  l'image de brosse, vous ne DEVEZ plus utiliser les options <info>IMG_COLOR_BRUSHED</info> et
  <info>IMG_COLOR_STYLEDBRUSHED</info> avant d'avoir créé une nouvelle brosse.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>GdImage</info>  <strong>$brush</strong>  Un objet d'image.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imagesetclip
type: function
doc:
<comment>Description:</comment>
  Définit le rectangle de coupure
  
  <strong>imagesetclip()</strong> définit le rectangle de coupure actuel, c'est à dire la zone au-delà de laquelle
  aucun pixel ne sera dessiné.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x1</strong>     La coordonée x du coin supérieur gauche.
  <info>int</info>      <strong>$y1</strong>     La coordonée y du coin supérieur gauche.
  <info>int</info>      <strong>$x2</strong>     La coordonée x du coin inférieur droite.
  <info>int</info>      <strong>$y2</strong>     La coordonée y du coin inférieur droite.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagegetclip()</strong>


id: imagesetinterpolation
type: function
doc:
<comment>Description:</comment>
  Défini la méthode d'interpolation
  
  Défini la méthode d'interpolation ; le fait de définir une méthode d'interpolation affecte le
  rendu de plusieurs fonctions en GD, comme par exemple la fonction <strong>imagerotate()</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>   Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                    <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$method</strong>  La méthode d'interpolation, qui peut être une parmi : <info>IMG_BELL</info> : filtre Bell.
                    <info>IMG_BESSEL</info> : filtre Bessel. <info>IMG_BICUBIC</info> : interpolation bicubique.
                    <info>IMG_BICUBIC_FIXED</info> : implémentation de point fixe d'une interpolation bicubique.
                    <info>IMG_BILINEAR_FIXED</info> : implémentation de point fixe d'une interpolation bilinéaire
                    (<return>par défaut (y compris pour la création d'image)</return>). <info>IMG_BLACKMAN</info> : fonction de
                    fenêtre Blackman. <info>IMG_BOX</info> : filtre de flou Box. <info>IMG_BSPLINE</info> : interpolation
                    Spline. <info>IMG_CATMULLROM</info> : interpolation cubique Hermite spline. <info>IMG_GAUSSIAN</info> :
                    fonction Gaussien. <info>IMG_GENERALIZED_CUBIC</info> : interpolation fractale cubique
                    généralisée spline. <info>IMG_HERMITE</info> : interpolation Hermite. <info>IMG_HAMMING</info> : filtre
                    Hamming. <info>IMG_HANNING</info> : filtre Hanning. <info>IMG_MITCHELL</info> : filtre Mitchell. <info>IMG_POWER</info>
                    : interpolation Power. <info>IMG_QUADRATIC</info> : interpolation quadratique inverse.
                    <info>IMG_SINC</info> : fonction Sinc. <info>IMG_NEAREST_NEIGHBOUR</info> : interpolation du voisin le
                    plus proche. <info>IMG_WEIGHTED4</info> : filtre Weighting. <info>IMG_TRIANGLE</info> : interpolation
                    Triangle.
                    
                    <info>IMG_BELL</info> : filtre Bell.
                    
                    <info>IMG_BESSEL</info> : filtre Bessel.
                    
                    <info>IMG_BICUBIC</info> : interpolation bicubique.
                    
                    <info>IMG_BICUBIC_FIXED</info> : implémentation de point fixe d'une interpolation bicubique.
                    
                    <info>IMG_BILINEAR_FIXED</info> : implémentation de point fixe d'une interpolation bilinéaire
                    (<return>par défaut (y compris pour la création d'image)</return>).
                    
                    <info>IMG_BLACKMAN</info> : fonction de fenêtre Blackman.
                    
                    <info>IMG_BOX</info> : filtre de flou Box.
                    
                    <info>IMG_BSPLINE</info> : interpolation Spline.
                    
                    <info>IMG_CATMULLROM</info> : interpolation cubique Hermite spline.
                    
                    <info>IMG_GAUSSIAN</info> : fonction Gaussien.
                    
                    <info>IMG_GENERALIZED_CUBIC</info> : interpolation fractale cubique généralisée spline.
                    
                    <info>IMG_HERMITE</info> : interpolation Hermite.
                    
                    <info>IMG_HAMMING</info> : filtre Hamming.
                    
                    <info>IMG_HANNING</info> : filtre Hanning.
                    
                    <info>IMG_MITCHELL</info> : filtre Mitchell.
                    
                    <info>IMG_POWER</info> : interpolation Power.
                    
                    <info>IMG_QUADRATIC</info> : interpolation quadratique inverse.
                    
                    <info>IMG_SINC</info> : fonction Sinc.
                    
                    <info>IMG_NEAREST_NEIGHBOUR</info> : interpolation du voisin le plus proche.
                    
                    <info>IMG_WEIGHTED4</info> : filtre Weighting.
                    
                    <info>IMG_TRIANGLE</info> : interpolation Triangle.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagegetinterpolation()</strong>


id: imagesetpixel
type: function
doc:
<comment>Description:</comment>
  Dessine un pixel
  
  <strong>imagesetpixel()</strong> dessine un pixel aux coordonnées spécifiées.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$x</strong>      X : coordonnée.
  <info>int</info>      <strong>$y</strong>      Y : coordonnée.
  <info>int</info>      <strong>$color</strong>  Un identificateur de couleur créé avec <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>imagecolorallocate()</strong>
   * <strong>imagecolorat()</strong>


id: imagesetstyle
type: function
doc:
<comment>Description:</comment>
  Configure le style pour le dessin des lignes
  
  <strong>imagesetstyle()</strong> permet de choisir le style à utiliser lors du dessin des lignes (comme avec les
  fonctions <strong>imageline()</strong> et <strong>imagepolygon()</strong>) lors de l'utilisation de la  couleur spéciale
  <info>IMG_COLOR_STYLED</info> ou bien lors du  dessin de lignes avec la couleur <info>IMG_COLOR_STYLEDBRUSHED</info>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>array</info>    <strong>$style</strong>  Un tableau de couleurs de pixels. Vous pouvez utiliser la constante
                   <info>IMG_COLOR_TRANSPARENT</info> pour ajouter un pixel transparent. Notez que <strong>$style</strong> ne doit
                   pas être un tableau <info>array</info> vide.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagesetbrush()</strong>
   * <strong>imageline()</strong>


id: imagesetthickness
type: function
doc:
<comment>Description:</comment>
  Modifie l'épaisseur d'un trait
  
  <strong>imagesetthickness()</strong> modifie l'épaisseur du trait des lignes de l'image <strong>$image</strong>. Cette épaisseur
  intervient dans les dessins de polygones, cercles, rectangles, etc. <strong>$thickness</strong> est en pixels.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>      Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                       <strong>imagecreatetruecolor()</strong>.
  <info>int</info>      <strong>$thickness</strong>  L'épaisseur, en pixels.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imagesettile
type: function
doc:
<comment>Description:</comment>
  Modifie l'image utilisée pour le carrelage
  
  <strong>imagesettile()</strong> remplace l'image de pavement courante par l'image <strong>$tile</strong>, à utiliser dans tous les
  remplissages (comme avec les fonctions <strong>imagefill()</strong> et <strong>imagefilledpolygon()</strong>) lors des remplissages
  avec l'option <info>IMG_COLOR_TILED</info>.
  
  Une image de carrelage est une image utilisée pour remplir une zone, de manière répétitive.
  N'importe quelle image GD peut servir d'image de remplissage. L'utilisation de la couleur
  transparente (gérée avec la fonction <strong>imagecolortransparent()</strong>) permet à certaines zones
  d'apparaître à travers le carrelage.
  
  Vous n'avez rien à faire lorsque vous en avez terminé avec une brosse, mais si vous détruisez
  l'image de brosse (ou laissez PHP le détruire), vous ne DEVEZ plus utiliser l'option
  <info>IMG_COLOR_TILED</info> des fonctions <strong>imagefill()</strong> et <strong>imagefilledpolygon()</strong>, avant d'avoir créé une nouvelle
  brosse.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.
  <info>GdImage</info>  <strong>$tile</strong>   L'objet' de l'image à utiliser en tant que carrelage.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imagestring
type: function
doc:
<comment>Description:</comment>
  Dessine une chaîne horizontale
  
  Dessine une chaîne aux coordonnées spécifiées.

<comment>Param:</comment>
  <info>GdImage</info>     <strong>$image</strong>   Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                       <strong>imagecreatetruecolor()</strong>.
  <info>GdFont|int</info>  <strong>$font</strong>    Peut être 1, 2, 3, 4, 5 pour les polices internes d'encodage Latin2 (où les
                       plus grands nombres correspondent aux polices larges) ou une instance de
                       <class>GdFont</class> retourné par <strong>imageloadfont()</strong>.
  <info>int</info>         <strong>$x</strong>       X : coordonnée du coin en haut, à gauche.
  <info>int</info>         <strong>$y</strong>       Y : coordonnée du coin en haut, à gauche.
  <info>string</info>      <strong>$string</strong>  La chaîne de caractères à écrire.
  <info>int</info>         <strong>$color</strong>   Un identificateur de couleur créé avec <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagestringup()</strong>
   * <strong>imageloadfont()</strong>
   * <strong>imagettftext()</strong>


id: imagestringup
type: function
doc:
<comment>Description:</comment>
  Dessine une chaîne verticale
  
  Dessine une chaîne sur une ligne verticale dans l'image <strong>$image</strong> aux coordonnées spécifiées.

<comment>Param:</comment>
  <info>GdImage</info>     <strong>$image</strong>   Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                       <strong>imagecreatetruecolor()</strong>.
  <info>GdFont|int</info>  <strong>$font</strong>    Peut être 1, 2, 3, 4, 5 pour les polices internes d'encodage Latin2 (où les
                       plus grands nombres correspondent aux polices larges) ou une instance de
                       <class>GdFont</class> retourné par <strong>imageloadfont()</strong>.
  <info>int</info>         <strong>$x</strong>       Coordonnée X du coin en haut, à gauche.
  <info>int</info>         <strong>$y</strong>       Coordonnée Y du coin en haut, à gauche.
  <info>string</info>      <strong>$string</strong>  La chaîne de caractères à écrire.
  <info>int</info>         <strong>$color</strong>   Un identificateur de couleur créé avec <strong>imagecolorallocate()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagestring()</strong>
   * <strong>imageloadfont()</strong>


id: imagesx
type: function
doc:
<comment>Description:</comment>
  Retourne la largeur d'une image
  
  Retourne la largeur de l'objet image <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>int</info>  Retourne la largeur de l'image <strong>$image</strong>.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>getimagesize()</strong>
   * <strong>imagesy()</strong>


id: imagesy
type: function
doc:
<comment>Description:</comment>
  Retourne la hauteur de l'image
  
  Retourne la hauteur de l'image <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>  Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                   <strong>imagecreatetruecolor()</strong>.

<comment>Return:</comment>
  <info>int</info>  Retourne la hauteur de l'image <strong>$image</strong>.

<comment>See Also:</comment>
   * <strong>imagecreatetruecolor()</strong>
   * <strong>getimagesize()</strong>
   * <strong>imagesx()</strong>


id: imagetruecolortopalette
type: function
doc:
<comment>Description:</comment>
  Convertit une image en couleurs vraies en image à palette
  
  <strong>imagetruecolortopalette()</strong> convertit l'image en vraies couleurs <strong>$image</strong> en image à palette. Le code
  de cette fonction est directement tiré de la bibliothèque du <return>Independent JPEG Group</return>, qui est tout
  simplement génial. Le code a été modifié pour préserver l'essentiel du canal alpha dans la
  nouvelle palette, en plus de conserver les couleurs du mieux possible. Mais cela ne fonctionne pas
  toujours comme voulu. Il est alors préférable de générer un résultat en vraies couleurs, ce qui
  donne toujours le meilleur rendu.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>       Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images,
                        comme <strong>imagecreatetruecolor()</strong>.
  <info>bool</info>     <strong>$dither</strong>      Indique si l'image doit être granuleuse - si défini à <info>true</info>, alors l'image
                        sera un peu plus granuleuse mais l'approximation des couleurs sera
                        meilleure.
  <info>int</info>      <strong>$num_colors</strong>  Le nombre maximal de couleurs dans la palette finale.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imagettfbbox
type: function
doc:
<comment>Description:</comment>
  Retourne le rectangle entourant un texte et dessiné avec une police TrueType
  
  Calcule et retourne le rectangle entourant le texte <strong>$text</strong>, écrit avec une police truetype.
  
  Antérieur à PHP 8.0.0, <strong>imageftbbox()</strong> était une variante étendue de <strong>imagettfbbox()</strong> qui en plus
  supporte <strong>$extrainfo</strong>. À partir de PHP 8.0.0, <strong>imagettfbbox()</strong> est un alias de <strong>imageftbbox()</strong>.

<comment>Param:</comment>
  <info>float</info>   <strong>$size</strong>      La taille de la police de caractères en point.
  <info>float</info>   <strong>$angle</strong>     L'angle, en degrés, dans lequel le paramètre <strong>$string</strong> sera mesuré.
  <info></info>        <strong>$fontfile</strong>  Le chemin d'accès à la police TrueType que vous souhaitez utiliser.
                     
                     Selon la version de la bibliothèque GD que PHP utilise, quand <strong>$fontfile</strong> ne
                     commence pas par une premier <return>/</return> alors <return>.ttf</return> sera ajouté au nom de fichier et la
                     bibliothèque essaiera de rechercher ce nom de fichier le long d'un chemin de
                     police défini par la bibliothèque.
                     
                     Lorsque vous utilisez des versions de la bibliothèque GD inférieure à 2.0.18,
                     un caractère <return>espace</return>, plutôt qu'un point-virgule, a été utilisé comme séparateur
                     de chemin d'accès pour différents fichiers de police. L'utilisation
                     involontaire de cette fonctionnalité se traduira par le message
                     d'avertissement: <return> Avertissement: impossible de trouver/ouvrir la police</return>. Pour
                     ces versions affectées, la seule solution consiste à déplacer la police vers un
                     chemin qui ne contient pas d'espaces.
                     
                     Dans de nombreux cas où une police réside dans le même répertoire que le script
                     en l'utilisant l'astuce suivante permettra d'atténuer les problèmes
                     d'inclusion.  à <strong>$fontfile</strong>.
  <info>string</info>  <strong>$string</strong>    La chaîne à mesurer.

<comment>Return:</comment>
  <info>array|false</info>  <strong>imagettfbbox()</strong> retourne un tableau avec 8 éléments représentant les 4 sommets du
               rectangle en cas de succès, <info>false</info> si une erreur survient. CléSignification0Coin
               inférieur gauche, abscisse1Coin inférieur gauche, ordonnée2Coin inférieur droit,
               abscisse3Coin inférieur droit, ordonnée4Coin supérieur droit, abscisse5Coin supérieur
               droit, ordonnée6Coin supérieur gauche, abscisse7Coin supérieur gauche, ordonnée
               
               Les positions des points sont relatives au texte text, indépendamment de l'angle :
               coin supérieur gauche faire référence au coin supérieur gauche du texte écrit
               horizontalement.

<comment>See Also:</comment>
   * <strong>imagettftext()</strong>
   * <strong>imageftbbox()</strong>


id: imagettftext
type: function
doc:
<comment>Description:</comment>
  Dessine un texte avec une police TrueType
  
  <strong>imagettftext()</strong> dessine le texte <strong>$text</strong> avec la police TrueType <strong>$fontfile</strong>.
  
  Antérieur à PHP 8.0.0, <strong>imagefttext()</strong> était une variante étendue de <strong>imagettftext()</strong> qui en plus
  supporte <strong>$extrainfo</strong>. À partir de PHP 8.0.0, <strong>imagefttext()</strong> est un alias de <strong>imagefttext()</strong>.

<comment>Param:</comment>
  <info>GdImage</info>  <strong>$image</strong>     Un objet <class>GdImage</class>, retournée par une des fonctions de création d'images, comme
                      <strong>imagecreatetruecolor()</strong>.
  <info>float</info>    <strong>$size</strong>      La taille de la police de caractères en point.
  <info>float</info>    <strong>$angle</strong>     L'angle, en degrés ; 0 degré correspond à la lecture du texte de gauche à
                      droite. Les valeurs positives représentent une rotation dans le sens contraire
                      des aiguilles d'une montre. Par exemple, une valeur de 90 correspondra à une
                      lecture du texte de bas en haut.
  <info>int</info>      <strong>$x</strong>         Les coordonnées données par <strong>$x</strong> et <strong>$y</strong> définiront la position du premier
                      caractère (le coin bas-gauche du caractère). Cela est différent de la fonction
                      <strong>imagestring()</strong>, où <strong>$x</strong> et <strong>$y</strong> définissent le coin haut-gauche du premier
                      caractère. Par exemple, "haut gauche" correspond à 0, 0.
  <info>int</info>      <strong>$y</strong>         L'ordonnée Y. Cela définit la position de la ligne de base de la police, et
                      non pas le bas des caractères.
  <info>int</info>      <strong>$color</strong>     L'index de la couleur. Utiliser un index de couleur négatif désactivera
                      l'antialiasing. Voir la fonction <strong>imagecolorallocate()</strong>.
  <info></info>         <strong>$fontfile</strong>  Le chemin d'accès à la police TrueType que vous souhaitez utiliser.
                      
                      Selon la version de la bibliothèque GD que PHP utilise, quand <strong>$fontfile</strong> ne
                      commence pas par une premier <return>/</return> alors <return>.ttf</return> sera ajouté au nom de fichier et la
                      bibliothèque essaiera de rechercher ce nom de fichier le long d'un chemin de
                      police défini par la bibliothèque.
                      
                      Lorsque vous utilisez des versions de la bibliothèque GD inférieure à 2.0.18,
                      un caractère <return>espace</return>, plutôt qu'un point-virgule, a été utilisé comme
                      séparateur de chemin d'accès pour différents fichiers de police. L'utilisation
                      involontaire de cette fonctionnalité se traduira par le message
                      d'avertissement: <return> Avertissement: impossible de trouver/ouvrir la police</return>. Pour
                      ces versions affectées, la seule solution consiste à déplacer la police vers
                      un chemin qui ne contient pas d'espaces.
                      
                      Dans de nombreux cas où une police réside dans le même répertoire que le
                      script en l'utilisant l'astuce suivante permettra d'atténuer les problèmes
                      d'inclusion.  à <strong>$fontfile</strong>.
  <info>string</info>   <strong>$text</strong>      La chaîne de texte, en UTF-8.
                      
                      Peut inclure des références à des caractères numériques, décimales (sous la
                      forme : &#8364; ) pour accéder aux caractères d'une police au delà du premier
                      127. Les chaînes de caractères encodées en UTF-8 peuvent être passées
                      directement.
                      
                      Les entités nommées, comme &copy;, ne sont pas supportées. Utilisez la
                      fonction <strong>html_entity_decode()</strong> pour encoder ces entités nommées en chaîne
                      UTF-8.
                      
                      Si un caractère est utilisé dans une chaîne qui n'est pas supportée par la
                      police, un rectangle creux remplacera le caractère.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau de 8 éléments représentant quatre points marquants les limites du
               texte. L'ordre des points est : inférieur gauche, inférieur droit, supérieur droit,
               supérieur gauche. Les points sont relatifs au texte par rapport à l'angle, donc,
               "supérieur gauche" signifie dans le coin en haut à gauche lorsque vous regardez le
               texte horizontalement. Retourne <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imagettfbbox()</strong>
   * <strong>imagefttext()</strong>


id: imagetypes
type: function
doc:
<comment>Description:</comment>
  Retourne les types d'images supportés par la version courante de PHP
  
  Retourne un champ d'octets correspondant aux formats d'images supportés par la version PHP
  utilisée.

<comment>Return:</comment>
  <info>int</info>  Retourne un champ d'octets correspondant aux formats d'images supportés par la version de GD
       utilisée. Les valeurs suivantes sont possibles : <info>IMG_AVIF</info> | <info>IMG_BMP</info> | <info>IMG_GIF</info> | <info>IMG_JPG</info> |
       <info>IMG_PNG</info> | <info>IMG_WBMP</info> |  <info>IMG_XPM</info> | <info>IMG_WEBP</info>.

<comment>See Also:</comment>
   * <strong>gd_info()</strong>


id: imagewbmp
type: function
doc:
<comment>Description:</comment>
  Affichage de l'image vers le navigateur ou dans un fichier
  
  <strong>imagewbmp()</strong> affiche ou sauvegarde une version WBMP de l'image <strong>$image</strong>.

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>             Un objet <class>GdImage</class>, retournée par une des fonctions de
                                           création d'images, comme <strong>imagecreatetruecolor()</strong>.
  <info>resource|string|null</info>  <strong>$file</strong>              Le chemin ou un flux de ressource ouvert (qui sera
                                           automatiquement fermé après le retour de cette fonction)
                                           vers lequel le fichier sera sauvegardé. Si non-défini ou
                                           <info>null</info>, le flux brute de l'image sera affiché directement.
  <info>int|null</info>              <strong>$foreground_color</strong>  Vous pouvez choisir la couleur de fond avec ce paramètre.
                                           Utilisez l'identifiant retourné par <strong>imagecolorallocate()</strong>
                                           comme valeur de ce paramètre. La couleur de fond par
                                           défaut est noire.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
        
        Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne <info>true</info>.

<comment>See Also:</comment>
   * <strong>image2wbmp()</strong>
   * <strong>imagepng()</strong>
   * <strong>imagegif()</strong>
   * <strong>imagejpeg()</strong>
   * <strong>imagetypes()</strong>


id: imagewebp
type: function
doc:
<comment>Description:</comment>
  Affiche une image WebP vers un navigateur ou un fichier
  
  Affiche ou sauvegarde une version WebP de l'<strong>$image</strong> fournie.

<comment>Param:</comment>
  <info>GdImage</info>               <strong>$image</strong>    Un objet <class>GdImage</class>, retournée par une des fonctions de création
                                  d'images, comme <strong>imagecreatetruecolor()</strong>.
  <info>resource|string|null</info>  <strong>$file</strong>     Le chemin ou un flux de ressource ouvert (qui sera automatiquement
                                  fermé après le retour de cette fonction) vers lequel le fichier
                                  sera sauvegardé. Si non-défini ou <info>null</info>, le flux brute de l'image
                                  sera affiché directement.
  <info>int</info>                   <strong>$quality</strong>  <strong>$quality</strong> plage de 0 (la pire qualité, plus petit  fichier) à 100
                                  (meilleure qualité, plus grand fichier).

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
        
        Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne <info>true</info>.


id: imagexbm
type: function
doc:
<comment>Description:</comment>
  Génère une image au format XBM
  
  Affiche ou sauvegarde une version XBM de l'image <strong>$image</strong>.
  
  <strong>imagexbm()</strong> n'applique pas de rembourrage, de sorte que  la largeur de l'image doit être un
  multiple de 8. Cette restriction ne  s'applique plus à partir de PHP 7.0.9, respectivement.

<comment>Param:</comment>
  <info>GdImage</info>      <strong>$image</strong>             Un objet <class>GdImage</class>, retournée par une des fonctions de création
                                  d'images, comme <strong>imagecreatetruecolor()</strong>.
  <info>string|null</info>  <strong>$filename</strong>          Chemin d'accès où le fichier sera enregistré, sous la forme d'une
                                  chaîne de caractères. S'il n'est pas défini, le flux d'images RAW
                                  sera directement affiché sur la sortie standart.
                                  
                                  Le nom de fichier <strong>$filename</strong> (sans l'extension .xbm)  est également
                                  utilisé pour les identificateur C duXBM,  auquel cas les
                                  caractères non alphanumériques des paramètres régionaux  actuels
                                  sont remplacés par des soulignements. Si  <strong>$filename</strong> a la valeur
                                  null,  <return>image</return> est utilisée pour générer les identificateurs C.
  <info>int|null</info>     <strong>$foreground_color</strong>  Vous pouvez définir le premier plan avec ce paramètre en
                                  définissant un identifiant obtenu depuis la fonction
                                  <strong>imagecolorallocate()</strong>. Par défaut, la couleur du premier plan est
                                  noir. Toutes les autres  couleurs sont traitées comme
                                  arrière-plan.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
        
        Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne <info>true</info>.


id: imagick::ALPHACHANNEL_ACTIVATE
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.3.8 ou
  supérieur.


id: imagick::ALPHACHANNEL_ASSOCIATE
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.9.0 ou
  supérieur.


id: imagick::ALPHACHANNEL_BACKGROUND
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.5.3 ou
  supérieur.


id: imagick::ALPHACHANNEL_COPY
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.4.6 ou
  supérieur.


id: imagick::ALPHACHANNEL_DISCRETE
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 7.0.0 ou
  supérieur.


id: imagick::ALPHACHANNEL_REMOVE
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.7.8 ou
  supérieur.


id: imagick::COLORSPACE_CMY
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.4.2 ou
  supérieur.


id: imagick::COMPOSITE_ATOP
type: constant
doc:
<comment>Description:</comment>
  Le résultat a la même forme que l'image, avec l'image composée qui remplit l'image là où la forme
  d'image chevauche l'image


id: imagick::COMPOSITE_BUMPMAP
type: constant
doc:
<comment>Description:</comment>
  La même chose que COMPOSITE_MULTIPLY, hormis le fait que la source est  d'abord convertie en
  niveaux de gris


id: imagick::COMPOSITE_DSTATOP
type: constant
doc:
<comment>Description:</comment>
  La partie de l'image de destination qui est a l'intérieur de la  source est composée avec la
  source, et placée dans la destination.


id: imagick::COMPOSITE_EXCLUSION
type: constant
doc:
<comment>Description:</comment>
  Produit un effet similaire à imagick::COMPOSITE_DIFFERENCE, mais avec un contraste plus faible


id: imagick::COMPOSITE_HARDLIGHT
type: constant
doc:
<comment>Description:</comment>
  Multiplie ou screene les couleurs, dépendemment de la valeur de la couleur source


id: imagick::COMPOSITE_MODULATE
type: constant
doc:
<comment>Description:</comment>
  Module la clarté de la cible, sa saturation et sa hue tel que défini par la cible


id: imagick::COMPOSITE_SCREEN
type: constant
doc:
<comment>Description:</comment>
  La source et cible sont complétées puis multipliées et finalement elles remplacent la cible


id: imagick::COMPOSITE_SRCATOP
type: constant
doc:
<comment>Description:</comment>
  La partie de la source qui est dans la cible et composée sur la cible


id: imagick::COMPOSITE_SRCIN
type: constant
doc:
<comment>Description:</comment>
  La partie de la source qui est dans la destination, remplace la destination.


id: imagick::COMPOSITE_SRCOUT
type: constant
doc:
<comment>Description:</comment>
  La partie de la source qui est hors de la destination remplace la destination


id: imagick::COMPOSITE_THRESHOLD
type: constant
doc:
<comment>Description:</comment>
  La source est composée sur la cible, tel que défini par les seuils de la source


id: imagick::COMPOSITE_XOR
type: constant
doc:
<comment>Description:</comment>
  La partie de la source qui est hors de la destination et combinée avec  la partie de la
  destination qui est hors de la source


id: imagick::COMPRESSION_DXT1
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.4.0 ou
  supérieur.


id: imagick::DISTORTION_AFFINE
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.3.6 ou
  supérieur.


id: imagick::EVALUATE_ADDMODULUS
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.4.4 ou
  supérieur.


id: imagick::FUNCTION_POLYNOMIAL
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.4.9 ou
  supérieur.


id: imagick::INTERLACE_GIF
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.3.4 ou
  supérieur.


id: imagick::INTERPOLATE_AVERAGE
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.3.2 ou
  supérieur.


id: imagick::LAYERMETHOD_COALESCE
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.2.9 ou
  supérieur.


id: imagick::LAYERMETHOD_COMPOSITE
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.3.0 ou
  supérieur.


id: imagick::LAYERMETHOD_FLATTEN
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.3.7 ou
  supérieur.


id: imagick::RESOURCETYPE_AREA
type: constant
doc:
<comment>Description:</comment>
  Défini la largeur et la hauteur maximales d'une image qui peut être mise dans la mémoire cache des
  pixels.


id: imagick::RESOURCETYPE_DISK
type: constant
doc:
<comment>Description:</comment>
  Défini la taille maximale de l'espace disque autorisée à stocker le cache des pixels.


id: imagick::RESOURCETYPE_MAP
type: constant
doc:
<comment>Description:</comment>
  Défini la taille maximale de mémoire en octets, à allouer au cache de pixels.


id: imagick::RESOURCETYPE_MEMORY
type: constant
doc:
<comment>Description:</comment>
  Défini la taille maximale de la mémoire, en octets, à allouer au cache de pixels.


id: imagick::RESOURCETYPE_THREAD
type: constant
doc:
<comment>Description:</comment>
  Défini le nombre maximal de threads parrallèles. Cette constante n'est disponible que si Imagick a
  été compilé avec ImageMagick version 6.7.8 ou supérieur.


id: imagick::VIRTUALPIXELMETHOD_HORIZONTALTILE
type: constant
doc:
<comment>Description:</comment>
  Cette constante n'est disponible que si Imagick a été compilé avec ImageMagick version 6.4.3 ou
  supérieur.


id: imap_8bit
type: function
doc:
<comment>Description:</comment>
  Convertit une chaîne à 8 bits en une chaîne encodée en Quoted-Printable
  
  Convertit la chaîne à 8 bits en une chaîne encodée en Quoted-Printable (selon la RFC 2045, Section
  6.7).

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  La chaîne 8 bits à convertir

<comment>Return:</comment>
  <info>string|false</info>  Retourne une chaîne encodée en Quoted-Printable,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_qprint()</strong>


id: imap_alerts
type: function
doc:
<comment>Description:</comment>
  Retourne toutes les alertes
  
  Retourne un tableau de tous les messages d'alerte IMAP générés depuis le dernier appel à
  <strong>imap_alerts()</strong> ou depuis le début de la page.
  
  Lorsque <strong>imap_alerts()</strong> est appelée, la pile d'alertes est vidée. Les spécifications IMAP requièrent
  que ces messages soient passés à l'utilisateur.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau contenant tous les messages d'alerte IMAP générés ou <info>false</info> si
               aucun message d'alerte n'est disponible.

<comment>See Also:</comment>
   * <strong>imap_errors()</strong>


id: imap_append
type: function
doc:
<comment>Description:</comment>
  Ajoute un message dans une boîte aux lettres
  
  Ajoute un <strong>$message</strong> au <strong>$folder</strong> spécifié.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>           Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$folder</strong>         Le nom de la boîte aux lettres, voir la documentation sur la
                                   fonction <strong>imap_open()</strong> pour plus d'informations
                                   
                                   Passer des données qui ne sont pas digne de confiance à ce
                                   paramètre est dangereux, sauf si, imap.enable_insecure_rsh est
                                   désactivé.
  <info>string</info>           <strong>$message</strong>        Le message à ajouter, sous la forme d'une chaîne de caractères
                                   
                                   Lors des échanges avec le serveur Cyrus IMAP, vous devrez
                                   utiliser "\r\n" comme terminaison de ligne, à la place de "\n" ou
                                   l'opération échouera.
  <info>string|null</info>      <strong>$options</strong>        Si fourni, le paramètre <strong>$options</strong> sera également écrit dans la
                                   boîte <strong>$folder</strong>
  <info>string|null</info>      <strong>$internal_date</strong>  Si ce paramètre est défini, il mettra les INTERNALDATE sur le
                                   message joint. Le paramètre doit être une chaîne de date qui est
                                   conforme aux spécifications du rfc2060 pour une valeur date_time.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: imap_base64
type: function
doc:
<comment>Description:</comment>
  Décode un texte encodé en BASE64
  
  Décode le texte <strong>$string</strong> encodé en BASE64.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Le texte encodé.

<comment>Return:</comment>
  <info>string|false</info>  Retourne le texte décodé, sous la forme d'une chaîne de caractères,  ou <info>false</info> si une
                erreur survient.

<comment>See Also:</comment>
   * <strong>imap_binary()</strong>
   * <strong>base64_encode()</strong>
   * <strong>base64_decode()</strong>
   * RFC2045, Section 6.8


id: imap_binary
type: function
doc:
<comment>Description:</comment>
  Convertit une chaîne à 8 bits en une chaîne à base64
  
  Convertit la chaîne à 8 bits <strong>$string</strong> en une chaîne à base64 (selon la RFC2045, Section 6.8).

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  La chaîne 8 bits

<comment>Return:</comment>
  <info>string|false</info>  Retourne la chaîne encodée en base64,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_base64()</strong>


id: imap_body
type: function
doc:
<comment>Description:</comment>
  Lit le corps d'un message
  
  <strong>imap_body()</strong> retourne le corps du message numéro <strong>$message_num</strong> de la boîte aux lettres courante.
  
  <strong>imap_body()</strong> va retourner une copie brute du corps du message. Pour extraire les sous-parties MIME
  du message, utilisez <strong>imap_fetchstructure()</strong> pour analyser la structure, et <strong>imap_fetchbody()</strong> pour
  extraire une copie d'une des sous-partie.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>         Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$message_num</strong>  Le numéro du message
  <info>int</info>              <strong>$flags</strong>        Le paramètre <strong>$flags</strong> optionnel est un masque qui peut contenir les
                                 valeurs suivantes : <info>FT_UID</info> - <strong>$message_num</strong> est un UID <info>FT_PEEK</info> - Ne
                                 pas lever le drapeau \Seen (Message lu) s'il n'est pas déjà levé.
                                 <info>FT_INTERNAL</info> - La chaîne renvoyée est au  format interne, et ne va
                                 pas canoniser les CRLF.
                                 
                                 <info>FT_UID</info> - <strong>$message_num</strong> est un UID
                                 
                                 <info>FT_PEEK</info> - Ne pas lever le drapeau \Seen (Message lu) s'il n'est pas
                                 déjà levé.
                                 
                                 <info>FT_INTERNAL</info> - La chaîne renvoyée est au  format interne, et ne va
                                 pas canoniser les CRLF.

<comment>Return:</comment>
  <info>string|false</info>  Retourne le corps du message spécifié, sous la forme d'une chaîne de caractères,  ou
                <info>false</info> si une erreur survient.


id: imap_bodystruct
type: function
doc:
<comment>Description:</comment>
  Lit la structure d'une section du corps d'un mail
  
  Lit la structure d'une section spécifié du corps d'un mail.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>         Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$message_num</strong>  Le numéro du message
  <info>string</info>           <strong>$section</strong>      La section du corps à lire

<comment>Return:</comment>
  <info>stdClass|false</info>  Retourne les informations dans un objet,  ou <info>false</info> si une erreur survient. Pour
                  une description détaillée de la structure de l'objet ainsi que de ses propriétés,
                  reportez-vous à la fonction <strong>imap_fetchstructure()</strong>.

<comment>See Also:</comment>
   * <strong>imap_fetchstructure()</strong>


id: imap_check
type: function
doc:
<comment>Description:</comment>
  Vérifie la boîte aux lettres courante
  
  Vérifie les informations de la boîte aux lettres courante.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>  Une instance de <class>IMAP\Connection</class>.

<comment>Return:</comment>
  <info>stdClass|false</info>  Retourne les informations dans un objet contenant les propriétés suivantes : <info>Date</info>
                  - Date de dernière modification du contenu de la boîte aux lettres en accord avec
                  la RFC2822 <info>Driver</info> - protocole utilisé pour accéder à la boîte aux lettres: POP3,
                  IMAP, NNTP. <info>Mailbox</info> - nom de la boîte aux lettres <info>Nmsgs</info> - nombre de messages de la
                  boîte aux lettres <info>Recent</info> - nombre de messages récents de la boîte aux lettres
                  
                  <info>Date</info> - Date de dernière modification du contenu de la boîte aux lettres en accord
                  avec la RFC2822
                  
                  <info>Driver</info> - protocole utilisé pour accéder à la boîte aux lettres: POP3, IMAP, NNTP.
                  
                  <info>Mailbox</info> - nom de la boîte aux lettres
                  
                  <info>Nmsgs</info> - nombre de messages de la boîte aux lettres
                  
                  <info>Recent</info> - nombre de messages récents de la boîte aux lettres
                  
                  Retourne <info>false</info> si une erreur survient.


id: imap_clearflag_full
type: function
doc:
<comment>Description:</comment>
  Supprime un flag (drapeau) sur un message
  
  <strong>imap_clearflag_full()</strong> efface le flag <strong>$flag</strong> dans les messages de la séquence <strong>$sequence</strong>, du flux
  imap <strong>$stream</strong>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>      Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$sequence</strong>  Une séquence de numéro de messages. Vous pouvez énumérer les messages
                              désirées avec la syntaxe <return>X,Y</return>, ou récupérer tous les messages contenus
                              dans un intervalle, avec la syntaxe <return>X:Y</return>
  <info>string</info>           <strong>$flag</strong>      Les flags <strong>$flag</strong> que vous pouvez effacer sont "\\Seen", "\\Answered",
                              "\\Flagged", "\\Deleted" et "\\Draft" (tels que définis dans la
                              RFC2060)
  <info>int</info>              <strong>$options</strong>   <strong>$options</strong> est un masque de bits, qui accepte uniquement la valeur
                              suivante : <info>ST_UID</info> - la séquence contient des UID au lieu de  numéros
                              de séquence
                              
                              <info>ST_UID</info> - la séquence contient des UID au lieu de  numéros de séquence

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_setflag_full()</strong>


id: imap_close
type: function
doc:
<comment>Description:</comment>
  Termine un flux IMAP
  
  Termine un flux IMAP.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>   Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$flags</strong>  S'il est défini à <info>CL_EXPUNGE</info>, la fonction effectuera une purge
                           automatique de la boîte aux lettres avant de la fermer, supprimant tous
                           les messages marqués pour l'effacement. Vous pouvez effectuer la même
                           chose avec la fonction <strong>imap_expunge()</strong>

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_open()</strong>


id: imap_create
type: function
doc:
<comment>Description:</comment>
  Alias de imap_createmailbox
  
  Cette fonction est un alias de :  <strong>imap_createmailbox()</strong>.


id: imap_createmailbox
type: function
doc:
<comment>Description:</comment>
  Crée une nouvelle boîte aux lettres
  
  Crée une nouvelle boîte aux lettres nommée <strong>$mailbox</strong>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>     Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$mailbox</strong>  Le nom de la boîte aux lettres, voir la documentation sur la fonction
                             <strong>imap_open()</strong> pour plus d'informations. Les noms contenant des caractères
                             internationaux doivent être encodés par la fonction <strong>imap_utf7_encode()</strong>
                             
                             Passer des données qui ne sont pas digne de confiance à ce paramètre
                             est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_renamemailbox()</strong>
   * <strong>imap_deletemailbox()</strong>


id: imap_delete
type: function
doc:
<comment>Description:</comment>
  Marque le fichier pour l'effacement, dans la boîte aux lettres courante
  
  Marque les messages <strong>$message_nums</strong> pour l'effacement. L'effacement réel n'interviendra que lors de
  l'appel de la fonction <strong>imap_expunge()</strong> ou de <strong>imap_close()</strong> avec le paramètre optionnel <info>CL_EXPUNGE</info>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>          Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$message_nums</strong>  Une chaîne de caractères représentant un ou plusieurs messages
                                  dans un style de format d'une séquence IMAP4 (<return>"n"</return>, <return>"n:m"</return>, ou une
                                  combinaison de ceci, délimité par des virgules).
  <info>int</info>              <strong>$flags</strong>         Vous pouvez le définir à <info>FT_UID</info> qui demande à la fonction de
                                  traiter l'argument <strong>$message_nums</strong> comme un <return>UID</return>.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info>.

<comment>See Also:</comment>
   * <strong>imap_undelete()</strong>
   * <strong>imap_expunge()</strong>
   * <strong>imap_close()</strong>


id: imap_deletemailbox
type: function
doc:
<comment>Description:</comment>
  Efface une boîte aux lettres
  
  Efface la boîte aux lettres spécifiée.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>     Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$mailbox</strong>  Le nom de la boîte aux lettres, voir la documentation sur la fonction
                             <strong>imap_open()</strong> pour plus de détails
                             
                             Passer des données qui ne sont pas digne de confiance à ce paramètre
                             est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_createmailbox()</strong>
   * <strong>imap_renamemailbox()</strong>
   * <strong>imap_open()</strong> pour le format
     <strong>$mbox</strong>
    


id: imap_errors
type: function
doc:
<comment>Description:</comment>
  Retourne toutes les erreurs IMAP survenues
  
  Cette fonction retourne un tableau de tous les messages d'erreurs IMAP générés depuis le dernier
  appel à <strong>imap_errors()</strong> ou depuis le début de la page.
  
  Lorsque <strong>imap_errors()</strong> est appelée, la pile d'erreurs est vidée.

<comment>Return:</comment>
  <info>array|false</info>  Cette fonction retourne un tableau contenant tous les messages d'erreur IMAP générés
               depuis le dernier appel à la fonction <strong>imap_errors()</strong> ou depuis le début de la page.
               Retourne <info>false</info> si aucun message d'erreur n'est disponible.

<comment>See Also:</comment>
   * <strong>imap_last_error()</strong>
   * <strong>imap_alerts()</strong>


id: imap_expunge
type: function
doc:
<comment>Description:</comment>
  Efface tous les messages marqués pour l'effacement
  
  Efface tous les messages marqués pour l'effacement par <strong>imap_delete()</strong>, <strong>imap_mail_move()</strong>, ou
  <strong>imap_setflag_full()</strong>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>  Une instance de <class>IMAP\Connection</class>.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info>.


id: imap_fetch_overview
type: function
doc:
<comment>Description:</comment>
  Lit le sommaire des en-têtes de messages
  
  Lit les en-têtes des courriers électroniques de la séquence <strong>$sequence</strong> et retourne un sommaire de
  leur contenu.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>      Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$sequence</strong>  Une description de la séquence du message. Vous pouvez énumérer les
                              messages désirés avec la syntaxe <return>X,Y</return>, ou récupérer tous les messages
                              d'un intervalle, avec la syntaxe <return>X:Y</return>
  <info>int</info>              <strong>$flags</strong>     <strong>$sequence</strong> va contenir une séquence d'indice de message ou d'UID, si
                              <strong>$flags</strong> contient <info>FT_UID</info>.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau d'objets décrivant l'en-tête de chaque message. L'objet ne
               définira une propriété que si elle existe. Les propriétés possibles sont : <return>subject</return> :
               le sujet du message <return>from</return> : l'expéditeur <return>to</return> : le destinataire <return>date</return> : la date
               d'expédition <return>message_id</return> : l'identification du message <return>references</return> : la référence sur
               l'id de ce message <return>in_reply_to</return> : la réponse à cet identifiant de message <return>size</return> : la
               taille en octets <return>uid</return> : UID du message dans la boîte aux lettres <return>msgno</return> : le numéro de
               séquence du message dans la boîte <return>recent</return> : ce message est récent <return>flagged</return> : ce message
               est marqué <return>answered</return> : ce message a donné lieu à une réponse <return>deleted</return> : ce message est
               marqué pour l'effacement <return>seen</return> : ce message est déjà lu <return>draft</return> : ce message est un
               brouillon <return>udate</return> : l'horodatage UNIX de l'heure d'arrivée  The function returns <info>false</info>
               on failure.
               
               <return>subject</return> : le sujet du message
               
               <return>from</return> : l'expéditeur
               
               <return>to</return> : le destinataire
               
               <return>date</return> : la date d'expédition
               
               <return>message_id</return> : l'identification du message
               
               <return>references</return> : la référence sur l'id de ce message
               
               <return>in_reply_to</return> : la réponse à cet identifiant de message
               
               <return>size</return> : la taille en octets
               
               <return>uid</return> : UID du message dans la boîte aux lettres
               
               <return>msgno</return> : le numéro de séquence du message dans la boîte
               
               <return>recent</return> : ce message est récent
               
               <return>flagged</return> : ce message est marqué
               
               <return>answered</return> : ce message a donné lieu à une réponse
               
               <return>deleted</return> : ce message est marqué pour l'effacement
               
               <return>seen</return> : ce message est déjà lu
               
               <return>draft</return> : ce message est un brouillon
               
               <return>udate</return> : l'horodatage UNIX de l'heure d'arrivée

<comment>See Also:</comment>
   * <strong>imap_fetchheader()</strong>


id: imap_fetchbody
type: function
doc:
<comment>Description:</comment>
  Retourne une section extraite du corps d'un message
  
  Récupère une section particulière du corps des messages spécifiés. Les parties du corps ne sont
  pas décodées par cette fonction.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>         Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$message_num</strong>  Le numéro du message
  <info>string</info>           <strong>$section</strong>      Le numéro de la section. C'est une chaîne d'entiers, délimités par
                                 une virgule qui correspondent aux index dans la liste des sections
                                 du message, tel que prévu par la spécification IMAP4.
  <info>int</info>              <strong>$flags</strong>        L'option <strong>imap_fetchbody()</strong> est un masque qui peut contenir les
                                 valeurs suivantes : <info>FT_UID</info> - <strong>$message_num</strong> est un UID <info>FT_PEEK</info> - Ne
                                 pas lever le drapeau \Seen  (Message lu) s'il n'est pas déjà levé.
                                 <info>FT_INTERNAL</info> - La chaîne renvoyée est au format  interne, et ne va
                                 pas canoniser les CRLF.
                                 
                                 <info>FT_UID</info> - <strong>$message_num</strong> est un UID
                                 
                                 <info>FT_PEEK</info> - Ne pas lever le drapeau \Seen  (Message lu) s'il n'est
                                 pas déjà levé.
                                 
                                 <info>FT_INTERNAL</info> - La chaîne renvoyée est au format  interne, et ne va
                                 pas canoniser les CRLF.

<comment>Return:</comment>
  <info>string|false</info>  Retourne une section particulière du corps des messages spécifiés, sous la forme
                d'une chaîne de caractères,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_savebody()</strong>
   * <strong>imap_fetchstructure()</strong>


id: imap_fetchheader
type: function
doc:
<comment>Description:</comment>
  Retourne l'en-tête d'un message
  
  <strong>imap_fetchheader()</strong> retourne l'en-tête brut et complet RFC2822 du message <strong>$msgno</strong>, sous la forme
  d'une chaîne.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>         Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$message_num</strong>  Le numéro du message
  <info>int</info>              <strong>$flags</strong>        Les options possibles sont : <info>FT_UID</info> - <strong>$message_num</strong> est un UID
                                 <info>FT_INTERNAL</info> - La chaîne renvoyée est au format "internal" ,
                                 c'est-à-dire sans canonisation des CRLF <info>FT_PREFETCHTEXT</info> -
                                 RFC822.TEXT doit être pré téléchargé en même temps que l'en-tête.
                                 Cela réduit le RTT sur une connexion IMAP, si le message complet
                                 est souhaité. (e.g. dans une opération de sauvegarde dans un
                                 fichier).
                                 
                                 <info>FT_UID</info> - <strong>$message_num</strong> est un UID
                                 
                                 <info>FT_INTERNAL</info> - La chaîne renvoyée est au format "internal" ,
                                 c'est-à-dire sans canonisation des CRLF
                                 
                                 <info>FT_PREFETCHTEXT</info> - RFC822.TEXT doit être pré téléchargé en même
                                 temps que l'en-tête. Cela réduit le RTT sur une connexion IMAP, si
                                 le message complet est souhaité. (e.g. dans une opération de
                                 sauvegarde dans un fichier).

<comment>Return:</comment>
  <info>string|false</info>  Retourne l'en-tête du message spécifié, sous la forme d'une chaîne de caractères,
                ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_fetch_overview()</strong>


id: imap_fetchmime
type: function
doc:
<comment>Description:</comment>
  Récupère les en-têtes MIME pour une section particulière du message
  
  Récupère les en-têtes MIME pour une section particulière du corps d'un message spécifique.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>         Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$message_num</strong>  Le numéro du message.
  <info>string</info>           <strong>$section</strong>      Le numéro de la section. C'est une chaîne d'entiers délimités par
                                 une virgule qui représente l'index de la liste des sections du
                                 corps du message, tel que spécifié par l'IMAP4.
  <info>int</info>              <strong>$flags</strong>        Un masque d'une ou plusieurs options suivantes : <info>FT_UID</info> - Le
                                 paramètre <strong>$message_num</strong> est un UID. <info>FT_PEEK</info> - Ne pas placer le
                                 drapeau \Seen s'il n'est pas déjà défini. <info>FT_INTERNAL</info> - La chaîne
                                 retournée est en un format interne, et ne sera pas canonisée en
                                 CRLF.
                                 
                                 <info>FT_UID</info> - Le paramètre <strong>$message_num</strong> est un UID.
                                 
                                 <info>FT_PEEK</info> - Ne pas placer le drapeau \Seen s'il n'est pas déjà
                                 défini.
                                 
                                 <info>FT_INTERNAL</info> - La chaîne retournée est en un format interne, et ne
                                 sera pas canonisée en CRLF.

<comment>Return:</comment>
  <info>string|false</info>  Retourne les en-têtes MIME d'une section particulière du corps du message spécifié,
                sous la forme d'une chaîne de caractères,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_fetchbody()</strong>
   * <strong>imap_fetchstructure()</strong>
   * <strong>imap_fetchheader()</strong>


id: imap_fetchstructure
type: function
doc:
<comment>Description:</comment>
  Lit la structure d'un message
  
  <strong>imap_fetchstructure()</strong> lit la structure du message <strong>$msg_number</strong>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>         Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$message_num</strong>  Le numéro du message
  <info>int</info>              <strong>$flags</strong>        Ce paramètre optionnel n'a qu'une seule option, <info>FT_UID</info>, qui demande
                                 à la fonction de traiter l'argument <strong>$message_num</strong> comme un <return>UID</return>.

<comment>Return:</comment>
  <info>stdClass|false</info>  Retourne un objet dont les propriétés sont listées dans la table ci-dessous,  ou
                  <info>false</info> si une erreur survient.
                  
                   Objet retourné par <strong>imap_fetchstructure()</strong> typeType primaire de corpsencodingCodage
                  de transfert du corpsifsubtype<info>true</info> s'il y a une chaîne de sous typesubtypesous
                  type MIMEifdescription<info>true</info> s'il y a une chaîne de descriptiondescriptionChaîne de
                  description du contenuifid<info>true</info> s'il y a une chaîne d'identificationidChaîne
                  d'identificationlinesNombre de lignesbytesNombre d'octetsifdisposition<info>true</info> s'il y
                  a une chaîne de dispositiondispositionChaîne de dispositionifdparameters<info>true</info> s'il
                  y a un tableau de paramètres dparametersdparameterstableau d'objets où chaque
                  objet a une propriété <return>"attribute"</return> et une  propriété <return>"value"</return> correspondant aux
                  paramètres d'en-têtes  <return>Content-disposition</return> MIME.ifparameters<info>true</info> si le tableau de
                  paramètres existeparametersTableau d'objets où chacun a une propriété <return>"attribute"</return>
                  et  une propriété <return>"value"</return>.partsTableau d'objets décrivant chaque partie MIME du
                  message
                  
                  Type primaire de corps (peut varier suivant la bibliothèque
                  utilisée)ValeurTypeConstante0texteTYPETEXT1multipartTYPEMULTIPART2messageTYPEMESSAGE3applicationTYPEAPPLICATION4audioTYPEAUDIO5imageTYPEIMAGE6vidéoTYPEVIDEO7modèleTYPEMODEL8autreTYPEOTHER
                  
                  Codage de transfert (peut varier suivant la bibliothèque
                  utilisée)ValeurTypeConstante07 bitENC7BIT18 bitENC8BIT2BinaireENCBINARY3Base
                  64ENCBASE644Cité imprimableENCQUOTEDPRINTABLE5AutreENCOTHER

<comment>See Also:</comment>
   * <strong>imap_fetchbody()</strong>
   * <strong>imap_bodystruct()</strong>


id: imap_fetchtext
type: function
doc:
<comment>Description:</comment>
  Alias de imap_body
  
  Cette fonction est un alias de :  <strong>imap_body()</strong>.


id: imap_gc
type: function
doc:
<comment>Description:</comment>
  Efface le cache IMAP
  
  Supprime toutes les entrées d'un type donné dans le cache IMAP.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>   Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$flags</strong>  Indique le type de cache à purger. Cela peut être la combinaison des
                           constantes suivantes :  <info>IMAP_GC_ELT</info> (cache des éléments de message),
                           <info>IMAP_GC_ENV</info> (enveloppe et corps), <info>IMAP_GC_TEXTS</info> (textes).

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info>.


id: imap_get_quota
type: function
doc:
<comment>Description:</comment>
  Lit les quotas des boîtes aux lettres ainsi que des statistiques sur chacune d'elles
  
  Lit les quotas des boîtes aux lettres ainsi que des statistiques sur chacune d'elles.
  
  Pour une version utilisateur, non administrateur, de cette fonction, reportez-vous à la fonction
  <strong>imap_get_quotaroot()</strong>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>        Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$quota_root</strong>  <strong>$quota_root</strong> doit être de la forme : "<return>user.nom</return>", où "nom" est le nom
                                de la boîte aux lettres que vous souhaitez analyser.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau contenant les valeurs de quota et courante de la boîte aux
               lettres <strong>$quota_root</strong>. Le quota représente la taille maximale de votre boîte aux
               lettres. La valeur courante est l'espace actuellement utilisé par votre boîte aux
               lettres. <strong>imap_get_quota()</strong> retournera <info>false</info> en cas d'échec.
               
               Depuis PHP 4.3, la fonction reflète plus fidèlement les fonctionnalités édictée par
               la RFC2087. Le tableau retourné a changé pour supporter un nombre illimité de
               ressources retournées (i.e. messages ou sous-dossiers) avec chaque ressource nommée
               qui est identifiée par une clé. Chaque clé contient alors un autre tableau avec
               l'utilisation et le quota. L'exemple ci-dessous montre comment l'utiliser.
               
               Pour des raisons de compatibilité, la méthode d'accès originale est toujours
               disponible, mais il est recommandé de l'abandonner.

<comment>See Also:</comment>
   * <strong>imap_open()</strong>
   * <strong>imap_set_quota()</strong>
   * <strong>imap_get_quotaroot()</strong>


id: imap_get_quotaroot
type: function
doc:
<comment>Description:</comment>
  Lit les quotas de chaque utilisateur
  
  Récupère les quotas de chaque utilisateur. La valeur limite représente l'espace limite alloué pour
  cette utilisateur pour l'utilisation de sa boîte aux lettres. La valeur de l'utilisation
  représente la taille actuelle de la boîte aux lettres.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>     Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$mailbox</strong>  <strong>$mailbox</strong> doit être un nom de boîte aux lettres (i.e. INBOX).

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau d'entiers, contenant les quotas de la boîte aux lettres de
               l'utilisateur. Toutes les valeurs sont représentées par une clé basée sur le nom de
               la boîte, et par un tableau représentant le niveau d'utilisation et les limites.
               
               Cette fonction retournera <info>false</info> si une erreur est survenue, et un tableau de données
               si la réponse du serveur n'a pu être comprise.

<comment>See Also:</comment>
   * <strong>imap_open()</strong>
   * <strong>imap_set_quota()</strong>
   * <strong>imap_get_quota()</strong>


id: imap_getacl
type: function
doc:
<comment>Description:</comment>
  Retourne le ACL pour la boîte aux lettres
  
  Récupère l'ACL pour la boîte aux lettres donnée.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>     Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$mailbox</strong>  Le nom de la boîte aux lettres, voir la documentation de la fonction
                             <strong>imap_open()</strong> pour plus de détails.
                             
                             Passer des données qui ne sont pas digne de confiance à ce paramètre
                             est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau associatif sous la forme "folder" =&gt; "acl",  ou <info>false</info> si une
               erreur survient.

<comment>See Also:</comment>
   * <strong>imap_setacl()</strong>


id: imap_getmailboxes
type: function
doc:
<comment>Description:</comment>
  Liste les boîtes aux lettres, et retourne les détails de chacune
  
  Liste les boîtes aux lettres.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>       Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$reference</strong>  <strong>$reference</strong> ne devrait être que le serveur sous la forme décrite dans
                               <strong>imap_open()</strong>
                               
                               Passer des données qui ne sont pas digne de confiance à ce paramètre
                               est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
  <info>string</info>           <strong>$pattern</strong>    Spécifie la position dans la hiérarchie des boîtes
                               aux lettres, où il faut commencer à chercher.
                               
                               Il y a deux caractères
                               spéciaux que vous pouvez utiliser dans <strong>$pattern</strong> :
                               '<return>*</return>' et '<return>%</return>'.
                               '<return>*</return>' signifie : toutes les boîtes aux lettres. Si vous passez
                               <strong>$pattern</strong> comme '<return>*</return>', vous obtiendrez
                               la liste complète des boîtes aux lettres de la hiérarchie.
                               '<return>%</return>' signifie qu'on ne s'intéresse qu'au niveau courant.
                               '<return>%</return>' passé à <strong>$pattern</strong> ne retournera
                               que les boîtes aux lettres de niveau supérieur; '<return>~/mail/%</return>'
                               sous <return>UW_IMAPD</return> retournera toutes les boîtes aux lettres du
                               dossier ~/mail directory, mais pas leurs enfants.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau d'objets contenant les informations sur les boîtes aux lettres.
               Chaque objet possède un attribut de <strong>$name</strong>, qui contient le nom complet de la boîte
               aux lettres, <strong>$delimiter</strong> qui est le délimiteur hiérarchique et <strong>$attributes</strong>.
               <strong>$attributes</strong> est un masque de bits, qui contient : <info>LATT_NOINFERIORS</info> - Cette boîte aux
               lettres n'a pas d'"enfants" (il n'y a plus de boîtes aux lettres en dessous de
               celle-ci) et ne peut en contenir aucun. Un appel à la fonction <strong>imap_createmailbox()</strong>
               ne fonctionnera pas sur cette boîte. <info>LATT_NOSELECT</info> - Ceci est juste un container,
               pas une boîte aux lettres (vous ne pouvez pas l'ouvrir). <info>LATT_MARKED</info> - Cette boîte
               aux lettres est marquée. Ceci signifie qu'elle peut contenir des nouveaux messages
               depuis la dernière fois qu'elle a été vérifiée. Ce marqueur n'est pas fourni avec
               tous les serveurs IMAP. <info>LATT_UNMARKED</info> - Cette boîte aux lettres n'est pas marquée et
               ne contient pas de nouveaux messages. Si <info>MARKED</info> ou <info>UNMARKED</info> est fourni, vous pouvez
               supposer que le serveur IMAP supporte cette fonctionnalité pour cette boîte aux
               lettres. <info>LATT_REFERRAL</info> - Ce conteneur a une référence vers une boîte aux lettres
               distante. <info>LATT_HASCHILDREN</info> - Cette boîte aux lettres a des inférieurs
               sélectionnables. <info>LATT_HASNOCHILDREN</info> - Cette boîte aux lettres n'a pas d'inférieurs
               sélectionnables.  Retourne <info>false</info> en cas d'échec.
               
               <info>LATT_NOINFERIORS</info> - Cette boîte aux lettres n'a pas d'"enfants" (il n'y a plus de
               boîtes aux lettres en dessous de celle-ci) et ne peut en contenir aucun. Un appel à
               la fonction <strong>imap_createmailbox()</strong> ne fonctionnera pas sur cette boîte.
               
               <info>LATT_NOSELECT</info> - Ceci est juste un container,  pas une boîte aux lettres (vous ne
               pouvez pas l'ouvrir).
               
               <info>LATT_MARKED</info> - Cette boîte aux lettres est marquée. Ceci signifie qu'elle peut
               contenir des nouveaux messages depuis la dernière fois qu'elle a été vérifiée. Ce
               marqueur n'est pas fourni avec tous les serveurs IMAP.
               
               <info>LATT_UNMARKED</info> - Cette boîte aux lettres n'est pas marquée et ne contient pas de
               nouveaux messages. Si <info>MARKED</info> ou <info>UNMARKED</info> est fourni, vous pouvez supposer que le
               serveur IMAP supporte cette fonctionnalité pour cette boîte aux lettres.
               
               <info>LATT_REFERRAL</info> - Ce conteneur a une référence vers une boîte aux lettres distante.
               
               <info>LATT_HASCHILDREN</info> - Cette boîte aux lettres a des inférieurs sélectionnables.
               
               <info>LATT_HASNOCHILDREN</info> - Cette boîte aux lettres n'a pas d'inférieurs sélectionnables.

<comment>See Also:</comment>
   * <strong>imap_getsubscribed()</strong>


id: imap_getsubscribed
type: function
doc:
<comment>Description:</comment>
  Liste toutes les boîtes aux lettres souscrites
  
  Liste toutes les boîtes aux lettres souscrites.
  
  <strong>imap_getsubscribed()</strong> est identique à <strong>imap_getmailboxes()</strong>, mais ne retourne que les boîtes aux
  lettres auxquelles l'utilisateur est inscrit.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>       Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$reference</strong>  <strong>$reference</strong> ne devrait être que le serveur sous la forme décrite dans
                               <strong>imap_open()</strong>
                               
                               Passer des données qui ne sont pas digne de confiance à ce paramètre
                               est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
  <info>string</info>           <strong>$pattern</strong>    Spécifie la position dans la hiérarchie des boîtes
                               aux lettres, où il faut commencer à chercher.
                               
                               Il y a deux caractères
                               spéciaux que vous pouvez utiliser dans <strong>$pattern</strong> :
                               '<return>*</return>' et '<return>%</return>'.
                               '<return>*</return>' signifie : toutes les boîtes aux lettres. Si vous passez
                               <strong>$pattern</strong> comme '<return>*</return>', vous obtiendrez
                               la liste complète des boîtes aux lettres de la hiérarchie.
                               '<return>%</return>' signifie qu'on ne s'intéresse qu'au niveau courant.
                               '<return>%</return>' passé à <strong>$pattern</strong> ne retournera
                               que les boîtes aux lettres de niveau supérieur; '<return>~/mail/%</return>'
                               sous <return>UW_IMAPD</return> retournera toutes les boîtes aux lettres du
                               dossier ~/mail directory, mais pas leurs enfants.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau d'objets contenant les informations sur les boîtes aux lettres.
               Chaque objet possède un attribut de <strong>$name</strong>, qui contient le nom complet de la boîte
               aux lettres, <strong>$delimiter</strong> qui est le délimiteur hiérarchique et <strong>$attributes</strong>.
               <strong>$attributes</strong> est un masque de bits, qui contient : <info>LATT_NOINFERIORS</info> - Cette boîte aux
               lettres n'a pas d'"enfants" (il n'y a plus de boîtes aux lettres en dessous de
               celle-ci). <info>LATT_NOSELECT</info> - Ceci est juste un container,  pas une boîte aux lettres
               (vous ne pouvez pas l'ouvrir). <info>LATT_MARKED</info> - Cette boîte aux lettres est marquée.
               Utilisé uniquement avec UW-IMAPD. <info>LATT_UNMARKED</info> - Cette boîte aux lettres n'est pas
               marquée. Utilisé uniquement avec UW-IMAPD. <info>LATT_REFERRAL</info> - Ce conteneur a une
               référence vers une boîte aux lettres distante. <info>LATT_HASCHILDREN</info> - Cette boîte aux
               lettres a des inférieurs sélectionnables. <info>LATT_HASNOCHILDREN</info> - Cette boîte aux
               lettres n'a pas d'inférieurs sélectionnables.  The function returns <info>false</info> on failure.
               
               <info>LATT_NOINFERIORS</info> - Cette boîte aux lettres n'a pas d'"enfants" (il n'y a plus de
               boîtes aux lettres en dessous de celle-ci).
               
               <info>LATT_NOSELECT</info> - Ceci est juste un container,  pas une boîte aux lettres (vous ne
               pouvez pas l'ouvrir).
               
               <info>LATT_MARKED</info> - Cette boîte aux lettres est marquée. Utilisé uniquement avec UW-IMAPD.
               
               <info>LATT_UNMARKED</info> - Cette boîte aux lettres n'est pas marquée. Utilisé uniquement avec
               UW-IMAPD.
               
               <info>LATT_REFERRAL</info> - Ce conteneur a une référence vers une boîte aux lettres distante.
               
               <info>LATT_HASCHILDREN</info> - Cette boîte aux lettres a des inférieurs sélectionnables.
               
               <info>LATT_HASNOCHILDREN</info> - Cette boîte aux lettres n'a pas d'inférieurs sélectionnables.


id: imap_header
type: function
doc:
<comment>Description:</comment>
  Alias de imap_headerinfo
  
  Cette fonction est un alias de :  <strong>imap_headerinfo()</strong>.


id: imap_headerinfo
type: function
doc:
<comment>Description:</comment>
  Lit l'en-tête du message
  
  Récupère les informations sur un numéro de message donné en lisant ses en-têtes.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>            Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$message_num</strong>     Le numéro du message
  <info>int</info>              <strong>$from_length</strong>     Nombre de caractères pour la propriété <return>fetchfrom</return>. Doit être plus
                                    grand ou égal à <return>0</return>.
  <info>int</info>              <strong>$subject_length</strong>  Nombre de caractères pour la propriété <return>fetchsubject</return>. Doit être
                                    plus grand ou égal à <return>0</return>.
  <info></info>                 <strong>$defaulthost</strong>     

<comment>Return:</comment>
  <info>stdClass|false</info>  Retourne <info>false</info> en cas d'erreurs ou, en cas de succès, les informations dans un
                  objet contenant les propriétés suivantes : <return>"toaddress"</return> : toute la ligne d'en-tête
                  to: jusqu'à 1024 caractères <return>"to"</return> : un tableau d'objets issus de la ligne to: avec
                  les propriétés suivantes : <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et <return>host</return> <return>"fromaddress"</return> : toute
                  la ligne d'en-tête from: jusqu'à 1024 caractères <return>"from"</return> : un tableau d'objets
                  issus de la ligne From: avec les propriétés suivantes : <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et
                  <return>host</return> <return>"ccaddress"</return> : toute la ligne d'en-tête cc: jusqu'à 1024 caractères <return>"cc"</return> : un
                  tableau d'objets issus de la ligne cc: avec les propriétés suivantes : <return>personal</return>,
                  <return>adl</return>, <return>mailbox</return>, et <return>host</return> <return>"bccaddress"</return> : toute la ligne d'en-tête bcc: jusqu'à 1024
                  caractères <return>"bcc"</return> : un tableau d'objets issus de la ligne Bcc: avec les propriétés
                  suivantes : <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et <return>host</return> <return>"reply_toaddress"</return> : toute la ligne
                  d'en-tête Reply_to: jusqu'à 1024 caractères <return>"reply_to"</return> : un tableau d'objets issus
                  de la ligne Reply_to: avec les propriétés suivantes : <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et
                  <return>host</return> <return>"senderaddress"</return> : toute la ligne d'en-tête Sender: jusqu'à 1024 caractères
                  <return>"sender"</return> : un tableau d'objets issus de la ligne Sender: avec les propriétés
                  suivantes : <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et <return>host</return> <return>"return_pathaddress"</return> : toute la ligne
                  d'en-tête Return-path: jusqu'à 1024 caractères <return>"return_path"</return> : un tableau d'objets
                  issus de la ligne Return-path: avec les propriétés suivantes : <return>personal</return>, <return>adl</return>,
                  <return>mailbox</return>, et <return>host</return>  remail - <return>"date"</return> : La date du message, telle que trouvée dans les
                  en-têtes <return>"Date"</return> : Identique à <return>"date"</return> <return>"subject"</return> : Le sujet du message <return>"Subject"</return> :
                  Identique à <return>"subject"</return> <return>"in_reply_to"</return> :  <return>"message_id"</return> :  <return>"newsgroups"</return> :
                  <return>"followup_to"</return> :  <return>"references"</return> :  <return>"Recent"</return> : <return>R</return> si le message est récent et lu, <return>N</return> si
                  le message est récent et non lu, <return>" "</return> si le message n'est pas récent. <return>"Unseen"</return> : <return>U</return>
                  si le message est non lu ET non récent, <return>" "</return> si le message est non lu et récent
                  <return>"Flagged"</return> : <return>F</return> si le message contient un drapeau, <return>" "</return> sinon <return>"Answered"</return> : <return>A</return> si une
                  réponse a été faite à ce message, <return>" "</return> sinon <return>"Deleted"</return> : <return>D</return> si le message est
                  effacé, <return>" "</return> sinon <return>"Draft"</return> : <return>X</return> si le message est un brouillon, <return>" "</return> sinon <return>"Msgno"</return> :
                  Le numéro du message <return>"MailDate"</return> :  <return>"Size"</return> : La taille du message <return>"udate"</return> : Date de
                  l<return>"envoi du message, sous la forme d"</return>une date Unix <return>"fetchfrom"</return> : Ligne <return>"from"</return>
                  formatée afin de tenir dans <strong>$from_length</strong> caractères <return>"fetchsubject"</return> : Ligne
                  <return>"subject"</return> formatée afin de tenir dans <strong>$subject_length</strong> caractères
                  
                  <return>"toaddress"</return> : toute la ligne d'en-tête to: jusqu'à 1024 caractères
                  
                  <return>"to"</return> : un tableau d'objets issus de la ligne to: avec les propriétés suivantes :
                  <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et <return>host</return>
                  
                  <return>"fromaddress"</return> : toute la ligne d'en-tête from: jusqu'à 1024 caractères
                  
                  <return>"from"</return> : un tableau d'objets issus de la ligne From: avec les propriétés suivantes
                  : <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et <return>host</return>
                  
                  <return>"ccaddress"</return> : toute la ligne d'en-tête cc: jusqu'à 1024 caractères
                  
                  <return>"cc"</return> : un tableau d'objets issus de la ligne cc: avec les propriétés suivantes :
                  <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et <return>host</return>
                  
                  <return>"bccaddress"</return> : toute la ligne d'en-tête bcc: jusqu'à 1024 caractères
                  
                  <return>"bcc"</return> : un tableau d'objets issus de la ligne Bcc: avec les propriétés suivantes :
                  <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et <return>host</return>
                  
                  <return>"reply_toaddress"</return> : toute la ligne d'en-tête Reply_to: jusqu'à 1024 caractères
                  
                  <return>"reply_to"</return> : un tableau d'objets issus de la ligne Reply_to: avec les propriétés
                  suivantes : <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et <return>host</return>
                  
                  <return>"senderaddress"</return> : toute la ligne d'en-tête Sender: jusqu'à 1024 caractères
                  
                  <return>"sender"</return> : un tableau d'objets issus de la ligne Sender: avec les propriétés
                  suivantes : <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et <return>host</return>
                  
                  <return>"return_pathaddress"</return> : toute la ligne d'en-tête Return-path: jusqu'à 1024
                  caractères
                  
                  <return>"return_path"</return> : un tableau d'objets issus de la ligne Return-path: avec les
                  propriétés suivantes : <return>personal</return>, <return>adl</return>, <return>mailbox</return>, et <return>host</return>
                  
                  remail -
                  
                  <return>"date"</return> : La date du message, telle que trouvée dans les en-têtes
                  
                  <return>"Date"</return> : Identique à <return>"date"</return>
                  
                  <return>"subject"</return> : Le sujet du message
                  
                  <return>"Subject"</return> : Identique à <return>"subject"</return>
                  
                  <return>"in_reply_to"</return> :
                  
                  <return>"message_id"</return> :
                  
                  <return>"newsgroups"</return> :
                  
                  <return>"followup_to"</return> :
                  
                  <return>"references"</return> :
                  
                  <return>"Recent"</return> : <return>R</return> si le message est récent et lu, <return>N</return> si le message est récent et non lu,
                  <return>" "</return> si le message n'est pas récent.
                  
                  <return>"Unseen"</return> : <return>U</return> si le message est non lu ET non récent, <return>" "</return> si le message est non lu
                  et récent
                  
                  <return>"Flagged"</return> : <return>F</return> si le message contient un drapeau, <return>" "</return> sinon
                  
                  <return>"Answered"</return> : <return>A</return> si une réponse a été faite à ce message, <return>" "</return> sinon
                  
                  <return>"Deleted"</return> : <return>D</return> si le message est effacé, <return>" "</return> sinon
                  
                  <return>"Draft"</return> : <return>X</return> si le message est un brouillon, <return>" "</return> sinon
                  
                  <return>"Msgno"</return> : Le numéro du message
                  
                  <return>"MailDate"</return> :
                  
                  <return>"Size"</return> : La taille du message
                  
                  <return>"udate"</return> : Date de l<return>"envoi du message, sous la forme d"</return>une date Unix
                  
                  <return>"fetchfrom"</return> : Ligne <return>"from"</return> formatée afin de tenir dans <strong>$from_length</strong> caractères
                  
                  <return>"fetchsubject"</return> : Ligne <return>"subject"</return> formatée afin de tenir dans <strong>$subject_length</strong>
                  caractères

<comment>See Also:</comment>
   * <strong>imap_fetch_overview()</strong>


id: imap_headers
type: function
doc:
<comment>Description:</comment>
  Retourne les en-têtes de tous les messages d'une boîte aux lettres
  
  Retourne les en-têtes de tous les messages d'une boîte aux lettres.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>  Une instance de <class>IMAP\Connection</class>.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau de chaînes contenant les en-têtes des messages : une chaîne par
               message. Retourne <info>false</info> en cas d'échec.


id: imap_is_open
type: function
doc:
<comment>Description:</comment>
  Vérifier si le flux IMAP est toujours valide
  
  Vérifie si le flux IMAP est toujours valide.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>  Une instance de <class>IMAP\Connection</class>.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le flux est toujours valide, <info>false</info> sinon.


id: imap_last_error
type: function
doc:
<comment>Description:</comment>
  Retourne la dernière erreur survenue
  
  <strong>imap_last_error()</strong> retourne le texte complet de la dernière erreur IMAP (si elle existe) qui est
  survenue lors de la dernière requête. La pile d'erreur n'est pas touchée. Appeler
  <strong>imap_last_error()</strong> successivement, sans de nouvelles erreurs, retournera la même erreur.

<comment>Return:</comment>
  <info>string|false</info>  Retourne le texte complet du dernier message d'erreur IMAP survenu sur la page
                courante. Retourne <info>false</info> si aucun message n'est disponible.

<comment>See Also:</comment>
   * <strong>imap_errors()</strong>


id: imap_list
type: function
doc:
<comment>Description:</comment>
  Lit la liste des boîtes aux lettres
  
  Lit la liste des boîtes aux lettres.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>       Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$reference</strong>  <strong>$reference</strong> ne devrait être que le serveur sous la forme décrite dans
                               <strong>imap_open()</strong>
                               
                               Passer des données qui ne sont pas digne de confiance à ce paramètre
                               est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
  <info>string</info>           <strong>$pattern</strong>    Spécifie la position dans la hiérarchie des boîtes
                               aux lettres, où il faut commencer à chercher.
                               
                               Il y a deux caractères
                               spéciaux que vous pouvez utiliser dans <strong>$pattern</strong> :
                               '<return>*</return>' et '<return>%</return>'.
                               '<return>*</return>' signifie : toutes les boîtes aux lettres. Si vous passez
                               <strong>$pattern</strong> comme '<return>*</return>', vous obtiendrez
                               la liste complète des boîtes aux lettres de la hiérarchie.
                               '<return>%</return>' signifie qu'on ne s'intéresse qu'au niveau courant.
                               '<return>%</return>' passé à <strong>$pattern</strong> ne retournera
                               que les boîtes aux lettres de niveau supérieur; '<return>~/mail/%</return>'
                               sous <return>UW_IMAPD</return> retournera toutes les boîtes aux lettres du
                               dossier ~/mail directory, mais pas leurs enfants.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau contenant les noms des boîtes aux lettres,  ou <info>false</info> si une
               erreur survient.

<comment>See Also:</comment>
   * <strong>imap_getmailboxes()</strong>
   * <strong>imap_lsub()</strong>


id: imap_listmailbox
type: function
doc:
<comment>Description:</comment>
  Alias de imap_list
  
  Cette fonction est un alias de :  <strong>imap_list()</strong>.


id: imap_listscan
type: function
doc:
<comment>Description:</comment>
  Lit la liste des boîtes aux lettres, et y recherche une chaîne
  
  Retourne un tableau contenant les noms des boîtes aux lettres qui contiennent la chaîne <strong>$content</strong>
  dans leur nom.
  
  Cette fonction est similaire à <strong>imap_listmailbox()</strong>, mais va aussi vérifier la présence de la chaîne
  <strong>$content</strong> dans les messages de la boîte aux lettres.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>       Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$reference</strong>  <strong>$reference</strong> ne devrait être que le serveur sous la forme décrite dans
                               <strong>imap_open()</strong>
                               
                               Passer des données qui ne sont pas digne de confiance à ce paramètre
                               est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
  <info>string</info>           <strong>$pattern</strong>    Spécifie la position dans la hiérarchie des boîtes
                               aux lettres, où il faut commencer à chercher.
                               
                               Il y a deux caractères
                               spéciaux que vous pouvez utiliser dans <strong>$pattern</strong> :
                               '<return>*</return>' et '<return>%</return>'.
                               '<return>*</return>' signifie : toutes les boîtes aux lettres. Si vous passez
                               <strong>$pattern</strong> comme '<return>*</return>', vous obtiendrez
                               la liste complète des boîtes aux lettres de la hiérarchie.
                               '<return>%</return>' signifie qu'on ne s'intéresse qu'au niveau courant.
                               '<return>%</return>' passé à <strong>$pattern</strong> ne retournera
                               que les boîtes aux lettres de niveau supérieur; '<return>~/mail/%</return>'
                               sous <return>UW_IMAPD</return> retournera toutes les boîtes aux lettres du
                               dossier ~/mail directory, mais pas leurs enfants.
  <info>string</info>           <strong>$content</strong>    La chaîne cherchée

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau contenant les noms des boîtes aux lettres qui contiennent la
               chaîne <strong>$content</strong> dans le nom de la boîte aux lettres,  ou <info>false</info> si une erreur
               survient.

<comment>See Also:</comment>
   * <strong>imap_listmailbox()</strong>
   * <strong>imap_search()</strong>


id: imap_listsubscribed
type: function
doc:
<comment>Description:</comment>
  Alias de imap_lsub
  
  Cette fonction est un alias de :  <strong>imap_lsub()</strong>.


id: imap_lsub
type: function
doc:
<comment>Description:</comment>
  Liste toutes les boîtes aux lettres enregistrées
  
  Récupère un tableau contenant toutes les boîtes aux lettres auxquelles vous avez souscrit.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>       Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$reference</strong>  <strong>$reference</strong> ne devrait être que le serveur sous la forme décrite dans
                               <strong>imap_open()</strong>
                               
                               Passer des données qui ne sont pas digne de confiance à ce paramètre
                               est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
  <info>string</info>           <strong>$pattern</strong>    Spécifie la position dans la hiérarchie des boîtes
                               aux lettres, où il faut commencer à chercher.
                               
                               Il y a deux caractères
                               spéciaux que vous pouvez utiliser dans <strong>$pattern</strong> :
                               '<return>*</return>' et '<return>%</return>'.
                               '<return>*</return>' signifie : toutes les boîtes aux lettres. Si vous passez
                               <strong>$pattern</strong> comme '<return>*</return>', vous obtiendrez
                               la liste complète des boîtes aux lettres de la hiérarchie.
                               '<return>%</return>' signifie qu'on ne s'intéresse qu'au niveau courant.
                               '<return>%</return>' passé à <strong>$pattern</strong> ne retournera
                               que les boîtes aux lettres de niveau supérieur; '<return>~/mail/%</return>'
                               sous <return>UW_IMAPD</return> retournera toutes les boîtes aux lettres du
                               dossier ~/mail directory, mais pas leurs enfants.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau contenant toutes les boîtes aux lettres souscrites,  ou <info>false</info> si
               une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_list()</strong>
   * <strong>imap_getmailboxes()</strong>


id: imap_mail
type: function
doc:
<comment>Description:</comment>
  Envoie un message mail
  
  <strong>imap_mail()</strong> permet d'envoyer des mails  avec une gestion correcte des destinataires Cc et Bcc.
  
  Les paramètres <strong>$to</strong>, <strong>$cc</strong> et <strong>$bcc</strong> sont tous des chaînes et sont analysées comme des listes
  d'adresses RFC822.

<comment>Param:</comment>
  <info>string</info>       <strong>$to</strong>                  Le destinataire
  <info>string</info>       <strong>$subject</strong>             Le sujet du mail
  <info>string</info>       <strong>$message</strong>             Le corps du mail ; voir la fonction <strong>imap_mail_compose()</strong>.
  <info>string|null</info>  <strong>$additional_headers</strong>  Une chaîne de caractères contenant les en-têtes additionnels à
                                    envoyer avec le mail
  <info>string|null</info>  <strong>$cc</strong>                  
  <info>string|null</info>  <strong>$bcc</strong>                 Les destinataires spécifiés dans le <strong>$bcc</strong> recevront le mail mais
                                    sont exclus des en-têtes.
  <info>string|null</info>  <strong>$return_path</strong>         Utiliser ce paramètre pour spécifier le chemin de retour en cas
                                    d'échec de délivrance du mail. C'est utile lorsque vous utilisez
                                    PHP comme client mail pour plusieurs utilisateurs.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>mail()</strong>
   * <strong>imap_mail_compose()</strong>


id: imap_mail_compose
type: function
doc:
<comment>Description:</comment>
  Crée un message MIME
  
  Crée un message MIME basé sur l'enveloppe <strong>$envelope</strong> et les sections <strong>$bodies</strong>.

<comment>Param:</comment>
  <info>array</info>  <strong>$envelope</strong>  Un tableau associatif contenant les champs des en-têtes. Les clés valides sont :
                    <return>"remail"</return>, <return>"return_path"</return>, <return>"date"</return>, <return>"from"</return>, <return>"reply_to"</return>, <return>"in_reply_to"</return>, <return>"subject"</return>,
                    <return>"to"</return>, <return>"cc"</return>, <return>"bcc"</return> et <return>"message_id"</return>, qui définie les en-têtes respectifs à la
                    chaîne de caractères donnée. Pour définir des en-têtes additionnels, la clé
                    <return>"custom_headers"</return> est supporté, qui attend un tableau de ces en-têtes, par
                    exemple ["User-Agent: My Mail Client"].
  <info>array</info>  <strong>$bodies</strong>    Un tableau indexé des corps. Le premier corps est le corps principal du message
                    ; seulement s'il est du type <info>TYPEMULTIPART</info>, les corps suivant seront traité ;
                    ces corps constitue les corps des parties.
                    
                    Structure d'un Tableau d'un CorpsCléTypeDescription<return>type</return><info>int</info> Le type MIME. Un de
                    <info>TYPETEXT</info> (par défault), <info>TYPEMULTIPART</info>, <info>TYPEMESSAGE</info>, <info>TYPEAPPLICATION</info>, <info>TYPEAUDIO</info>,
                    <info>TYPEIMAGE</info>, <info>TYPEMODEL</info> ou <info>TYPEOTHER</info>. <return>encoding</return><info>int</info> Le <return>Content-Transfer-Encoding</return>. Un
                    de <info>ENC7BIT</info> (par défault), <info>ENC8BIT</info>, <info>ENCBINARY</info>, <info>ENCBASE64</info>, <info>ENCQUOTEDPRINTABLE</info> or
                    <info>ENCOTHER</info>. <return>charset</return><info>string</info>Le jeu d'encodage du paramètre du type
                    MIME.<return>type.parameters</return><info>array</info> Un tableau associatif de nom de paramètre <return>Content-Type</return>
                    et leur valeurs. <return>subtype</return><info>string</info>Le sous-type MIME, e.g. <return>'jpeg'</return> pour
                    <info>TYPEIMAGE</info>.<return>id</return><info>string</info>Le <return>Content-ID</return>.<return>description</return><info>string</info>Le
                    <return>Content-Description</return>.<return>disposition.type</return><info>string</info>Le <return>Content-Disposition</return>, e.g.
                    <return>'attachment'</return>.<return>disposition</return><info>array</info> Un tableau associatif de nom de paramètre
                    <return>Content-Disposition</return> et leur valeurs. <return>contents.data</return><info>string</info>La charge
                    utile.<return>lines</return><info>int</info>La taille de la charge utile en lignes.<return>bytes</return><info>int</info>La taille de la
                    charge utile en octets.<return>md5</return><info>string</info>La checksum MD5 de la charge utile.

<comment>Return:</comment>
  <info>string|false</info>  Retourne le message MIME en tant que chaîne de caractères,  ou <info>false</info> si une erreur
                survient.


id: imap_mail_copy
type: function
doc:
<comment>Description:</comment>
  Copie les messages spécifiés dans une boîte aux lettres
  
  Copie les messages email spécifiés par <strong>$message_nums</strong> dans la boîte aux lettres spécifiée.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>          Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$message_nums</strong>  <strong>$message_nums</strong> est un intervalle, et pas seulement une liste de
                                  numéros de message (comme décrit dans la RFC2060).
  <info>string</info>           <strong>$mailbox</strong>       Le nom de la boîte aux lettres, voir la documentation de la
                                  fonction <strong>imap_open()</strong> pour plus de détails
                                  
                                  Passer des données qui ne sont pas digne de confiance à ce
                                  paramètre est dangereux, sauf si, imap.enable_insecure_rsh est
                                  désactivé.
  <info>int</info>              <strong>$flags</strong>         <strong>$flags</strong> est un masque, qui peut contenir une ou plusieurs des
                                  valeurs suivantes : <info>CP_UID</info> - la séquence de nombre contient des
                                  UIDS <info>CP_MOVE</info> - Efface les messages après copie. Si ce drapeau est
                                  défini, la fonction se comporte de manière identique à
                                  <strong>imap_mail_move()</strong>.
                                  
                                  <info>CP_UID</info> - la séquence de nombre contient des UIDS
                                  
                                  <info>CP_MOVE</info> - Efface les messages après copie. Si ce drapeau est
                                  défini, la fonction se comporte de manière identique à
                                  <strong>imap_mail_move()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_mail_move()</strong>


id: imap_mail_move
type: function
doc:
<comment>Description:</comment>
  Déplace des messages dans une boîte aux lettres
  
  <strong>imap_mail_move()</strong> déplace les messages spécifiés par <strong>$message_nums</strong> dans la boîte aux lettres
  <strong>$mailbox</strong>. À noter que les messages sont en réalité copiées à la boîte au lettres <strong>$mailbox</strong>, et les
  messages originaux sont marquées pour être supprimés. Ceci implique que les messages dans <strong>$mailbox</strong>
  sont assignées des nouveaux UIDs.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>          Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$message_nums</strong>  <strong>$message_nums</strong> est un intervalle, et pas seulement une liste de
                                  messages (comme décrit dans la RFC2060).
  <info>string</info>           <strong>$mailbox</strong>       Le nom de la boîte aux lettres, voir la documentation de la
                                  fonction <strong>imap_open()</strong> pour plus de détails
                                  
                                  Passer des données qui ne sont pas digne de confiance à ce
                                  paramètre est dangereux, sauf si, imap.enable_insecure_rsh est
                                  désactivé.
  <info>int</info>              <strong>$flags</strong>         <strong>$flags</strong> est un champ de bits et peut contenir une seule valeur :
                                  <info>CP_UID</info> - La séquence de nombres contient des UID
                                  
                                  <info>CP_UID</info> - La séquence de nombres contient des UID

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_mail_copy()</strong>


id: imap_mailboxmsginfo
type: function
doc:
<comment>Description:</comment>
  Lit les informations à propos de la boîte aux lettres courante
  
  <strong>imap_mailboxmsginfo()</strong> vérifie le statut courant de la boîte aux lettres sur le serveur. C'est
  similaire à l'utilisation de la fonction <strong>imap_status()</strong>, mais fournie également la taille totale
  des messages de la boîte aux lettres, ce qui demande un peu plus de temps à l'exécution.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>  Une instance de <class>IMAP\Connection</class>.

<comment>Return:</comment>
  <info>stdClass</info>  Retourne un objet avec les propriétés suivantes : Propriétés de boîte aux
            lettresDateDate de dernière modification du contenu de la boîte aux lettres (date et
            heure courantesDriverPiloteMailboxNom de la boîte aux lettresNmsgsNombre de
            messagesRecentNombre de messages récentsUnreadNombre de messages non lusDeletedNombre de
            messages effacésSizeTaille de la boîte aux lettres


id: imap_mime_header_decode
type: function
doc:
<comment>Description:</comment>
  Décode les éléments MIME d'un en-tête
  
  Décode un message MIME qui contient des données non ASCII (voir RFC2047).

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Le texte MIME

<comment>Return:</comment>
  <info>array|false</info>  Les éléments décodés sont retournés dans un tableau d'objets. Chacun de ces objets a
               deux propriétés : <return>charset</return> et <return>text</return>.
               
               Si l'élément n'a pas été encodé, ou, en d'autres termes, s'il est en clair (plain
               US_ASCII), la propriété <return>charset</return> est mise à <return>default</return>.
               
               Cette fonction retourne <info>false</info> en cas d'échec.

<comment>See Also:</comment>
   * <strong>imap_utf8()</strong>


id: imap_msgno
type: function
doc:
<comment>Description:</comment>
  Retourne le numéro de séquence du message pour un UID donné
  
  Retourne le numéro de séquence du message pour l'UID <strong>$message_uid</strong>.
  
  Cette fonction est l'inverse de la fonction <strong>imap_uid()</strong>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>         Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$message_uid</strong>  L'UID du message

<comment>Return:</comment>
  <info>int</info>  Retourne le numéro de séquence du message pour l'UID <strong>$message_uid</strong>.

<comment>See Also:</comment>
   * <strong>imap_uid()</strong>


id: imap_mutf7_to_utf8
type: function
doc:
<comment>Description:</comment>
  Décode une chaîne de caractère UTF-7 modifié en UTF-8
  
  Décode une chaîne de caractères UTF-7 modifié (comme spécifié dans la RFC 2060, section 5.1.3) en
  UTF-8.
  
  Cette fonction est seulement disponible, si libcclient exporte utf8_to_mutf7().

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Une chaîne de caractères encodé en UTF-7 modifié.

<comment>Return:</comment>
  <info>string|false</info>  Retourne <strong>$string</strong> convertit en UTF-8, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_utf8_to_mutf7()</strong>


id: imap_num_msg
type: function
doc:
<comment>Description:</comment>
  Retourne le nombre de messages dans la boîte aux lettres courante
  
  Retourne le nombre de messages dans la boîte aux lettres courante.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>  Une instance de <class>IMAP\Connection</class>.

<comment>Return:</comment>
  <info>int|false</info>  Retourne le nombre de messages dans la boîte aux lettres courante, sous la forme d'un
             entier, ou <info>false</info> en cas d'erreur.

<comment>See Also:</comment>
   * <strong>imap_num_recent()</strong>
   * <strong>imap_status()</strong>


id: imap_num_recent
type: function
doc:
<comment>Description:</comment>
  Retourne le nombre de messages récents dans la boîte aux lettres courante
  
  Retourne le nombre de messages récents dans la boîte aux lettres courante.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>  Une instance de <class>IMAP\Connection</class>.

<comment>Return:</comment>
  <info>int</info>  Retourne le nombre de messages récents dans la boîte aux lettres courante, sous la forme d'un
       entier.

<comment>See Also:</comment>
   * <strong>imap_num_msg()</strong>
   * <strong>imap_status()</strong>


id: imap_open
type: function
doc:
<comment>Description:</comment>
  Ouvre un flux IMAP vers une boîte aux lettres
  
  Ouvre un flux IMAP vers la boîte aux lettres <strong>$mailbox</strong>.
  
  Cette fonction peut aussi être utilisée pour ouvrir des flots sur des serveurs POP3 et NNTP mais
  quelques fonctions et fonctionnalités ne sont disponibles qu'avec les serveurs IMAP.

<comment>Param:</comment>
  <info>string</info>  <strong>$mailbox</strong>   Un nom de boîte aux lettres est constitué d'une adresse de serveur, et d'une
                     adresse de boîte sur ce serveur. Le mot réservé <return>INBOX</return> représente la boîte aux
                     lettres de l'utilisateur courant. Les noms de boîtes aux lettres qui
                     contiennent des caractères spéciaux (en dehors de l'espace ASCII) doivent être
                     encodés avec <strong>imap_utf7_encode()</strong>.
                     
                     Passer des données qui ne sont pas digne de confiance à ce paramètre est
                     dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
                     
                     L'adresse du serveur, mise entre accolades '{' et '}', est constituée du nom du
                     serveur ou de son adresse IP, d'une spécification de protocole (commençant par
                     '/') et d'un port optionnel (spécifié avec ':').
                     
                     Cette partie est obligatoire dans les paramètres de la boîte aux lettres.
                     
                     Tous les noms commençant par <return>{</return> sont des noms distants et sont sous la forme <return>"{"
                     nom_systeme_distant [":" port] [flags] "}" [nom_mailbox]</return> où :
                     <return>remote_system_name</return> : Nom de domaine Internet ou une adresse IP de serveur
                     entouré de guillemets. <return>port</return> : numéro de port TCP (optionnel), la valeur par
                     défaut est la valeur du port pour ce service. <return>flags</return> : options, voir la table
                     suivante. <return>mailbox_name</return> : nom de la mailbox distante, par défaut : INBOX
                     
                     <return>remote_system_name</return> : Nom de domaine Internet ou une adresse IP de serveur
                     entouré de guillemets.
                     
                     <return>port</return> : numéro de port TCP (optionnel), la valeur par défaut est la valeur du
                     port pour ce service.
                     
                     <return>flags</return> : options, voir la table suivante.
                     
                     <return>mailbox_name</return> : nom de la mailbox distante, par défaut : INBOX
                     
                     Flags optionnels pour les nomsFlagDescription<return>/service=</return>serviceservice pour
                     l'accès à la mailbox, par défaut : "imap"<return>/user=</return>usernom de l'utilisateur distant
                     pour l'identification sur le serveur<return>/authuser=</return>userutilisateur distance
                     d'identification ; si spécifié, ce sera le nom de l'utilisateur dont le mot de
                     passe est utilisé (e.g. administrator)<return>/anonymous</return>accès distant en
                     anonyme<return>/debug</return>la télémétrie d'enregistrement du protocole dans les logs de
                     déboguage de l'application<return>/secure</return>ne transmet pas un mot de passe en clair à
                     travers le réseau<return>/imap</return>, <return>/imap2</return>, <return>/imap2bis</return>, <return>/imap4</return>, <return>/imap4rev1</return>équivalent de
                     <return>/service=imap</return><return>/pop3</return>équivalent de <return>/service=pop3</return><return>/nntp</return>équivalent de
                     <return>/service=nntp</return><return>/norsh</return>ne pas utiliser rsh ou ssh pour établir une session de pré
                     identification IMAP<return>/ssl</return>utilise <return>Secure Socket Layer</return> pour crypter la
                     session<return>/validate-cert</return>valide les certificats depuis le serveur TLS/SSL (c'est le
                     comportement par défaut)<return>/novalidate-cert</return>ne pas valider les certificats depuis
                     le serveur TLS/SSL, nécessaire si le serveur utilise des certificats
                     autosignés<return>/tls</return>force l'utilisation de <return>start-TLS</return> pour chiffrer la session et
                     rejette les connexions aux serveurs qui ne le supporte pas<return>/notls</return>n'utilise pas
                     <return>start-TLS</return> pour chiffrer la session, y compris avec les serveurs qui le
                     supporte<return>/readonly</return>demande un accès en lecture seule sur mailbox (IMAP uniquement
                     ; ignoré sous NNTP, et une erreur avec SMTP et POP3)
  <info>string</info>  <strong>$user</strong>      Le nom d'utilisateur
  <info>string</info>  <strong>$password</strong>  Le mot de passe associé avec l'utilisateur <strong>$user</strong>
  <info>int</info>     <strong>$flags</strong>     <strong>$flags</strong> est un masque de bit, qui peut prendre une ou plusieurs des valeurs
                     suivantes : <info>OP_READONLY</info> : Ouvre une boîte aux lettres en lecture seule
                     <info>OP_ANONYMOUS</info> : Ne pas utiliser, ou modifier le fichier .newsrc pour les news
                     (NNTP uniquement) <info>OP_HALFOPEN</info> : Pour les noms IMAP et NNTP, ouvre une connexion
                     mais n'ouvre pas une boîte aux lettres. <info>CL_EXPUNGE</info> : Supprime automatiquement
                     la boîte aux lettres de la liste, lors de la terminaison du flux (voir aussi
                     <strong>imap_delete()</strong> and <strong>imap_expunge()</strong>) <info>OP_DEBUG</info> : négociations de débogage du
                     protocole <info>OP_SHORTCACHE</info> : Cache court (<return>elt</return> uniquement) <info>OP_SILENT</info> : Ne pas
                     transmettre les événements (utilisation interne) <info>OP_PROTOTYPE</info> : Retourne le
                     prototype du driver <info>OP_SECURE</info> : Ne pas effectuer des identifications non
                     sécurisées
                     
                     <info>OP_READONLY</info> : Ouvre une boîte aux lettres en lecture seule
                     
                     <info>OP_ANONYMOUS</info> : Ne pas utiliser, ou modifier le fichier .newsrc pour les news
                     (NNTP uniquement)
                     
                     <info>OP_HALFOPEN</info> : Pour les noms IMAP et NNTP, ouvre une connexion mais n'ouvre pas
                     une boîte aux lettres.
                     
                     <info>CL_EXPUNGE</info> : Supprime automatiquement la boîte aux lettres de la liste, lors de
                     la terminaison du flux (voir aussi <strong>imap_delete()</strong> and <strong>imap_expunge()</strong>)
                     
                     <info>OP_DEBUG</info> : négociations de débogage du protocole
                     
                     <info>OP_SHORTCACHE</info> : Cache court (<return>elt</return> uniquement)
                     
                     <info>OP_SILENT</info> : Ne pas transmettre les événements (utilisation interne)
                     
                     <info>OP_PROTOTYPE</info> : Retourne le prototype du driver
                     
                     <info>OP_SECURE</info> : Ne pas effectuer des identifications non sécurisées
  <info>int</info>     <strong>$retries</strong>   Le nombre maximal de tentatives de connexion.
  <info>array</info>   <strong>$options</strong>   Paramètres de connexion ; les clés peuvent être utilisées pour définir un ou
                     plusieurs paramètres de connexion : <return>DISABLE_AUTHENTICATOR</return> - Désactive les
                     propriétés d'authentification
                     
                     <return>DISABLE_AUTHENTICATOR</return> - Désactive les propriétés d'authentification

<comment>Return:</comment>
  <info>IMAP\Connection|false</info>  Retourne une instance de <class>IMAP\Connection</class> en cas de succès, ou <info>false</info> si une
                         erreur survient.

<comment>See Also:</comment>
   * <strong>imap_close()</strong>


id: imap_ping
type: function
doc:
<comment>Description:</comment>
  Vérifie que le flux IMAP est toujours actif
  
  Vérifie que le flux est toujours actif, en lui envoyant un ping. Cette fonction permet de se
  rendre compte qu'un mail est arrivé : c'est même la méthode préconisée pour des tests périodiques
  de vérification du courrier. Cette fonction peut aussi servir à garder une connexion ouverte, avec
  les serveurs dotés d'un délai d'expiration.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>  Une instance de <class>IMAP\Connection</class>.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le flux est toujours actif, <info>false</info> sinon.


id: imap_qprint
type: function
doc:
<comment>Description:</comment>
  Convertit une chaîne à guillemets en une chaîne à 8 bits
  
  Convertit la chaîne à guillemets <strong>$string</strong> en une chaîne à 8 bits (selon la RFC2045, section 6.7).

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Une chaîne à guillemets

<comment>Return:</comment>
  <info>string|false</info>  Retourne une chaîne de caractères à 8 bits,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_8bit()</strong>


id: imap_rename
type: function
doc:
<comment>Description:</comment>
  Alias de imap_renamemailbox
  
  Cette fonction est un alias de :  <strong>imap_renamemailbox()</strong>.


id: imap_renamemailbox
type: function
doc:
<comment>Description:</comment>
  Renomme une boîte aux lettres
  
  <strong>imap_renamemailbox()</strong> renomme la boîte aux lettres <strong>$from</strong> en <strong>$to</strong> (voir la fonction <strong>imap_open()</strong> pour
  le format des noms <strong>$mbox</strong>).

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>  Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$from</strong>  L'ancien nom de la boîte aux lettres, voir la documentation de la fonction
                          <strong>imap_open()</strong> pour plus de détails
                          
                          Passer des données qui ne sont pas digne de confiance à ce paramètre est
                          dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
  <info>string</info>           <strong>$to</strong>    Le nouveau nom de la boîte aux lettres, voir la documentation de la
                          fonction <strong>imap_open()</strong> pour plus de détails
                          
                          Passer des données qui ne sont pas digne de confiance à ce paramètre est
                          dangereux, sauf si, imap.enable_insecure_rsh est désactivé.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_createmailbox()</strong>
   * <strong>imap_deletemailbox()</strong>


id: imap_reopen
type: function
doc:
<comment>Description:</comment>
  Réouvre un flux IMAP vers une nouvelle boîte aux lettres
  
  Réouvre la connexion spécifiée au serveur IMAP ou NNTP, avec une nouvelle boîtes aux lettres.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>     Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$mailbox</strong>  Le nom de la boîte aux lettres, voir la documentation de la fonction
                             <strong>imap_open()</strong> pour plus de détails
                             
                             Passer des données qui ne sont pas digne de confiance à ce paramètre
                             est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
  <info>int</info>              <strong>$flags</strong>    <strong>$flags</strong> est un masque de bits, qui peut contenir les valeurs suivantes :
                             <info>OP_READONLY</info> - Ouvre une boîte aux lettres en lecture seule <info>OP_ANONYMOUS</info>
                             - Ne pas utiliser, ou modifier le fichier .newsrc pour les news (NNTP
                             uniquement) <info>OP_HALFOPEN</info> - Pour les noms IMAP et NNTP, ouvre une
                             connexion mais n'ouvre pas une boîte aux lettres. <info>OP_EXPUNGE</info> - Supprime
                             silencieusement le flux recyclé <info>CL_EXPUNGE</info> - Supprime automatiquement
                             la boîte aux lettres de la liste, lors de la terminaison du flux. (voir
                             <strong>imap_delete()</strong> et <strong>imap_expunge()</strong>).
                             
                             <info>OP_READONLY</info> - Ouvre une boîte aux lettres en lecture seule
                             
                             <info>OP_ANONYMOUS</info> - Ne pas utiliser, ou modifier le fichier .newsrc pour les
                             news (NNTP uniquement)
                             
                             <info>OP_HALFOPEN</info> - Pour les noms IMAP et NNTP, ouvre une connexion mais
                             n'ouvre pas une boîte aux lettres.
                             
                             <info>OP_EXPUNGE</info> - Supprime silencieusement le flux recyclé
                             
                             <info>CL_EXPUNGE</info> - Supprime automatiquement la boîte aux lettres de la liste,
                             lors de la terminaison du flux. (voir <strong>imap_delete()</strong> et <strong>imap_expunge()</strong>).
  <info>int</info>              <strong>$retries</strong>  Le nombre maximal de tentatives de connexion

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le flux est réouvert, <info>false</info> sinon.


id: imap_rfc822_parse_adrlist
type: function
doc:
<comment>Description:</comment>
  Analyse une adresse email
  
  Analyse la chaîne <strong>$address</strong>, tel que définie dans la RFC2822.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>            Une chaîne de caractères contenant les adresses
  <info>string</info>  <strong>$default_hostname</strong>  Le nom de l'hôte par défaut

<comment>Return:</comment>
  <info>array</info>  Retourne un tableau d'objets. Les propriétés des objets sont :
         
         <return>"mailbox"</return> : Le nom de la boîte aux lettres (nom d'utilisateur) <return>"host"</return> : Le nom de l'hôte
         <return>"personal"</return> : Le nom personnel <return>"adl"</return> : at domain source route (NDT : ???)
         
         <return>"mailbox"</return> : Le nom de la boîte aux lettres (nom d'utilisateur)
         
         <return>"host"</return> : Le nom de l'hôte
         
         <return>"personal"</return> : Le nom personnel
         
         <return>"adl"</return> : at domain source route (NDT : ???)

<comment>See Also:</comment>
   * <strong>imap_rfc822_parse_headers()</strong>


id: imap_rfc822_parse_headers
type: function
doc:
<comment>Description:</comment>
  Analyse un en-tête mail
  
  Analyse la chaîne <strong>$headers</strong> et retourne un objet contenant différents éléments, similaires à la
  fonction <strong>imap_header()</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$headers</strong>           Les données à analyser
  <info>string</info>  <strong>$default_hostname</strong>  Le nom de l'hôte par défaut

<comment>Return:</comment>
  <info>stdClass</info>  Retourne un objet similaire à celui retourné par la fonction <strong>imap_header()</strong>, excepté pour
            les drapeaux et les autres propriétés qui proviennent du serveur IMAP.

<comment>See Also:</comment>
   * <strong>imap_rfc822_parse_adrlist()</strong>


id: imap_rfc822_write_address
type: function
doc:
<comment>Description:</comment>
  Retourne une adresse email formatée correctement
  
  Retourne une adresse email formatée correctement selon la RFC2822.

<comment>Param:</comment>
  <info>string</info>  <strong>$mailbox</strong>   Le nom de la boîte aux lettres, voir la documentation de la fonction
                     <strong>imap_open()</strong> pour plus de détails
                     
                     Passer des données qui ne sont pas digne de confiance à ce paramètre est
                     dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
  <info>string</info>  <strong>$hostname</strong>  La partie hôte de l'email
  <info>string</info>  <strong>$personal</strong>  Le nom du propriétaire du compte

<comment>Return:</comment>
  <info>string|false</info>  Retourne une adresse email formatée correctement selon la RFC2822,  ou <info>false</info> si une
                erreur survient.


id: imap_savebody
type: function
doc:
<comment>Description:</comment>
  Sauvegarde une partie spécifique du corps dans un fichier
  
  Sauvegarde une partie du corps du message spécifié.

<comment>Param:</comment>
  <info>IMAP\Connection</info>      <strong>$imap</strong>         Une instance de <class>IMAP\Connection</class>.
  <info>resource|string|int</info>  <strong>$file</strong>         Le chemin vers le fichier de sauvegarde, sous la forme d'une
                                     chaîne de caractères ou un descripteur de fichier valide
                                     retourné par la fonction <strong>fopen()</strong>.
  <info>int</info>                  <strong>$message_num</strong>  Le numéro du message
  <info>string</info>               <strong>$section</strong>      Le numéro de la section. C'est une chaîne de caractères
                                     d'entiers, délimités par une virgule qui correspondent à
                                     l'index dans la liste des sections du corps, tel que prévu par
                                     la spécification IMAP4.
  <info>int</info>                  <strong>$flags</strong>        Un masque qui contient une ou plusieurs des valeurs suivantes :
                                     <info>FT_UID</info> - Le numéro <strong>$message_num</strong> est un UID <info>FT_PEEK</info> - Ne pas
                                     définir le drapeau \Seen s'il n'est pas déjà défini <info>FT_INTERNAL</info>
                                     - La chaîne de caractères retournée est dans un format interne,
                                     qui ne correspondant pas à CRLF.
                                     
                                     <info>FT_UID</info> - Le numéro <strong>$message_num</strong> est un UID
                                     
                                     <info>FT_PEEK</info> - Ne pas définir le drapeau \Seen s'il n'est pas déjà
                                     défini
                                     
                                     <info>FT_INTERNAL</info> - La chaîne de caractères retournée est dans un
                                     format interne, qui ne correspondant pas à CRLF.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_fetchbody()</strong>


id: imap_scan
type: function
doc:
<comment>Description:</comment>
  Alias de imap_listscan
  
  Cette fonction est un alias de :  <strong>imap_listscan()</strong>.


id: imap_search
type: function
doc:
<comment>Description:</comment>
  Retourne un tableau de messages après recherche
  
  Effectue une recherche dans la boîte aux lettres courante, sur le flux IMAP courant.
  
  Par exemple, pour rechercher les messages non répondus, envoyés par maman, vous pouvez utiliser :
  "UNANSWERED FROM maman". Les recherches semblent insensibles à la casse. Cette liste de critères
  est issue du code d'un client C UW et peut être incomplète ou imprécise. (voir aussi la RFC1176,
  et en particulier, la section "tag SEARCH search_criteria").

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>      Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$criteria</strong>  Une chaîne de caractères, délimitée par des espaces, dans laquelle les
                              mots-clés suivants sont acceptés. Tous les arguments à plusieurs mots
                              (e.g.  <return>FROM "joey smith"</return>) doivent être placés entre guillemets. Les
                              résultats devront correspondre à toutes les entrées <strong>$criteria</strong>.  ALL -
                              retourne tous les messages qui vérifient le reste du critère.
                              ANSWERED - tous les messages avec le flag \\ANSWERED  BCC "string" -
                              tous les messages avec la chaîne "string" dans le champ Bcc  BEFORE
                              "date" - tous les messages avec Date : avant "date"  BODY "string" -
                              tous les messages avec "string" dans le corps  CC "string" - tous les
                              messages avec "string" dans le champ Cc  DELETED - tous les messages
                              effacés  FLAGGED - tous les messages avec le flag \\FLAGGED (parfois
                              interprété comme Important ou Urgent)  FROM "string" - tous les
                              messages avec la chaîne "string" dans le champ From  KEYWORD "string"
                              - tous les messages avec la chaîne "string" comme mot-clé  NEW - tous
                              les nouveaux messages  OLD - tous les anciens messages  ON "date" -
                              tous les messages avec la date "date" comme champ Date  RECENT - tous
                              les messages avec le flag \\RECENT  SEEN - tous les messages lus (avec
                              le flag\\SEEN flag)  SINCE "date" - tous les messages avec la date
                              Date: après "date"  SUBJECT "string" - tous les messages avec la
                              chaîne "string" dans le champ Subject  TEXT "string" - tous les
                              messages avec le texte "string"  TO "string" - tous les messages avec
                              la chaîne "string" dans le champ To  UNANSWERED - tous les messages
                              non répondus  UNDELETED - tous les messages non effacés  UNFLAGGED -
                              tous les messages non marqués  UNKEYWORD "string" - tous les messages
                              ne contenant pas le mot-clé "string"  UNSEEN - tous les messages non
                              lus
                              
                              ALL - retourne tous les messages qui vérifient le reste du critère.
                              
                              ANSWERED - tous les messages avec le flag \\ANSWERED
                              
                              BCC "string" - tous les messages avec la chaîne "string" dans le champ
                              Bcc
                              
                              BEFORE "date" - tous les messages avec Date : avant "date"
                              
                              BODY "string" - tous les messages avec "string" dans le corps
                              
                              CC "string" - tous les messages avec "string" dans le champ Cc
                              
                              DELETED - tous les messages effacés
                              
                              FLAGGED - tous les messages avec le flag \\FLAGGED (parfois interprété
                              comme Important ou Urgent)
                              
                              FROM "string" - tous les messages avec la chaîne "string" dans le
                              champ From
                              
                              KEYWORD "string" - tous les messages avec la chaîne "string" comme
                              mot-clé
                              
                              NEW - tous les nouveaux messages
                              
                              OLD - tous les anciens messages
                              
                              ON "date" - tous les messages avec la date "date" comme champ Date
                              
                              RECENT - tous les messages avec le flag \\RECENT
                              
                              SEEN - tous les messages lus (avec le flag\\SEEN flag)
                              
                              SINCE "date" - tous les messages avec la date Date: après "date"
                              
                              SUBJECT "string" - tous les messages avec la chaîne "string" dans le
                              champ Subject
                              
                              TEXT "string" - tous les messages avec le texte "string"
                              
                              TO "string" - tous les messages avec la chaîne "string" dans le champ
                              To
                              
                              UNANSWERED - tous les messages non répondus
                              
                              UNDELETED - tous les messages non effacés
                              
                              UNFLAGGED - tous les messages non marqués
                              
                              UNKEYWORD "string" - tous les messages ne contenant pas le mot-clé
                              "string"
                              
                              UNSEEN - tous les messages non lus
  <info>int</info>              <strong>$flags</strong>     Les valeurs pour <strong>$flags</strong> sont <info>SE_UID</info>, qui fait que le tableau réponse
                              contient les UID plutôt que les numéros de séquence.
  <info>string</info>           <strong>$charset</strong>   Jeu de caractères MIME à utiliser lors de la recherche de chaîne de
                              caractères.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau de numéro de messages ou d'UID.
               
               Retourne <info>false</info> si la recherche n'est pas comprise, ou bien qu'aucun message n'a été
               trouvé.

<comment>See Also:</comment>
   * <strong>imap_listscan()</strong>


id: imap_set_quota
type: function
doc:
<comment>Description:</comment>
  Modifie le quota d'une boîte aux lettres
  
  Modifie le quota de la boîte aux lettres <strong>$quota_root</strong>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>          Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$quota_root</strong>    La boîte aux lettres dont on doit modifier le quota. Elle doit
                                  suivre le format standard IMAP pour une boîte aux lettres :
                                  <return>user.name</return>.
  <info>int</info>              <strong>$mailbox_size</strong>  La taille maximale (en Ko) pour la boîte <strong>$quota_root</strong>

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_open()</strong>
   * <strong>imap_get_quota()</strong>


id: imap_setacl
type: function
doc:
<comment>Description:</comment>
  Modifie le ACL de la boîte aux lettres
  
  Définit l'ACL pour la boîte aux lettres donnée.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>     Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$mailbox</strong>  Le nom de la boîte aux lettres, voir la documentation de la fonction
                             <strong>imap_open()</strong> pour plus de détails
                             
                             Passer des données qui ne sont pas digne de confiance à ce paramètre
                             est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
  <info>string</info>           <strong>$user_id</strong>  L'identifiant de l'utilisateur dont on veut définir les droits.
  <info>string</info>           <strong>$rights</strong>   Les droits à donner à l'utilisateur. Le fait de passer une chaîne vide
                             effacera l'ACL.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_getacl()</strong>


id: imap_setflag_full
type: function
doc:
<comment>Description:</comment>
  Positionne un drapeau sur un message
  
  <strong>imap_setflag_full()</strong> affecte le <strong>$flag</strong> spécifié aux messages de la <strong>$sequence</strong> donnée.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>      Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$sequence</strong>  Une séquence de numéro de messages. Vous pouvez énumérer les messages
                              désirés avec la syntaxe <return>X,Y</return>, ou récupérer tous les messages d'un
                              intervalle avec la syntaxe <return>X:Y</return>
  <info>string</info>           <strong>$flag</strong>      Les flags que vous pouvez modifier sont <return>\Seen</return>, <return>\Answered</return>, <return>\Flagged</return>,
                              <return>\Deleted</return>, et <return>\Draft</return> (comme défini dans la RFC2060).
  <info>int</info>              <strong>$options</strong>   <strong>$options</strong> est un masque de bits, qui accepte uniquement la valeur
                              suivante : <info>ST_UID</info> - la séquence contient des UID au lieu de  numéros
                              de séquence.
                              
                              <info>ST_UID</info> - la séquence contient des UID au lieu de  numéros de séquence.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_clearflag_full()</strong>


id: imap_sort
type: function
doc:
<comment>Description:</comment>
  Trie des messages
  
  Récupère et trie les numéros de messages en fonction des paramètres donnés.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>             Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$criteria</strong>         Les critères <strong>$criteria</strong> peuvent être un (et un seul) parmi les
                                     suivants : <info>SORTDATE</info> : date du message <info>SORTARRIVAL</info> : date
                                     d'arrivée <info>SORTFROM</info> : nom de la première boîte aux lettres de
                                     l'adresse d'origine (From address) <info>SORTSUBJECT</info> : sujet du
                                     message <info>SORTTO</info> : nom de la première boîte aux lettres de
                                     destination (To address) <info>SORTCC</info> : nom de la boîte aux lettres
                                     de  copie cachée (cc address) <info>SORTSIZE</info> : taille du message en
                                     octets
                                     
                                     <info>SORTDATE</info> : date du message
                                     
                                     <info>SORTARRIVAL</info> : date d'arrivée
                                     
                                     <info>SORTFROM</info> : nom de la première boîte aux lettres de l'adresse
                                     d'origine (From address)
                                     
                                     <info>SORTSUBJECT</info> : sujet du message
                                     
                                     <info>SORTTO</info> : nom de la première boîte aux lettres de destination
                                     (To address)
                                     
                                     <info>SORTCC</info> : nom de la boîte aux lettres de  copie cachée (cc
                                     address)
                                     
                                     <info>SORTSIZE</info> : taille du message en octets
  <info>bool</info>             <strong>$reverse</strong>          S'il faut trier en ordre inverse.
  <info>int</info>              <strong>$flags</strong>            Les <strong>$flags</strong> dont des masques de bits, d'un ou plusieurs des
                                     éléments suivants : <info>SE_UID</info> : retourne des UID à la place de
                                     numéros <info>SE_NOPREFETCH</info> : ne pas prétélécharger les messages
                                     trouvés
                                     
                                     <info>SE_UID</info> : retourne des UID à la place de numéros
                                     
                                     <info>SE_NOPREFETCH</info> : ne pas prétélécharger les messages trouvés
  <info>string|null</info>      <strong>$search_criteria</strong>  Critères de recherche IMAP2-format. Pour plus de détails voir
                                     <strong>imap_search()</strong>.
  <info>string|null</info>      <strong>$charset</strong>          Jeu de caractères MIME à utiliser lors de la recherche de
                                     chaîne de caractères.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau de numéros de messages triés en fonction des paramètres fournis,
               ou <info>false</info> si une erreur survient.


id: imap_status
type: function
doc:
<comment>Description:</comment>
  Retourne les informations de statut sur une boîte aux lettres
  
  Retourne les informations de statut sur la boîte aux lettres <strong>$mailbox</strong>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>     Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$mailbox</strong>  Le nom de la boîte aux lettres, voir la documentation de la fonction
                             <strong>imap_open()</strong> pour plus de détails
                             
                             Passer des données qui ne sont pas digne de confiance à ce paramètre
                             est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.
  <info>int</info>              <strong>$flags</strong>    Les drapeaux valides sont : <info>SA_MESSAGES</info> - met la valeur de
                             $status-&gt;messages au nombre de messages dans la boîte aux lettres.
                             <info>SA_RECENT</info> - met la valeur de $status-&gt;recent au nombre de messages
                             récents dans la boîte aux lettres. <info>SA_UNSEEN</info> - met la valeur de
                             $status-&gt;unseen au nombre de messages non lus dans la boîte aux
                             lettres. <info>SA_UIDNEXT</info> - met la valeur de $status-&gt;uidnext à la
                             prochaine valeur d'uid qui sera utilisée. <info>SA_UIDVALIDITY</info> - met la
                             valeur de  $status-&gt;uidvalidity à une constante, qui change lorsque
                             l'uid de la boîte aux lettres n'est plus valide. <info>SA_ALL</info> - fixe toutes
                             les valeurs précédentes.
                             
                             <info>SA_MESSAGES</info> - met la valeur de $status-&gt;messages au nombre de
                             messages dans la boîte aux lettres.
                             
                             <info>SA_RECENT</info> - met la valeur de $status-&gt;recent au nombre de messages
                             récents dans la boîte aux lettres.
                             
                             <info>SA_UNSEEN</info> - met la valeur de $status-&gt;unseen au nombre de messages
                             non lus dans la boîte aux lettres.
                             
                             <info>SA_UIDNEXT</info> - met la valeur de $status-&gt;uidnext à la prochaine valeur
                             d'uid qui sera utilisée.
                             
                             <info>SA_UIDVALIDITY</info> - met la valeur de  $status-&gt;uidvalidity à une
                             constante, qui change lorsque l'uid de la boîte aux lettres n'est plus
                             valide.
                             
                             <info>SA_ALL</info> - fixe toutes les valeurs précédentes.

<comment>Return:</comment>
  <info>stdClass|false</info>  Cette fonction retourne un objet contenant les informations sur le statut,  ou
                  <info>false</info> si une erreur survient. L'objet a les propriétés suivantes : <return>messages</return>,
                  <return>recent</return>, <return>unseen</return>, <return>uidnext</return>, et <return>uidvalidity</return>.
                  
                  <return>flags</return> est également défini, qui contient un masque contenant une des constantes
                  ci-dessus.


id: imap_subscribe
type: function
doc:
<comment>Description:</comment>
  Souscrit à une boîte aux lettres
  
  Souscrit à une boîte aux lettres.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>     Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$mailbox</strong>  Le nom de la boîte aux lettres, voir la documentation de la fonction
                             <strong>imap_open()</strong> pour plus de détails
                             
                             Passer des données qui ne sont pas digne de confiance à ce paramètre
                             est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_unsubscribe()</strong>


id: imap_thread
type: function
doc:
<comment>Description:</comment>
  Retourne l'arbre des messages organisés par thread
  
  Retourne l'arbre des messages organisés par thread.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>   Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$flags</strong>  

<comment>Return:</comment>
  <info>array|false</info>  <strong>imap_thread()</strong> retourne un tableau associatif contenant un arbre de messages organisés
               par thread par <return>REFERENCES</return> ou <info>false</info> en cas d'erreur.
               
               Chaque message dans la boîte aux lettres courante sera représenté par des entrées
               sous forme d'arbre dans le tableau résultant : $thread["XX.num"] - numéro du message
               courant $thread["XX.next"]$thread["XX.branch"]
               
               $thread["XX.num"] - numéro du message courant
               
               $thread["XX.next"]
               
               $thread["XX.branch"]


id: imap_timeout
type: function
doc:
<comment>Description:</comment>
  Configure ou retourne le timeout
  
  Définit ou retourne le timeout imap.

<comment>Param:</comment>
  <info>int</info>  <strong>$timeout_type</strong>  Une valeur parmi les suivantes : <info>IMAP_OPENTIMEOUT</info>, <info>IMAP_READTIMEOUT</info>,
                      <info>IMAP_WRITETIMEOUT</info>, ou <info>IMAP_CLOSETIMEOUT</info>.
  <info>int</info>  <strong>$timeout</strong>       Le timeout, en secondes.

<comment>Return:</comment>
  <info>int|bool</info>  Si le paramètre <strong>$timeout</strong> est défini, cette fonction retourne <info>true</info> en cas de succès et
            <info>false</info> si une erreur survient.
            
            Si <strong>$timeout</strong> n'est pas fourni ou s'il est évalué à -1, le timeout courant sera retourné
            sous la forme d'un entier.


id: imap_uid
type: function
doc:
<comment>Description:</comment>
  Retourne l'UID d'un message
  
  <strong>imap_uid()</strong> retourne l'UID pour le message <strong>$msgno</strong>. Un UID est un identifiant unique que ne change
  jamais, alors que le numéro du message dans la liste des messages peut changer à toute
  modification de la boîte aux lettres.
  
  C'est la fonction inverse de <strong>imap_msgno()</strong>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>         Une instance de <class>IMAP\Connection</class>.
  <info>int</info>              <strong>$message_num</strong>  Le numéro du message.

<comment>Return:</comment>
  <info>int|false</info>  L'UID d'un message donné.

<comment>See Also:</comment>
   * <strong>imap_msgno()</strong>


id: imap_undelete
type: function
doc:
<comment>Description:</comment>
  Enlève la marque d'effacement d'un message
  
  Enlève la marque d'effacement du message <strong>$message_nums</strong>, placée avec <strong>imap_delete()</strong> ou
  <strong>imap_mail_move()</strong>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>          Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$message_nums</strong>  Une chaîne de caractères représentant un ou plusieurs messages
                                  dans un style de format d'une séquence IMAP4 (<return>"n"</return>, <return>"n:m"</return>, ou une
                                  combinaison de ceci, délimité par des virgules).
  <info>int</info>              <strong>$flags</strong>         

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_delete()</strong>
   * <strong>imap_mail_move()</strong>


id: imap_unsubscribe
type: function
doc:
<comment>Description:</comment>
  Termine la souscription à une boîte aux lettres
  
  Termine la souscription à la boîte aux lettres <strong>$mailbox</strong>.

<comment>Param:</comment>
  <info>IMAP\Connection</info>  <strong>$imap</strong>     Une instance de <class>IMAP\Connection</class>.
  <info>string</info>           <strong>$mailbox</strong>  Le nom de la boîte aux lettres, voir la documentation de la fonction
                             <strong>imap_open()</strong> pour plus de détails.
                             
                             Passer des données qui ne sont pas digne de confiance à ce paramètre
                             est dangereux, sauf si, imap.enable_insecure_rsh est désactivé.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_subscribe()</strong>


id: imap_utf7_decode
type: function
doc:
<comment>Description:</comment>
  Décode une chaîne encodée en UTF-7 modifié
  
  <strong>imap_utf7_decode()</strong> décode la chaîne UTF-7 <strong>$string</strong> en ISO-8859-1.
  
  Cette fonction sert à encoder les noms de boîtes aux lettres qui contiennent des caractères
  internationaux hors de l'espace ASCII.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  L'encodage UTF-7 modifié est défini dans la RFC 2060, section 5.1.3.

<comment>Return:</comment>
  <info>string|false</info>  Retourne une chaîne de caractères encodée ISO-8859-1 et contenant la même séquence
                de caractères que dans le paramètre <strong>$string</strong>, ou <info>false</info> si <strong>$string</strong> contient une
                séquence UTF-7 modifiée invalide ou si <strong>$string</strong> contient un caractère qui ne fait pas
                partie du jeu de caractères ISO-8859-1.

<comment>See Also:</comment>
   * <strong>imap_utf7_encode()</strong>


id: imap_utf7_encode
type: function
doc:
<comment>Description:</comment>
  Convertit une chaîne ISO-8859-1 en texte UTF-7 modifié
  
  Convertit une chaîne <strong>$string</strong> ISO-8859-1 en texte UTF-7 modifié.
  
  Cette fonction sert à encoder les noms de boîtes aux lettres qui contiennent des caractères
  internationaux hors de l'espace ASCII.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Une chaîne de caractères ISO-8859-1.

<comment>Return:</comment>
  <info>string</info>  Retourne les données <strong>$string</strong> encodées avec l'encodage UTF-7 modifié tel que défini dans la
          RFC 2060, section 5.1.3.

<comment>See Also:</comment>
   * <strong>imap_utf7_decode()</strong>


id: imap_utf8
type: function
doc:
<comment>Description:</comment>
  Convertit du texte au format MIME en UTF-8
  
  Convertit le texte <strong>$mime_encoded_text</strong> en UTF-8, si le jeu de caractères déclaré est connu de
  libc-client. Sinon, le texte founi sera décodé, mais pas converti en UTF-8.

<comment>Param:</comment>
  <info>string</info>  <strong>$mime_encoded_text</strong>  Une chaîne de caractères encodé MIME. Les spécifications de MIME et
                              UTF8 sont décrites dans les RFC2047 et RFC2044.

<comment>Return:</comment>
  <info>string</info>  Retourne la chaîne de caractères décodé et si possible, converti en UTF-8.

<comment>See Also:</comment>
   * <strong>imap_mime_header_decode()</strong>


id: imap_utf8_to_mutf7
type: function
doc:
<comment>Description:</comment>
  Encode une chaîne de caractère UTF-8 en UTF-7 modifié
  
  Encode une chaîne de caractères UTF-8 en UTF-7 modifié (comme spécifié dans la RFC 2060, section
  5.1.3).
  
  Cette fonction est seulement disponible, si libcclient exporte utf8_to_mutf7().

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  Une chaîne de caractères encodé en UTF-8.

<comment>Return:</comment>
  <info>string|false</info>  Retourne <strong>$string</strong> converti en UTF-7 modifié, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>imap_mutf7_to_utf8()</strong>


id: implode
type: function
doc:
<comment>Description:</comment>
  Rassemble les éléments d'un tableau en une chaîne
  
  Signature alternative (non supportée avec les arguments nommés) :
  
  Signature antérieure (obsolète à partir de PHP 7.4.0, retirée à partir de PHP 8.0.0) :
  
  Rassemble les éléments d'un tableau en une chaîne.

<comment>Param:</comment>
  <info>string</info>  <strong>$separator</strong>  Optionnel. Par défaut, une chaîne vide.
  <info>array</info>   <strong>$array</strong>      Le tableau de chaînes à rassembler.

<comment>Return:</comment>
  <info>string</info>  Retourne une chaîne contenant la représentation en chaîne de caractères de tous les
          éléments du tableau <strong>$array</strong>, dans le même ordre, avec la chaîne <strong>$separator</strong>, placée entre
          deux éléments.

<comment>See Also:</comment>
   * <strong>explode()</strong>
   * <strong>preg_split()</strong>
   * <strong>http_build_query()</strong>


id: in_array
type: function
doc:
<comment>Description:</comment>
  Indique si une valeur appartient à un tableau
  
  Recherche <strong>$needle</strong> dans <strong>$haystack</strong> en utilisant une comparaison souple à moins que <strong>$strict</strong> ne soit
  utilisé.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$needle</strong>    La valeur recherchée.
                    
                    Si <strong>$needle</strong> est une chaîne de caractères, la comparaison est faite en tenant
                    compte de la casse.
  <info>array</info>  <strong>$haystack</strong>  Le tableau.
  <info>bool</info>   <strong>$strict</strong>    Si le troisième paramètre <strong>$strict</strong> est définit à <info>true</info> alors la fonction
                    <strong>in_array()</strong> vérifiera aussi que le type du paramètre <strong>$needle</strong> correspond au type
                    de la valeur trouvée dans <strong>$haystack</strong>.
                    
                    Avant PHP 8.0.0, un <return>string</return> <strong>$needle</strong> correspondra à une valeur de tableau de <return>0</return> en
                    mode non strict et vice versa. Cela peut conduire à des résultats non
                    souhaitables. Des cas particuliers similaires existent également pour d'autres
                    types. Si vous n'êtes pas absolument certain des types de valeurs concernés,
                    utilisez toujours le drapeau <strong>$strict</strong> pour éviter tout comportement inattendu.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$needle</strong> est trouvé dans le tableau, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>array_search()</strong>
   * <strong>isset()</strong>
   * <strong>array_key_exists()</strong>


id: inet_ntop
type: function
doc:
<comment>Description:</comment>
  Convertit un paquet d'adresses internet en une représentation humainement lisible
  
  Convertit une adresse 32 bit IPv4 ou 128 bit IPv6 (si PHP a été compilé avec le support IPv6) en
  une chaîne représentant une famille d'adresses.

<comment>Param:</comment>
  <info>string</info>  <strong>$ip</strong>  Une adresse 32 bit IPv4, ou 128 bit IPv6.

<comment>Return:</comment>
  <info>string|false</info>  Retourne une représentation de l'adresse, sous la forme d'une chaîne de caractères
                ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>long2ip()</strong>
   * <strong>ip2long()</strong>
   * <strong>inet_pton()</strong>


id: inet_pton
type: function
doc:
<comment>Description:</comment>
  Convertit une adresse IP lisible en sa représentation in_addr
  
  Convertit une adresse IPv4 ou IPv6 (si PHP a été compilé avec le support IPv6) humainement lisible
  en une structure binaire appropriée de famille d'adresses 32 bit ou 128 bit.

<comment>Param:</comment>
  <info>string</info>  <strong>$ip</strong>  Une adresse IPv4 ou IPv6.

<comment>Return:</comment>
  <info>string|false</info>  Retourne la représentation <return>in_addr</return> de l'adresse fournie par le paramètre <strong>$ip</strong> ou
                <info>false</info> si le paramètre <strong>$ip</strong> fourni a une synthaxe invalide (par exemple, une adresse
                IPv4 sans point, ou une adresse IPv6 sans virgule).

<comment>See Also:</comment>
   * <strong>ip2long()</strong>
   * <strong>long2ip()</strong>
   * <strong>inet_ntop()</strong>


id: inflate_add
type: function
doc:
<comment>Description:</comment>
  Incrementally inflate encoded data
  
  Incrementally inflates encoded data in the specified <strong>$context</strong>.
  
  Limitation: header information from GZIP compressed data are not made available.

<comment>Param:</comment>
  <info>InflateContext</info>  <strong>$context</strong>     A context created with <strong>inflate_init()</strong>.
  <info>string</info>          <strong>$data</strong>        A chunk of compressed data.
  <info>int</info>             <strong>$flush_mode</strong>  One of <info>ZLIB_BLOCK</info>, <info>ZLIB_NO_FLUSH</info>, <info>ZLIB_PARTIAL_FLUSH</info>, <info>ZLIB_SYNC_FLUSH</info>
                               (default), <info>ZLIB_FULL_FLUSH</info>, <info>ZLIB_FINISH</info>. Normally you will want to
                               set <info>ZLIB_NO_FLUSH</info> to maximize compression, and <info>ZLIB_FINISH</info> to
                               terminate with the last chunk of data. See the zlib manual for a
                               detailed description of these constants.

<comment>Return:</comment>
  <info>string|false</info>  Returns a chunk of uncompressed data,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>inflate_init()</strong>


id: inflate_get_read_len
type: function
doc:
<comment>Description:</comment>
  Get number of bytes read so far
  
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Param:</comment>
  <info>InflateContext</info>  <strong>$context</strong>  

<comment>Return:</comment>
  <info>int</info>  Returns number of bytes read so far ou <info>false</info> si une erreur survient.


id: inflate_get_status
type: function
doc:
<comment>Description:</comment>
  Get decompression status
  
  Usually returns either <info>ZLIB_OK</info> or <info>ZLIB_STREAM_END</info>.

<comment>Param:</comment>
  <info>InflateContext</info>  <strong>$context</strong>  

<comment>Return:</comment>
  <info>int</info>  Returns decompression status.


id: inflate_init
type: function
doc:
<comment>Description:</comment>
  Initialize an incremental inflate context
  
  Initialize an incremental inflate context with the specified <strong>$encoding</strong>.

<comment>Param:</comment>
  <info>int</info>    <strong>$encoding</strong>  One of the <info>ZLIB_ENCODING_*</info> constants.
  <info>array</info>  <strong>$options</strong>   An associative array which may contain the following elements: level The
                    compression level in range -1..9; defaults to -1. memory The compression memory
                    level in range 1..9; defaults to 8. window The zlib window size (logarithmic) in
                    range 8..15; defaults to 15. strategy One of <info>ZLIB_FILTERED</info>, <info>ZLIB_HUFFMAN_ONLY</info>,
                    <info>ZLIB_RLE</info>, <info>ZLIB_FIXED</info> or <info>ZLIB_DEFAULT_STRATEGY</info> (the default). dictionary A <info>string</info>
                    or an <info>array</info> of <info>strings</info> of the preset dictionary (default: no preset dictionary).
                    
                    The compression level in range -1..9; defaults to -1.
                    
                    The compression memory level in range 1..9; defaults to 8.
                    
                    The zlib window size (logarithmic) in range 8..15; defaults to 15.
                    
                    One of <info>ZLIB_FILTERED</info>, <info>ZLIB_HUFFMAN_ONLY</info>, <info>ZLIB_RLE</info>, <info>ZLIB_FIXED</info> or
                    <info>ZLIB_DEFAULT_STRATEGY</info> (the default).
                    
                    A <info>string</info> or an <info>array</info> of <info>strings</info> of the preset dictionary (default: no preset
                    dictionary).

<comment>Return:</comment>
  <info>InflateContext|false</info>  Returns an inflate context resource (<return>zlib.inflate</return>) on success,  ou <info>false</info> si
                        une erreur survient.

<comment>See Also:</comment>
   * <strong>inflate_add()</strong>
   * <strong>deflate_init()</strong>


id: ini_alter
type: function
doc:
<comment>Description:</comment>
  Alias de ini_set
  
  Cette fonction est un alias de :  <strong>ini_set()</strong>.


id: ini_get
type: function
doc:
<comment>Description:</comment>
  Lit la valeur d'une option de configuration
  
  Retourne la valeur de l'option de configuration <strong>$varname</strong> en cas de succès.

<comment>Param:</comment>
  <info>string</info>  <strong>$option</strong>  Le nom de l'option de configuration.

<comment>Return:</comment>
  <info>string|false</info>  Retourne la valeur de l'option de configuration <strong>$varname</strong> en cas de succès, ou une
                chaîne de caractères vide pour les valeurs <info>null</info>. Retourne <info>false</info> si l'option de
                configuration n'existe pas.

<comment>See Also:</comment>
   * <strong>get_cfg_var()</strong>
   * <strong>ini_get_all()</strong>
   * <strong>ini_restore()</strong>
   * <strong>ini_set()</strong>


id: ini_get_all
type: function
doc:
<comment>Description:</comment>
  Lit toutes les valeurs de configuration
  
  Retourne toutes les valeurs de configuration.

<comment>Param:</comment>
  <info>string|null</info>  <strong>$extension</strong>  Un nom d'extension, optionnel. Si non-<info>null</info> ou différent de la chaîne de
                           caractères <return>core</return>, cette fonction retournera uniquement les options
                           spécifiques à cette extension.
  <info>bool</info>         <strong>$details</strong>    Récupère les détails, ou uniquement la valeur courante de chaque
                           configuration. Par défaut, vaut <info>true</info> (récupère les détails).

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau associatif dont les clés sont les noms des directives. Retourne
               <info>false</info> et lève une erreur de niveau <info>E_WARNING</info> si l'<strong>$extension</strong> n'existe pas.
               
               Lorsque le paramètre <strong>$details</strong> vaut <info>true</info> (défaut), le tableau contiendra les valeurs
               <return>global_value</return> (définies dans le fichier php.ini), <return>local_value</return> (définie éventuellement
               avec la fonction <strong>ini_set()</strong> ou via un .htaccess), et <return>access</return> (le degré d'accès).
               
               Lorsque le paramètre <strong>$details</strong> vaut <info>false</info>, la valeur sera la valeur courant de
               l'option.
               
               Voir le manuel pour plus d'informations sur la signification du degré d'accès.
               
               Il est possible pour une directive d'avoir plusieurs degrés d'accès, et c'est la
               raison pour laquelle <return>access</return> montre les valeurs du masque appropriées.

<comment>See Also:</comment>
   * 
   * <strong>ini_get()</strong>
   * <strong>ini_restore()</strong>
   * <strong>ini_set()</strong>
   * <strong>get_loaded_extensions()</strong>
   * <strong>phpinfo()</strong>
   * ReflectionExtension::getINIEntries


id: ini_parse_quantity
type: function
doc:
<comment>Description:</comment>
  Get interpreted size from ini shorthand syntax
  
  Returns the interpreted size in bytes on success from an ini shorthand.

<comment>Param:</comment>
  <info>string</info>  <strong>$shorthand</strong>  Ini shorthand to parse, must be a number followed by an optional multiplier.
                       The following multipliers are supported: <return>k</return>/<return>K</return> (<return>1024</return>), <return>m</return>/<return>M</return> (<return>1048576</return>), <return>g</return>/<return>G</return>
                      (<return>1073741824</return>).
                       The number can be a decimal, hex (prefixed with <return>0x</return> or <return>0X</return>), octal (prefixed
                      with <return>0o</return>, <return>0O</return> or <return>0</return>) or binary (prefixed with <return>0b</return> or <return>0B</return>)

<comment>Return:</comment>
  <info>int</info>  Returns the interpreted size in bytes as an entier.

<comment>See Also:</comment>
   * <strong>ini_get()</strong>


id: ini_restore
type: function
doc:
<comment>Description:</comment>
  Restaure la valeur de l'option de configuration
  
  Restaure la valeur originale de l'option de configuration <strong>$varname</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$option</strong>  Le nom de l'option de configuration.

<comment>Return:</comment>
  <info>void</info>  Aucune valeur n'est retournée.

<comment>See Also:</comment>
   * <strong>ini_get()</strong>
   * <strong>ini_get_all()</strong>
   * <strong>ini_set()</strong>


id: ini_set
type: function
doc:
<comment>Description:</comment>
  Modifie la valeur d'une option de configuration
  
  Change la valeur de l'option de configuration <strong>$varname</strong> et lui donne celle de  <strong>$newvalue</strong>. La valeur
  de l'option de configuration sera modifiée durant toute l'exécution du script et pour ce script
  spécifiquement. Elle reprendra sa valeur par défaut dès la fin du script.

<comment>Param:</comment>
  <info>string</info>                      <strong>$option</strong>  Les options disponibles ne peuvent pas toutes être  modifiées
                                       avec <strong>ini_set()</strong>. La liste de toutes les options disponibles se
                                       trouve dans l'annexe.
  <info>string|int|float|bool|null</info>  <strong>$value</strong>   La nouvelle valeur pour l'option.

<comment>Return:</comment>
  <info>string|false</info>  Retourne l'ancienne valeur en cas de succès, <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>get_cfg_var()</strong>
   * <strong>ini_get()</strong>
   * <strong>ini_get_all()</strong>
   * <strong>ini_restore()</strong>
   * Comment modifier la configuration


id: inotify_add_watch
type: function
doc:
<comment>Description:</comment>
  Ajoute un point de surveillance à une instance inotify
  
  <strong>inotify_add_watch()</strong> ajoute un point de surveillance  à une instance inotify ou modifie un point de
  surveillance en cours vers un nouveau fichier ou dossier spécifié par le chemin  <strong>$pathname</strong>.
  
  Utiliser <strong>inotify_add_watch()</strong> sur un objet déjà en surveillance modifie la configuration. Utiliser
  la constante <info>IN_MASK_ADD</info>  ajoute les événements (OR logique).

<comment>Param:</comment>
  <info>resource</info>  <strong>$inotify_instance</strong>  Ressource returnée par
                               <strong>inotify_init()</strong>
  <info>string</info>    <strong>$pathname</strong>          Fichier ou dossier à surveiller.
  <info>int</info>       <strong>$mask</strong>              Événements à surveiller. Voyez  Constantes pré-définies.

<comment>Return:</comment>
  <info>int</info>  La valeur retournée est un pointeur inotify unique (inotify instance wide).

<comment>See Also:</comment>
   * <strong>inotify_init()</strong>


id: inotify_init
type: function
doc:
<comment>Description:</comment>
  Initialise une instance inotify
  
  Initialise une instance inotify pour utiliser avec la fonction <strong>inotify_add_watch()</strong>

<comment>Return:</comment>
  <info>resource</info>  Un flux ou <info>false</info> en cas d'erreur.

<comment>See Also:</comment>
   * <strong>inotify_add_watch()</strong>
   * <strong>inotify_rm_watch()</strong>
   * <strong>inotify_queue_len()</strong>
   * <strong>inotify_read()</strong>
   * <strong>fclose()</strong>


id: inotify_queue_len
type: function
doc:
<comment>Description:</comment>
  Retourne le nombre d'événements qui sont survenus
  
  Cette fonction permet de savoir si <strong>inotify_read()</strong> va bloquer ou non. Si un nombre supérieur à 0
  est retourné, il y a des événements en attente, et  <strong>inotify_read()</strong> ne va pas bloquer.

<comment>Param:</comment>
  <info>resource</info>  <strong>$inotify_instance</strong>  Ressource returnée par
                               <strong>inotify_init()</strong>

<comment>Return:</comment>
  <info>int</info>  Retourne le nombre d'événements qui sont survenus.

<comment>See Also:</comment>
   * <strong>inotify_init()</strong>
   * <strong>stream_select()</strong>
   * <strong>stream_set_blocking()</strong>


id: inotify_read
type: function
doc:
<comment>Description:</comment>
  Lit les événements dans une instance inotify
  
  Lit les événements dans une instance inotify.

<comment>Param:</comment>
  <info>resource</info>  <strong>$inotify_instance</strong>  Ressource returnée par
                               <strong>inotify_init()</strong>

<comment>Return:</comment>
  <info>array</info>  Un tableau d'événements inotify ou <info>false</info> si aucun événement n'était dans la liste, et que
         <strong>$inotify_instance</strong> était non-bloquant. Chaque événement dans le tableau dispose des index
         suivants :  wd, le pointeur retourné par la fonction <strong>inotify_add_watch()</strong>mask est un champ
         de bits de constantes inotifycookie est un identifiant unique pour relier des événements
         communs (e.g. <info>IN_MOVE_FROM</info> and <info>IN_MOVE_TO</info>)name est le nom du fichier (e.g. si un fichier a
         été modifié dans le dossier de surveillance)

<comment>See Also:</comment>
   * <strong>inotify_init()</strong>
   * <strong>stream_select()</strong>
   * <strong>stream_set_blocking()</strong>
   * <strong>inotify_queue_len()</strong>


id: inotify_rm_watch
type: function
doc:
<comment>Description:</comment>
  Supprime un point de surveillance d'une instance inotify
  
  <strong>inotify_rm_watch()</strong> retire le point de surveillance <strong>$watch_descriptor</strong> de l'instance inotify
  <strong>$inotify_instance</strong>.

<comment>Param:</comment>
  <info>resource</info>  <strong>$inotify_instance</strong>  Ressource returnée par
                               <strong>inotify_init()</strong>
  <info>int</info>       <strong>$watch_descriptor</strong>  Point de surveillance à retirer

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>inotify_init()</strong>


id: intdiv
type: function
doc:
<comment>Description:</comment>
  Division d'Entier
  
  Retourne le quotient entier de la division de <strong>$num1</strong> par <strong>$num2</strong>.

<comment>Param:</comment>
  <info>int</info>  <strong>$num1</strong>  Nombre à diviser.
  <info>int</info>  <strong>$num2</strong>  Nombre qui divise <strong>$num1</strong>.

<comment>Return:</comment>
  <info>int</info>  Le quotient entier de la division de <strong>$num1</strong> par <strong>$num2</strong>.

<comment>See Also:</comment>
   * <return>/</return> - Division de nombre flotant
   * <return>%</return> - Modulo entier
   * <strong>fmod()</strong> - Modulo de nombre flotant


id: interface_exists
type: function
doc:
<comment>Description:</comment>
  Vérifie si une interface a été définie
  
  Vérifie si une interface a été définie.

<comment>Param:</comment>
  <info>string</info>  <strong>$interface</strong>  Le nom de l'interface
  <info>bool</info>    <strong>$autoload</strong>   Si l'on doit appeler autoload ou non par défaut.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si l'interface fournie par le paramètre <strong>$interface</strong> a été définie, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>get_declared_interfaces()</strong>
   * <strong>class_implements()</strong>
   * <strong>class_exists()</strong>
   * <strong>enum_exists()</strong>


id: intl_error_name
type: function
doc:
<comment>Description:</comment>
  Lit le nom symbolique d'un code d'erreur donné
  
  Retourne le nom du code d'erreur ICU.

<comment>Param:</comment>
  <info>int</info>  <strong>$errorCode</strong>  Le code d'erreur ICU.

<comment>Return:</comment>
  <info>string</info>  La chaîne retournée sera celui du nom de la constante équivalente.

<comment>See Also:</comment>
   * <strong>intl_is_failure()</strong>
   * <strong>intl_get_error_code()</strong>
   * <strong>intl_get_error_message()</strong>


id: intl_get_error_code
type: function
doc:
<comment>Description:</comment>
  Lit le dernier code d'erreur
  
  Pratique pour gérer les erreurs qui surviennent dans les méthodes statiques quand il n'y a pas
  d'objet dont on peut obtenir le message d'erreur.

<comment>Return:</comment>
  <info>int</info>  Le code d'erreur retourné par le dernier appel à l'API.

<comment>See Also:</comment>
   * <strong>intl_is_failure()</strong>
   * <strong>intl_error_name()</strong>
   * <strong>intl_get_error_message()</strong>
   * <strong>collator_get_error_code()</strong>
   * <strong>numfmt_get_error_code()</strong>


id: intl_get_error_message
type: function
doc:
<comment>Description:</comment>
  Lit la description de la dernière erreur
  
  Lit le message d'erreur de la dernière fonction d'internationalisation appelée.

<comment>Return:</comment>
  <info>string</info>  La description de l'erreur qui est survenue durant le dernier appel de l'API.

<comment>See Also:</comment>
   * <strong>intl_error_name()</strong>
   * <strong>intl_get_error_code()</strong>
   * <strong>intl_is_failure()</strong>
   * <strong>collator_get_error_message()</strong>
   * <strong>numfmt_get_error_message()</strong>


id: intl_is_failure
type: function
doc:
<comment>Description:</comment>
  Vérifie si un code d'erreur indique un échec
  
  

<comment>Param:</comment>
  <info>int</info>  <strong>$errorCode</strong>  une valeur retournée par une des fonctions  <strong>intl_get_error_code()</strong>,
                   <strong>collator_get_error_code()</strong> .

<comment>Return:</comment>
  <info>bool</info>  <info>true</info> si le code indique un échec, et <info>false</info> dans le cas d'une réussite ou d'une alerte.

<comment>See Also:</comment>
   * <strong>intl_get_error_code()</strong>
   * <strong>collator_get_error_code()</strong>
   * <strong>Collator-getErrorCode()</strong>


id: intval
type: function
doc:
<comment>Description:</comment>
  Retourne la valeur numérique entière équivalente d'une variable
    
  
  Retourne la valeur entier de <strong>$value</strong> en utilisant la <strong>$base</strong> fourni pour la conversion (par défaut en
  base 10). <strong>intval()</strong> ne devrait pas être utilisée sur des objets, dans ces cas, une erreur de niveau
  <info>E_WARNING</info> sera émise et la fonction retournera 1.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La valeur scalaire à être convertie en entier
  <info>int</info>    <strong>$base</strong>   La base pour la conversion
                 
                 Si <strong>$base</strong> vaut 0, la base utilisée est déterminée par le format du paramètre <strong>$value</strong>
                 :  si la chaîne inclue un préfixe "0x" (ou "0X"), la base prise sera 16 (hex) ;
                 sinon,  si la chaîne commence par "0b" (ou "0B"), la base prise sera 2 (binaire);
                 sinon,  si la chaîne commence par "0", la base prise sera 8 (octal); sinon,  la
                 base prise sera 10 (décimal).
                 
                 si la chaîne inclue un préfixe "0x" (ou "0X"), la base prise sera 16 (hex) ; sinon,
                 
                 si la chaîne commence par "0b" (ou "0B"), la base prise sera 2 (binaire); sinon,
                 
                 si la chaîne commence par "0", la base prise sera 8 (octal); sinon,
                 
                 la base prise sera 10 (décimal).

<comment>Return:</comment>
  <info>int</info>  Une valeur de type entier de <strong>$value</strong> en cas de succès ou 0 en cas d'échec. Les tableaux vides
       retournent 0, les tableaux non vides retournent 1.
       
       La valeur maximale dépend du système. Les systèmes à 32 bits ont une valeur entière signée
       maximale de -2147483648 à 2147483647. Alors, par exemple, sur un système semblable,
       <return>intval('1000000000000')</return> retournera 2147483647. La valeur entière signée maximale pour un
       système à 64 bits est  9223372036854775807.
       
       Les chaînes de caractères retournent la plupart du temps 0, cela dépend des caractères à
       l'extrême gauche de la chaîne. La règle courante du  transtypage d'entier  s'applique.

<comment>See Also:</comment>
   * <strong>boolval()</strong>
   * <strong>floatval()</strong>
   * <strong>strval()</strong>
   * <strong>settype()</strong>
   * <strong>is_numeric()</strong>
   * Définition du type
   * Nombres de grande taille BCMath


id: ip2long
type: function
doc:
<comment>Description:</comment>
  Convertit une chaîne contenant une adresse (IPv4) en notation décimale à point en une adresse
  entier
  long
  
  La fonction <strong>ip2long()</strong> génère une représentation en entier long d'une adresse IPv4 depuis son
  format standard (notation décimale à point)
  
  <strong>ip2long()</strong> fonctionne également avec des adresses IP incomplètes. Lire
  http://ps-2.kev009.com/wisclibrary/aix52/usr/share/man/info/en_US/a_doc_lib/libs/commtrf2/inet_addr.htm
  pour plus d'informations.

<comment>Param:</comment>
  <info>string</info>  <strong>$ip</strong>  Une adresse au format standard.

<comment>Return:</comment>
  <info>int|false</info>  Retourne l'entier long, ou <info>false</info> si <strong>$ip</strong> est invalide.

<comment>See Also:</comment>
   * <strong>long2ip()</strong>
   * <strong>sprintf()</strong>


id: iptcembed
type: function
doc:
<comment>Description:</comment>
  Intègre des données binaires IPTC dans une image JPEG
  
  <strong>iptcembed()</strong> intègre des données binaires IPTC dans une image JPEG.

<comment>Param:</comment>
  <info>string</info>  <strong>$iptc_data</strong>  Les données à écrire.
  <info>string</info>  <strong>$filename</strong>   Chemin vers le fichier JPEG.
  <info>int</info>     <strong>$spool</strong>      Le drapeau de la bobine. Si la bobine est inférieur à 2, alors le fichier JPEG
                      sera retourné sous la forme d'une chaîne de caractères. Autrement le fichier
                      JPEG sera envoyé à STDOUT.

<comment>Return:</comment>
  <info>string|bool</info>  Si <strong>$spool</strong> est inférieur à 2, le fichier JPEG sera retourné, ou <info>false</info> si une erreur
               survient. Sinon retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: iptcparse
type: function
doc:
<comment>Description:</comment>
  Analyse un bloc binaire IPTC et recherche les balises simples
  
  Analyse un bloc binaire IPTC et recherche les balises simples.

<comment>Param:</comment>
  <info>string</info>  <strong>$iptc_block</strong>  Un bloc binaire IPTC.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau avec les balises comme index et les valeurs de ces balises IPTC
               dans les valeurs de tableau correspondantes. En cas d'erreur, ou si aucune balise
               IPTC n'a été trouvée, cette fonction retourne <info>false</info>.


id: is_a
type: function
doc:
<comment>Description:</comment>
  Vérifie si l'objet est d'un certain type ou sous-type.
  
  Vérifie si l'objet <strong>$object_or_class</strong> est de ce type d'objet ou a ce type d'objet comme l'un de ses
  supertypes.

<comment>Param:</comment>
  <info>mixed</info>   <strong>$object_or_class</strong>  Un nom de classe ou une instance d'un objet.
  <info>string</info>  <strong>$class</strong>            Le nom de la classe ou de l'interface.
  <info>bool</info>    <strong>$allow_string</strong>     Si ce paramètre vaut <info>false</info>, le nom de la classe sous forme de chaîne de
                            caractères dans le paramètre <strong>$object_or_class</strong> n'est pas autorisé. Ceci
                            permet d'éviter l'appel de l'autoloader si la classe n'existe pas.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si l'objet est de ce type d'objet ou a ce type d'objet comme l'un de ses
        supertypes, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>get_class()</strong>
   * <strong>get_parent_class()</strong>
   * <strong>is_subclass_of()</strong>


id: is_array
type: function
doc:
<comment>Description:</comment>
  Détermine si une variable est un tableau
  
  <strong>is_array()</strong> détermine si la variable donnée est un tableau.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La variable à évaluer.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est un <info>array</info>, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>array_is_list()</strong>
   * <strong>is_float()</strong>
   * <strong>is_int()</strong>
   * <strong>is_string()</strong>
   * <strong>is_object()</strong>


id: is_bool
type: function
doc:
<comment>Description:</comment>
  Détermine si une variable est un booléen
    
  
  <strong>is_bool()</strong> détermine si la variable donnée est un booléen.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La variable à évaluer.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est un booléen, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>is_float()</strong>
   * <strong>is_int()</strong>
   * <strong>is_string()</strong>
   * <strong>is_object()</strong>
   * <strong>is_array()</strong>


id: is_callable
type: function
doc:
<comment>Description:</comment>
  Détermine si une valeur peut être appelé comme une fonction
     dans la portée courante.
    
  
  Vérifie qu'une variable est un <info>callable</info>.

<comment>Param:</comment>
  <info>mixed</info>   <strong>$value</strong>          La valeur à vérifier.
  <info>bool</info>    <strong>$syntax_only</strong>    Si l'argument <strong>$syntax_only</strong> vaut <info>true</info>, la fonction ne va vérifier que si
                          <strong>$value</strong> peut être une fonction ou une méthode. Il va simplement rejeter les
                          variables qui ne sont pas des chaînes, ou des tableaux qui n'ont pas la
                          bonne structure pour être utilisés comme fonction de rappel. Les tableaux
                          valides sont supposés n'avoir que deux entrées, le premier étant un objet
                          ou une chaîne, et le second une chaîne.
  <info>string</info>  <strong>$callable_name</strong>  L'argument <strong>$callable_name</strong> reçoit le nom à utiliser. Dans l'exemple
                          ci-dessous, il vaut <return>"someClass::someMethod"</return>. Notez que, bien que
                          <return>someClass::someMethod()</return> puisse être appelée sous forme statique, ce n'est
                          pas le cas.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> peut être appelé comme une fonction, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>function_exists()</strong>
   * <strong>method_exists()</strong>


id: is_countable
type: function
doc:
<comment>Description:</comment>
  Vérifie si le contenu de la variable est une valeur dénombrable
    
  
  Vérifie si le contenue de la variable est un tableau <info>array</info> ou un object qui implémente <class>Countable</class>

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La variable à vérifier

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est dénombrable, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>is_array()</strong>
   * <strong>is_object()</strong>
   * <strong>is_iterable()</strong>
   * <strong>is_bool()</strong>


id: is_dir
type: function
doc:
<comment>Description:</comment>
  Indique si le fichier est un dossier
  
  Indique si le fichier est un dossier.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers le fichier. Si <strong>$filename</strong> est un fichier relatif, il sera vérifié
                     relativement au dossier de travail courant. Si <strong>$filename</strong> est un lien symbolique
                     ou un lien conventionnel, le lien sera résolu et vérifié. Si vous avez activé
                     open_basedir, plus de restrictions peuvent être appliquées.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le nom de fichier existe et que c'est un dossier, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>chdir()</strong>
   * <strong>dir()</strong>
   * <strong>opendir()</strong>
   * <strong>is_file()</strong>
   * <strong>is_link()</strong>


id: is_double
type: function
doc:
<comment>Description:</comment>
  Alias de is_float
  
  Cette fonction est un alias de :  <strong>is_float()</strong>.


id: is_executable
type: function
doc:
<comment>Description:</comment>
  Indique si le fichier est exécutable
  
  Indique si le fichier est exécutable.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers le fichier.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le fichier existe et qu'il est exécutable, <info>false</info> sinon. Sur les systèmes
        POSIX, un fichier est exécutable si le bit exécutable des permissions de fichier est défini.
        Sur Windows, voir la note ci-dessous.

<comment>See Also:</comment>
   * <strong>is_file()</strong>
   * <strong>is_link()</strong>


id: is_file
type: function
doc:
<comment>Description:</comment>
  Indique si le fichier est un véritable fichier
  
  Indique si le fichier est un véritable fichier.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers le fichier.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le nom de fichier existe et que c'est un fichier régulier, <info>false</info> sinon.
        
        Comme le type entier de PHP est signé et que de nombreuses plates-formes utilisent des
        entiers de 32 bits, certaines fonctions relatives au système de fichiers peuvent retourner
        des résultats étranges pour les fichiers de taille supérieure à 2 Go.

<comment>See Also:</comment>
   * <strong>is_dir()</strong>
   * <strong>is_link()</strong>
   * <class>SplFileInfo</class>


id: is_finite
type: function
doc:
<comment>Description:</comment>
  Vérifie si un nombre flottant est fini
  
  Retourne si le <strong>$num</strong> donné est un nombre flottant fini.
  
  Un nombre flottant fini n'est ni <return>NAN</return> (<strong>is_nan()</strong>), ni infini (<strong>is_infinite()</strong>).

<comment>Param:</comment>
  <info>float</info>  <strong>$num</strong>  Le nombre décimal à vérifier

<comment>Return:</comment>
  <info>bool</info>  <info>true</info> si <strong>$num</strong> n'est aucun de <return>NAN</return>, <return>INF</return>, <return>-INF</return>, sinon <info>false</info>.

<comment>See Also:</comment>
   * <strong>is_infinite()</strong>
   * <strong>is_nan()</strong>


id: is_float
type: function
doc:
<comment>Description:</comment>
  Détermine si une variable est de type nombre décimal
  
  Détermine si la variable donnée est de type nombre décimal.
  
  Pour tester si une variable est un nombre ou une chaîne numérique (comme les entrées de
  formulaire, qui sont toujours des chaînes),  vous devez utiliser la fonction <strong>is_numeric()</strong>.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La variable à évaluer.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est un nombre décimal, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>is_bool()</strong>
   * <strong>is_int()</strong>
   * <strong>is_numeric()</strong>
   * <strong>is_string()</strong>
   * <strong>is_array()</strong>
   * <strong>is_object()</strong>


id: is_infinite
type: function
doc:
<comment>Description:</comment>
  Vérifie si un nombre flottant est infini
  
  Retourne si le <strong>$num</strong> donné est soit <return>INF</return> ou <return>-INF</return>.

<comment>Param:</comment>
  <info>float</info>  <strong>$num</strong>  Le nombre décimal à vérifier

<comment>Return:</comment>
  <info>bool</info>  Retourne si le <strong>$num</strong> donné est soit <return>INF</return> ou <return>-INF</return>, sinon, <info>false</info>.

<comment>See Also:</comment>
   * <strong>is_finite()</strong>
   * <strong>is_nan()</strong>


id: is_int
type: function
doc:
<comment>Description:</comment>
  Détermine si une variable est de type nombre entier
  
  Détermine si la variable donnée est de type nombre entier.
  
  Pour tester si une variable est un nombre ou une chaîne numérique (comme les entrées de
  formulaire, qui sont toujours des chaînes),  vous devez utiliser la fonction <strong>is_numeric()</strong>.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La variable à évaluer.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est un entier, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>is_bool()</strong>
   * <strong>is_float()</strong>
   * <strong>is_numeric()</strong>
   * <strong>is_string()</strong>
   * <strong>is_array()</strong>
   * <strong>is_object()</strong>


id: is_integer
type: function
doc:
<comment>Description:</comment>
  Alias de is_int
  
  Cette fonction est un alias de :  <strong>is_int()</strong>.


id: is_iterable
type: function
doc:
<comment>Description:</comment>
  Détermine si le contenu de la variable est itérable.
    
  
  Vérifie que le contenu de la variable est accepté par le pseudo-type  <info>iterable</info>, c'est-à-dire qu'il
  s'agit soit d'un <info>array</info> ou un objet qui implémente l'interface <class>Traversable</class>

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La valeur à vérifier

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est itérable, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>is_array()</strong>


id: is_link
type: function
doc:
<comment>Description:</comment>
  Indique si le fichier est un lien symbolique
  
  Indique si le fichier est un lien symbolique.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers le fichier.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le nom de fichier existe et que c'est un lien symbolique, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>is_dir()</strong>
   * <strong>is_file()</strong>
   * <strong>readlink()</strong>


id: is_nan
type: function
doc:
<comment>Description:</comment>
  Vérifie si un nombre flottant est NAN
  
  Retourne si le <strong>$num</strong> donné est <return>NAN</return> (Not A Number).
  
  <return>NAN</return> est retourné par les opérations mathématiques qui ne sont pas définies, par exemple lors du
  passage de paramètres en dehors du domaine d'entrée de la fonction. La racine carrée (<strong>sqrt()</strong>)
  n'est définie que pour les nombres positifs, le passage d'un nombre négatif résultera en un <return>NAN</return>.
  D'autres exemples d'opérations renvoyant <return>NAN</return> sont la division de <return>INF</return> par <return>INF</return> et toute opération
  impliquant une valeur <return>NAN</return> existante.
  
  Malgré son nom Not A Number, <return>NAN</return> est une valeur valide de type nombre décimal.
  
  <return>NAN</return> ne se compare pas égal à <return>NAN</return>. Pour vérifier si un nombre flottant est <return>NAN</return>, <strong>is_nan()</strong> doit être
  utilisé. La vérification de $float === NAN ne fonctionnera pas.

<comment>Param:</comment>
  <info>float</info>  <strong>$num</strong>  Le nombre décimal à vérifier

<comment>Return:</comment>
  <info>bool</info>  <info>true</info> si <strong>$num</strong> est <return>NAN</return>, sinon <info>false</info>.

<comment>See Also:</comment>
   * <strong>is_finite()</strong>
   * <strong>is_infinite()</strong>


id: is_null
type: function
doc:
<comment>Description:</comment>
  Indique si une variable vaut null
  
  Indique si la variable donnée vaut <info>null</info>.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La variable à évaluer.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est <info>null</info>, <info>false</info> sinon.

<comment>See Also:</comment>
   * Le type <info>null</info>
   * <strong>isset()</strong>
   * <strong>is_bool()</strong>
   * <strong>is_numeric()</strong>
   * <strong>is_float()</strong>
   * <strong>is_int()</strong>
   * <strong>is_string()</strong>
   * <strong>is_object()</strong>
   * <strong>is_array()</strong>


id: is_numeric
type: function
doc:
<comment>Description:</comment>
  Détermine si une variable est un nombre ou une chaîne numérique
    
  
  Détermine si la variable donnée est un nombre ou une chaîne numérique.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La variable à évaluer.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est un nombre ou une chaîne numérique, <info>false</info> sinon.

<comment>See Also:</comment>
   * Les chaînes numérique
   * <strong>ctype_digit()</strong>
   * <strong>is_bool()</strong>
   * <strong>is_null()</strong>
   * <strong>is_float()</strong>
   * <strong>is_int()</strong>
   * <strong>is_string()</strong>
   * <strong>is_object()</strong>
   * <strong>is_array()</strong>
   * <strong>filter_var()</strong>


id: is_object
type: function
doc:
<comment>Description:</comment>
  Détermine si une variable est de type objet
  
  Détermine si la variable donnée est de type objet.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La variable à évaluer.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est un objet, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>is_bool()</strong>
   * <strong>is_int()</strong>
   * <strong>is_float()</strong>
   * <strong>is_string()</strong>
   * <strong>is_array()</strong>


id: is_readable
type: function
doc:
<comment>Description:</comment>
  Indique si un fichier existe et est accessible en lecture
  
  Indique si un fichier existe et est accessible en lecture.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Chemin vers le fichier.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le fichier ou le dossier spécifié par <strong>$filename</strong> existe et est accessible en
        lecture, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>is_writable()</strong>
   * <strong>file_exists()</strong>
   * <strong>fgets()</strong>


id: is_real
type: function
doc:
<comment>Description:</comment>
  Alias de is_float
  
  Cette fonction est un alias de :  <strong>is_float()</strong>.
  
  Cet alias est
  OBSOLÈTE en PHP 7.4.0, et SUPPRIMÉ à partir de PHP 8.0.0.


id: is_resource
type: function
doc:
<comment>Description:</comment>
  Détermine si une variable est une ressource
    
  
  Détermine si une variable est une ressource.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La variable à évaluer.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est une ressource, <info>false</info> autrement.

<comment>See Also:</comment>
   * La
    <info>documentation</info> sur les ressources
   * <strong>get_resource_type()</strong>


id: is_scalar
type: function
doc:
<comment>Description:</comment>
  Indique si une variable est un scalaire
    
  
  Indique si la variable donnée est un scalaire.
  
  Les variables scalaires sont celles qui contiennent un entier, un nombre décimal, une chaîne de
  caractères ou un booléen. Les types <info>array</info>, <info>object</info>, <info>resource</info> et <info>null</info> ne sont pas scalaires.
  
  <strong>is_scalar()</strong> ne considère pas les valeurs des types ressource comme scalaires, étant donné que les
  ressources sont des types abstraits,  basés sur des entiers. Ceci est susceptible de changer.
  
  La fonction <strong>is_scalar()</strong> ne considère pas la valeur NULL comme un scalaire.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La variable à évaluer.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est un scalaire, <info>false</info> autrement.

<comment>See Also:</comment>
   * <strong>is_float()</strong>
   * <strong>is_int()</strong>
   * <strong>is_numeric()</strong>
   * <strong>is_real()</strong>
   * <strong>is_string()</strong>
   * <strong>is_bool()</strong>
   * <strong>is_object()</strong>
   * <strong>is_array()</strong>


id: is_soap_fault
type: function
doc:
<comment>Description:</comment>
  Vérifie si SOAP retourne une erreur
  
  <strong>is_soap_fault()</strong> sert à vérifier si l'API SOAP a échoué, sans utiliser les exceptions. Pour
  l'utiliser, créez un objet <class>SoapClient</class> avec l'option <return>exceptions</return> mise à zéro ou à <info>false</info>. Dans ce
  cas,  la méthode SOAP va retourner un objet spécial <class>SoapFault</class>, qui encapsule les détails de
  l'erreur (code d'erreur, message, acteur et détails).
  
  Si <return>exceptions</return> n'est pas configurée, SOAP va émettre une exception. <strong>is_soap_fault()</strong> vérifie si le
  paramètre fourni est un objet <class>SoapFault</class>.

<comment>Param:</comment>
  <info></info>  <strong>$objet</strong>  L'objet à tester.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * SoapClient::__construct
   * SoapFault::__construct


id: is_string
type: function
doc:
<comment>Description:</comment>
  Détermine si une variable est de type chaîne de caractères
  
  Détermine si la variable donnée est de type chaîne de caractères.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La variable à évaluer.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$value</strong> est une chaîne de caractères, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>is_float()</strong>
   * <strong>is_int()</strong>
   * <strong>is_bool()</strong>
   * <strong>is_object()</strong>
   * <strong>is_array()</strong>


id: is_subclass_of
type: function
doc:
<comment>Description:</comment>
  Détermine si un objet est une sous-classe d'une classe donnée ou l'implémente
  
  Vérifie si l'objet <strong>$object_or_class</strong> a la classe <strong>$class</strong> parmi ses parents ou l'implémente.

<comment>Param:</comment>
  <info>mixed</info>   <strong>$object_or_class</strong>  Un nom de classe ou une instance d'un objet. Aucune erreur n'est générée
                            si la classe n'existe pas.
  <info>string</info>  <strong>$class</strong>            Le nom de la classe
  <info>bool</info>    <strong>$allow_string</strong>     Si ce paramètre est défini à <info>false</info>, un nom de classe sous forme de
                            chaîne de caractères dans le paramètre <strong>$object_or_class</strong> n'est pas
                            autorisé. Ceci permet d'éviter d'appeler l'autoloader si la classe
                            n'existe pas.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> si l'objet <strong>$object_or_class</strong> est une instance d'une classe qui
        est une sous-classe de <strong>$class</strong>, <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>get_class()</strong>
   * <strong>get_parent_class()</strong>
   * <strong>is_a()</strong>
   * <strong>class_parents()</strong>


id: is_tainted
type: function
doc:
<comment>Description:</comment>
  Vérifie si une chaîne est nettoyée
  
  Vérifie si une chaîne est nettoyée.

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si la chaîne est nettoyée, <info>false</info> sinon.


id: is_uploaded_file
type: function
doc:
<comment>Description:</comment>
  Indique si le fichier a été téléchargé par HTTP POST
  
  Retourne <info>true</info> si le fichier <strong>$filename</strong> a été téléchargé par HTTP POST. Cela est très utile pour
  vous assurer qu'un utilisateur n'essaie pas d'accéder intentionnellement à un fichier auquel il
  n'a pas de droits (comme /etc/passwd).
  
  Ce type de vérification est spécialement important s'il est possible que les fichiers téléchargés
  révèlent leur contenu à l'utilisateur, ou même aux utilisateurs du même système.
  
  Pour un fonctionnement correct, la fonction <strong>is_uploaded_file()</strong> nécessite un argument comme
  $_FILES['userfile']['tmp_name'], - le nom du fichier téléchargé sur la machine cliente
  $_FILES['userfile']['name'] ne fonctionne pas.

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Le nom de fichier à vérifier.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>move_uploaded_file()</strong>
   * $_FILES
   * Voir la section sur
     la gestion des téléchargements
     pour un exemple d'utilisation simple.


id: is_writable
type: function
doc:
<comment>Description:</comment>
  Indique si un fichier est accessible en écriture
  
  retourne <info>true</info> si <strong>$filename</strong> existe et est accessible en écriture. L'argument peut être le nom d'un
  dossier, vous permettant ainsi de vérifier si le dossier est accessible en écriture.
  
  N'oubliez pas que PHP accède aux fichiers avec les mêmes autorisations que l'utilisateur qui fait
  tourner le serveur web (souvent, c'est '<return>nobody</return>', personne).

<comment>Param:</comment>
  <info>string</info>  <strong>$filename</strong>  Le nom du fichier à vérifier.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si le fichier <strong>$filename</strong> existe et est accessible en écriture.

<comment>See Also:</comment>
   * <strong>is_readable()</strong>
   * <strong>file_exists()</strong>
   * <strong>fwrite()</strong>


id: is_writeable
type: function
doc:
<comment>Description:</comment>
  Alias de is_writable
  
  Cette fonction est un alias de :  <strong>is_writable()</strong>.


id: isset
type: function
doc:
<comment>Description:</comment>
  Détermine si une variable est déclarée et est différente de null
  
  Détermine si une variable est considérée définie, ceci signifie qu'elle est déclarée et est
  différente de <info>null</info>.
  
  Si une variable a été détruite avec la fonction <strong>unset()</strong>, elle n'est plus considéré comme définie.
  
  <strong>isset()</strong> renverra <info>false</info> lors de la vérification  d'une variable de valeur <info>null</info>. Il est à noter que
  aussi que le caractère nul (<return>"\0"</return>) n'est pas équivalent à la constante PHP <info>null</info>.
  
  Si plusieurs paramètres sont fournis, alors <strong>isset()</strong> retournera <info>true</info> seulement si tous les
  paramètres sont définis. L'évaluation s'effectue de gauche à droite et s'arrête dès qu'une
  variable non définie est rencontrée.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$var</strong>   La variable à analyser.
  <info>mixed</info>  <strong>$vars</strong>  Variables supplémentaires.

<comment>Return:</comment>
  <info>bool</info>  Retourne <info>true</info> si <strong>$var</strong> existe et a une valeur autre que <info>null</info>. <info>false</info> sinon.

<comment>See Also:</comment>
   * <strong>empty()</strong>
   * __isset()
   * <strong>unset()</strong>
   * <strong>defined()</strong>
   * le tableau de comparaison de types
   * <strong>array_key_exists()</strong>
   * <strong>is_null()</strong>
   * l'opérateur de contrôle de rapport d'erreurs @


id: iterator_apply
type: function
doc:
<comment>Description:</comment>
  Appelle une fonction pour tous les éléments d'un itérateur
  
  Appelle une fonction pour tous les éléments d'un itérateur.

<comment>Param:</comment>
  <info>Traversable</info>  <strong>$iterator</strong>  L'object iterator à itérer.
  <info>callable</info>     <strong>$callback</strong>  La fonction de rappel à appeler à chaque élément. Cette fonction ne reçoit
                          que les arguments <strong>$args</strong> donnés, elle est donc nullaire par défault. Si
                          <return>count($args) === 3</return>, par exemple, la fonction est ternaire.  La fonction
                          doit retourner <info>true</info> afin de continuer d'itérer à travers l'itérateur nommé
                          par le paramètre <strong>$iterator</strong>.
                          
                          La fonction doit retourner <info>true</info> afin de continuer d'itérer à travers
                          l'itérateur nommé par le paramètre <strong>$iterator</strong>.
  <info>array|null</info>   <strong>$args</strong>      Un tableau <info>array</info> d'arguments; chaque élément de <strong>$args</strong> est passé à la
                          fonction de rappel <strong>$callback</strong> comme argument séparé.

<comment>Return:</comment>
  <info>int</info>  Retourne le nombre d'itération.

<comment>See Also:</comment>
   * <strong>array_walk()</strong>


id: iterator_count
type: function
doc:
<comment>Description:</comment>
  Compte de nombre d'éléments dans un itérateur
    
  
  Compte les éléments dans un itérateur. Il n'est pas garantie que la fonction <strong>iterator_count()</strong>
  conserve la position courante de l'itérateur <strong>$iterator</strong>.

<comment>Param:</comment>
  <info>Traversable|array</info>  <strong>$iterator</strong>  L'itérateur dont il faut compter les éléments.

<comment>Return:</comment>
  <info>int</info>  Le nombre d'éléments dans l'itérateur <strong>$iterator</strong>.


id: iterator_to_array
type: function
doc:
<comment>Description:</comment>
  Copie un itérateur dans un tableau
    
  
  Copie les éléments d'un itérateur dans un tableau.

<comment>Param:</comment>
  <info>Traversable|array</info>  <strong>$iterator</strong>       L'itérateur à copier.
  <info>bool</info>               <strong>$preserve_keys</strong>  S'il faut utiliser les éléments de l'itérateur comme clé.
                                     
                                     Si une clé est un <info>array</info> ou un <info>object</info>, une alerte sera générée.
                                     Les clés <info>null</info> seront converties en une chaîne vide, les clés de
                                     type <info>float</info> seront tronquées en leurs parties <info>int</info>, les clés de
                                     type <info>resource</info> génèreront une alerte et seront converties en
                                     identifiant de la ressource, et les clés de type <info>bool</info> seront
                                     converties en entiers.
                                     
                                     Si ce paramètre n'est pas défini ou défini sur <info>true</info>, les clés
                                     dupliquées  seront écrasées. La dernière valeur avec une clé
                                     donnée sera dans le  <info>array</info> retourné. Définir ce paramètre à
                                     <info>false</info> pour obtenir  toutes les valeurs en tout cas.

<comment>Return:</comment>
  <info>array</info>  Un tableau contenant les éléments de l'itérateur <strong>$iterator</strong>.


id: jddayofweek
type: function
doc:
<comment>Description:</comment>
  Retourne le numéro du jour de la semaine
  
  Retourne le numéro du jour de la semaine. Peut retourner une chaîne ou un entier, en fonction du
  mode.

<comment>Param:</comment>
  <info>int</info>  <strong>$julian_day</strong>  Le numéro du jour Julien, sous la forme d'un entier
  <info>int</info>  <strong>$mode</strong>        

<comment>Return:</comment>
  <info>int|string</info>  Le jour de la semaine Grégorien, sous la forme d'un entier ou d'une chaîne de
              caractères.


id: jdmonthname
type: function
doc:
<comment>Description:</comment>
  Retourne le nom du mois
  
  Retourne une chaîne contenant le nom du mois. <strong>$mode</strong> indique de quel calendrier dépend ce mois, et
  quel type de nom doit être retourné. Modes de
  calendrierModeSignificationValeurs<info>CAL_MONTH_GREGORIAN_SHORT</info>Grégorien - abrégéJan, Feb, Mar, Apr,
  May, Jun, Jul, Aug, Sep, Oct, Nov, Dec<info>CAL_MONTH_GREGORIAN_LONG</info>GrégorienJanuary, February, March,
  April, May, June, July, August, September, October, November, December<info>CAL_MONTH_JULIAN_SHORT</info>Julien
  - abrégéJan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov,
  Dec<info>CAL_MONTH_JULIAN_LONG</info>JulienJanuary, February, March, April, May, June, July, August, September,
  October, November, December<info>CAL_MONTH_JEWISH</info>JuifTishri, Heshvan, Kislev, Tevet, Shevat, Adar, Adar
  I, Adar II, Nisan, Iyyar, Sivan, Tammuz, Av, Elul<info>CAL_MONTH_FRENCH</info>Républicain françaisVendemiaire,
  Brumaire, Frimaire, Nivose, Pluviose, Ventose, Germinal, Floreal, Prairial, Messidor, Thermidor,
  Fructidor, Extra

<comment>Param:</comment>
  <info></info>     <strong>$jday</strong>  Le jour Julien à analyser
  <info>int</info>  <strong>$mode</strong>  Le mode de calendrier (voir tableau ci-dessus).

<comment>Return:</comment>
  <info>string</info>  Le nom du mois pour le jour Julien et le <strong>$mode</strong>.


id: jdtofrench
type: function
doc:
<comment>Description:</comment>
  Convertit le nombre de jours du calendrier Julien en date du calendrier
     français républicain
  
  Convertit le nombre de jours du calendrier julien en date du calendrier français républicain.

<comment>Param:</comment>
  <info>int</info>  <strong>$julian_day</strong>  Le numéro du jour Julien, sous la forme d'un entier

<comment>Return:</comment>
  <info>string</info>  La date française républicaine, sous la forme d'une chaîne de caractères
          "mois/jour/année".

<comment>See Also:</comment>
   * <strong>frenchtojd()</strong>
   * <strong>cal_from_jd()</strong>


id: jdtogregorian
type: function
doc:
<comment>Description:</comment>
  Convertit le nombre de jours du calendrier Julien en date
     grégorienne
  
  Convertit le nombre de jours du calendrier Julien en une chaîne contenant une date du calendrier
  grégorien, au format "mois/jour/année".

<comment>Param:</comment>
  <info>int</info>  <strong>$julian_day</strong>  Le numéro du jour Julien, sous la forme d'un entier

<comment>Return:</comment>
  <info>string</info>  La date grégorienne, sous la forme d'une chaîne de caractères "mois/jour/année".

<comment>See Also:</comment>
   * <strong>gregoriantojd()</strong>
   * <strong>cal_from_jd()</strong>


id: jdtojewish
type: function
doc:
<comment>Description:</comment>
  Convertit le nombre de jours du calendrier Julien en date du calendrier juif
  
  Convertit un nombre de jours du calendrier Julien en calendrier juif.

<comment>Param:</comment>
  <info>int</info>   <strong>$julian_day</strong>  Un nombre de jour Julien sous forme d'entier.
  <info>bool</info>  <strong>$hebrew</strong>      Si le paramètre <strong>$hebrew</strong> est définit à <info>true</info>, le paramètre <strong>$flags</strong> est utilisé
                     pour l'hébreu, format de sortie basé sur une chaîne de caractères codée
                     ISO-8859-8.
  <info>int</info>   <strong>$flags</strong>       Un masque bit qui peut consister de <info>CAL_JEWISH_ADD_ALAFIM_GERESH</info>,
                     <info>CAL_JEWISH_ADD_ALAFIM</info> et <info>CAL_JEWISH_ADD_GERESHAYIM</info>.

<comment>Return:</comment>
  <info>string</info>  La date Juive, sous la forme d'une chaîne de caractères "mois/jour/année", ou une chaîne
          de caractères de date hébraïque codée ISO-8859-8, en fonction du paramètre <strong>$hebrew</strong>.

<comment>See Also:</comment>
   * <strong>jewishtojd()</strong>
   * <strong>cal_from_jd()</strong>


id: jdtojulian
type: function
doc:
<comment>Description:</comment>
  Convertit le nombre de jours du calendrier Julien en date du calendrier Julien
  
  Convertit le nombre de jours du calendrier Julien en une chaîne contenant la date du calendrier
  Julien, au format "mois/jour/année".

<comment>Param:</comment>
  <info>int</info>  <strong>$julian_day</strong>  Le nombre de jours Julien, sous la forme d'un entier

<comment>Return:</comment>
  <info>string</info>  La date Julien, sous la forme d'une chaîne de caractères "mois/jour/année".

<comment>See Also:</comment>
   * <strong>juliantojd()</strong>
   * <strong>cal_from_jd()</strong>


id: jdtounix
type: function
doc:
<comment>Description:</comment>
  Convertit un jour Julien en timestamp UNIX
  
  Retourne un timestamp UNIX correspondant au jour Julien <strong>$julian_day</strong> ou <info>false</info> si <strong>$julian_day</strong> n'est
  pas dans l'intervalle autorisé. Le temps retourné est UTC.

<comment>Param:</comment>
  <info>int</info>  <strong>$julian_day</strong>  Le nombre de jours Julien, compris entre <return>2440588</return> et <return>106751993607888</return> sur les
                    systèmes 64bit, ou compris entre <return>2440588</return> et <return>2465443</return> sur les systèmes 32bit.

<comment>Return:</comment>
  <info>int</info>  Le timestamp unix pour le début (minuit, pas midi) du jour Julien donné.

<comment>See Also:</comment>
   * <strong>unixtojd()</strong>


id: jewishtojd
type: function
doc:
<comment>Description:</comment>
  Convertit une date du calendrier Juif en nombre de jours du calendrier Julien
  
  Bien qu'il soit possible de manipuler des dates à partir de l'an 1 (3761 avant J.C.), une telle
  utilisation a peu de sens. Le calendrier juif a été utilisé depuis plusieurs dizaines de siècles,
  mais dans les premiers temps, il n'y avait pas de formule pour déterminer le début du mois. Un
  nouveau mois commençait quand une nouvelle lune était observée.

<comment>Param:</comment>
  <info>int</info>  <strong>$month</strong>  Le mois, sous la forme d'un nombre entre <return>1</return> et <return>13</return>, où <return>1</return> signifie <return>Tishri</return>,  <return>13</return> signifie
               <return>Eloul</return>, et  <return>6</return> et <return>7</return>  signifie <return>Adar</return> dans les années régulières, mais  <return>Adar I</return> et <return>Adar II</return>,
               respectivement,  dans les années bissextiles.
  <info>int</info>  <strong>$day</strong>    Le jour, sous la forme d'un nombre entre <return>1</return> et <return>30</return>. Si le mois n'a que 29 jours, le
               premier jour du mois suivant est assumé.
  <info>int</info>  <strong>$year</strong>   L'année, sous la forme d'un nombre entre 1 et 9999

<comment>Return:</comment>
  <info>int</info>  Le jour Julien pour la date Juive donnée, sous la forme d'un entier.

<comment>See Also:</comment>
   * <strong>jdtojewish()</strong>
   * <strong>cal_to_jd()</strong>


id: join
type: function
doc:
<comment>Description:</comment>
  Alias de implode
  
  Cette fonction est un alias de :  <strong>implode()</strong>.


id: jpeg2wbmp
type: function
doc:
<comment>Description:</comment>
  Convertit une image JPEG en image WBMP
  
  Convertit une image JPEG en image WBMP.

<comment>Param:</comment>
  <info>string</info>  <strong>$jpegname</strong>     Le chemin vers le fichier JPEG.
  <info>string</info>  <strong>$wbmpname</strong>     Chemin vers le fichier final WBMP.
  <info>int</info>     <strong>$dest_height</strong>  Hauteur de l'image de destination.
  <info>int</info>     <strong>$dest_width</strong>   Largeur de l'image de destination.
  <info>int</info>     <strong>$threshold</strong>    Valeur du seuil, entre 0 et 8 inclus.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.
        
        Toutefois, si libgd ne parvient pas à produire l'image, cette fonction retourne <info>true</info>.

<comment>See Also:</comment>
   * <strong>png2wbmp()</strong>


id: json_decode
type: function
doc:
<comment>Description:</comment>
  Décode une chaîne JSON
  
  Récupère une chaîne encodée JSON et la convertit en une valeur de PHP.

<comment>Param:</comment>
  <info>string</info>     <strong>$json</strong>         La chaîne de caractères <strong>$json</strong> à décoder.
                           
                           Cette fonction ne fonctionne qu'avec des chaînes encodées en UTF-8.
                           
                           PHP implémente un sur-ensemble de JSON tel que spécifié dans la RFC 7159
                           originale.
  <info>bool|null</info>  <strong>$associative</strong>  Lorsque ce paramètre vaut <info>true</info>, les objets JSON seront retournés comme
                           tableaux associatifs ; lorsque ce paramètre vaut <info>false</info>, les objets JSON
                           seront retournés comme des objets. Lorsque ce paramètre vaut <info>null</info>, les
                           objets JSON seront retournés comme des tableaux associatifs ou des
                           objets, suivant si la constante <info>JSON_OBJECT_AS_ARRAY</info> a été définie dans
                           le paramètre <strong>$flags</strong>.
  <info>int</info>        <strong>$depth</strong>        Profondeur d'imbrication maximale de la structure en cours de décodage.
                           La valeur doit être supérieure à <return>0</return>, et inférieure ou égale à <return>2147483647</return>.
  <info>int</info>        <strong>$flags</strong>        Masque de bit compris de <info>JSON_BIGINT_AS_STRING</info>, <info>JSON_INVALID_UTF8_IGNORE</info>,
                           <info>JSON_INVALID_UTF8_SUBSTITUTE</info>, <info>JSON_OBJECT_AS_ARRAY</info>, <info>JSON_THROW_ON_ERROR</info>.
                           Le comportement de ces constantes est décrite sur la page des constantes
                           JSON.

<comment>Return:</comment>
  <info>mixed</info>  Retourne la valeur encodée dans le paramètre <strong>$json</strong> dans le type PHP approprié. Les valeurs
         sans guillemets <return>true</return>, <return>false</return> et <return>null</return> sont retournées respectivement comme <info>true</info>, <info>false</info> et
         <info>null</info>. <info>null</info> est retourné si le paramètre <strong>$json</strong> n'a pu être décodé ou si les données encodées
         sont plus profondes que la limite d'imbrication fournie.

<comment>See Also:</comment>
   * <strong>json_encode()</strong>
   * <strong>json_last_error()</strong>


id: json_encode
type: function
doc:
<comment>Description:</comment>
  Retourne la représentation JSON d'une valeur
  
  Retourne une chaîne de caractères contenant la représentation JSON de la valeur <strong>$value</strong>. Si le
  paramètre est un tableau ou un objet, il sera sérialisé de manière récursive.
  
  Si l'une des valeurs à sérialiser est un objet, alors par défaut seules les propriétés visibles
  publiquement seront incluses. Une classe peut également implémenter JsonSerializable pour
  contrôler la façon dont ses valeurs sont sérialisées en JSON.
  
  L'encodage est affecté par les <strong>$flags</strong> fournies. De plus, l'encodage des valeurs flottantes dépend
  de la valeur de serialize_precision.

<comment>Param:</comment>
  <info>mixed</info>  <strong>$value</strong>  La valeur à encoder. Peut-être de n'importe quel type, excepté une ressource.
                 
                 Toutes les chaînes doivent être encodées UTF-8.
                 
                 PHP implémente un sur-ensemble de JSON tel que spécifié dans la RFC 7159 originale.
  <info>int</info>    <strong>$flags</strong>  Masque de bit compris de <info>JSON_FORCE_OBJECT</info>, <info>JSON_HEX_QUOT</info>, <info>JSON_HEX_TAG</info>,
                 <info>JSON_HEX_AMP</info>, <info>JSON_HEX_APOS</info>, <info>JSON_INVALID_UTF8_IGNORE</info>,
                 <info>JSON_INVALID_UTF8_SUBSTITUTE</info>, <info>JSON_NUMERIC_CHECK</info>, <info>JSON_PARTIAL_OUTPUT_ON_ERROR</info>,
                 <info>JSON_PRESERVE_ZERO_FRACTION</info>, <info>JSON_PRETTY_PRINT</info>, <info>JSON_UNESCAPED_LINE_TERMINATORS</info>,
                 <info>JSON_UNESCAPED_SLASHES</info>, <info>JSON_UNESCAPED_UNICODE</info>, <info>JSON_THROW_ON_ERROR</info>. Le
                 comportement de ces constantes est décrit sur la page des constantes JSON.
  <info>int</info>    <strong>$depth</strong>  Définit la profondeur maximale. Doit être supérieur à zéro.

<comment>Return:</comment>
  <info>string|false</info>  Retourne un JSON encodé en tant que chaîne de caractères en cas de succès  ou <info>false</info>
                si une erreur survient.

<comment>See Also:</comment>
   * JsonSerializable
   * <strong>json_decode()</strong>
   * <strong>json_last_error()</strong>
   * <strong>serialize()</strong>


id: json_last_error
type: function
doc:
<comment>Description:</comment>
  Retourne la dernière erreur JSON
  
  Retourne la dernière erreur, s'il y en a eu, survenue lors de la dernière opération
  d'encodage/décodage JSON, qui n'a pas spécifié <info>JSON_THROW_ON_ERROR</info>.

<comment>Return:</comment>
  <info>int</info>  Retourne une des constantes suivantes :

<comment>See Also:</comment>
   * <strong>json_last_error_msg()</strong>
   * <strong>json_decode()</strong>
   * <strong>json_encode()</strong>


id: json_last_error_msg
type: function
doc:
<comment>Description:</comment>
  Retourne le message de la dernière erreur survenue lors de l'appel à la fonction json_encode() ou
  json_decode()
  
  Retourne la chaîne d'erreur du dernier appel à <strong>json_encode()</strong> ou <strong>json_decode()</strong>, qui n'a pas
  spécifié <info>JSON_THROW_ON_ERROR</info>.

<comment>Return:</comment>
  <info>string</info>  Retourne le message d'erreur en cas de succès, ou <return>"No error"</return> si aucune erreur n'est
          survenue, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>json_last_error()</strong>


id: json_validate
type: function
doc:
<comment>Description:</comment>
  Checks if a string contains valid JSON
  
  Returns whether the given chaîne de caractères is syntactically valid JSON. If <strong>json_validate()</strong>
  returns <info>true</info>, <strong>json_decode()</strong> will successfully decode the given string when using the same <strong>$depth</strong>
  and <strong>$flags</strong>.
  
  If <strong>json_validate()</strong> returns <info>false</info>, the cause can be retrieved using <strong>json_last_error()</strong> and
  <strong>json_last_error_msg()</strong>.
  
  <strong>json_validate()</strong> uses less memory than <strong>json_decode()</strong> if the decoded JSON payload is not used,
  because it does not need to build the array or object structure containing the payload.
  
  Calling <strong>json_validate()</strong> immediately before <strong>json_decode()</strong> will unnecessarily parse the string
  twice, as <strong>json_decode()</strong> implicitly performs validation during decoding.
  
  <strong>json_validate()</strong> should therefore only be used if the decode JSON payload is not immediately used
  and knowing whether the string contains valid JSON is needed.

<comment>Param:</comment>
  <info>string</info>  <strong>$json</strong>   The string to validate.
                  
                  This function only works with UTF-8 encoded strings.
                  
                  PHP implémente un sur-ensemble de JSON tel que spécifié dans la RFC 7159
                  originale.
  <info>int</info>     <strong>$depth</strong>  Maximum nesting depth of the structure being decoded. The value must be greater
                  than <return>0</return>, and less than or equal to <return>2147483647</return>.
  <info>int</info>     <strong>$flags</strong>  Currently only <info>JSON_INVALID_UTF8_IGNORE</info> is accepted.

<comment>Return:</comment>
  <info>bool</info>  Returns <info>true</info> if the given string is syntactically valid JSON, otherwise returns <info>false</info>.

<comment>See Also:</comment>
   * <strong>json_decode()</strong>
   * <strong>json_last_error()</strong>
   * <strong>json_last_error_msg()</strong>


id: juliantojd
type: function
doc:
<comment>Description:</comment>
  Convertit un jours du calendrier Julien en un nombre de jours du calendrier Julien
  
  Intervalle de validité du calendrier Julien : 4713 avant JC à 9999 après J.C.
  
  Bien qu'il soit possible de manipuler des dates jusqu'en 4713 avant JC, une telle utilisation
  n'est pas significative. En effet, ce calendrier fut créé en 46 avant J.C., et ses détails ne
  furent finalisés qu'au plus tôt en 8 après JC, et probablement pas avant le quatrième siècle après
  JC. De plus, le début de l'année variait suivant les peuples, certains n'acceptant pas janvier
  comme premier mois de l'année.
  
  Souvenez-vous, le calendrier courant du système utilisé sur le Web est un calendrier Grégorien.
  <strong>gregoriantojd()</strong> peut être utilisé pour convertir ce genre de dates en un nombre de jours du
  calendrier Julien.

<comment>Param:</comment>
  <info>int</info>  <strong>$month</strong>  Le mois, sous la forme d'un nombre entre 1 (pour Janvier) et 12 (pour Décembre)
  <info>int</info>  <strong>$day</strong>    Le jour, sous la forme d'un nombre entre 1 et 31
  <info>int</info>  <strong>$year</strong>   L'année, sous la forme d'un nombre entre -4713 et 9999

<comment>Return:</comment>
  <info>int</info>  Le jour Julien pour la date Julienne donnée, sous la forme d'un entier.

<comment>See Also:</comment>
   * <strong>jdtojulian()</strong>
   * <strong>cal_to_jd()</strong>


id: key
type: function
doc:
<comment>Description:</comment>
  Retourne une clé d'un tableau associatif
  
  <strong>key()</strong> retourne la clé courante dans le tableau <strong>$array</strong>.

<comment>Param:</comment>
  <info>array|object</info>  <strong>$array</strong>  Le tableau.

<comment>Return:</comment>
  <info>int|string|null</info>  La fonction <strong>key()</strong> retourne simplement la clé de l'élément du tableau qui est
                   actuellement pointée par le pointeur interne. Cette fonction ne modifie en aucun
                   cas la position de ce pointeur. Si le pointeur interne pointe un élément se
                   situant après la fin de la liste des éléments, ou bien si le tableau est vide, la
                   fonction <strong>key()</strong> retournera <info>null</info>.

<comment>See Also:</comment>
   * <strong>current()</strong>
   * <strong>next()</strong>
   * <strong>array_key_first()</strong>
   * foreach


id: key_exists
type: function
doc:
<comment>Description:</comment>
  Alias de array_key_exists
  
  Cette fonction est un alias de :  <strong>array_key_exists()</strong>.


id: krsort
type: function
doc:
<comment>Description:</comment>
  Trie un tableau en fonction des clés en ordre décroissant
  
  Trie <strong>$array</strong> sur place suivant les clés en ordre décroissant.
  
  Si deux membres se comparent comme égaux, ils maintiennent leur ordre original. Antérieur à PHP
  8.0.0, leur ordre relatif dans le tableau trié n'est pas défini.
  
  Réinitialise le pointeur interne du tableau au premier élément.

<comment>Param:</comment>
  <info>array</info>  <strong>$array</strong>  Le tableau d'entrée.
  <info>int</info>    <strong>$flags</strong>  Le deuxième paramètre optionnel <strong>$flags</strong> peut être utilisé pour modifier le
                 comportement de tri en utilisant ces valeurs :
                 
                 Type de drapeaux de tri : <info>SORT_REGULAR</info> - compare items normally; the details are
                 described in the comparison operators section<info>SORT_NUMERIC</info> - compare les éléments
                 numériquement<info>SORT_STRING</info> - compare les éléments comme des chaînes de
                 caractères<info>SORT_LOCALE_STRING</info> - compare les éléments comme des chaînes de
                 caractères, basé sur la locale courante. Ceci utilise la locale, qui peut être
                 changée en utilisant <strong>setlocale()</strong> <info>SORT_NATURAL</info> - compare les éléments comme des
                 chaînes de caractères utilisant "l'ordre naturel" comme <strong>natsort()</strong> <info>SORT_FLAG_CASE</info> -
                 peut être combiné (OU bit à bit) avec <info>SORT_STRING</info> ou <info>SORT_NATURAL</info> pour trier les
                 chaînes sans tenir compte de la casse
                 
                 <info>SORT_REGULAR</info> - compare items normally; the details are described in the comparison
                 operators section
                 
                 <info>SORT_NUMERIC</info> - compare les éléments numériquement
                 
                 <info>SORT_STRING</info> - compare les éléments comme des chaînes de caractères
                 
                 <info>SORT_LOCALE_STRING</info> - compare les éléments comme des chaînes de caractères, basé sur
                 la locale courante. Ceci utilise la locale, qui peut être changée en utilisant
                 <strong>setlocale()</strong>
                 
                 <info>SORT_NATURAL</info> - compare les éléments comme des chaînes de caractères utilisant
                 "l'ordre naturel" comme <strong>natsort()</strong>
                 
                 <info>SORT_FLAG_CASE</info> - peut être combiné (OU bit à bit) avec <info>SORT_STRING</info> ou <info>SORT_NATURAL</info>
                 pour trier les chaînes sans tenir compte de la casse

<comment>Return:</comment>
  <info>true</info>  Retourne toujours <info>true</info>.

<comment>See Also:</comment>
   * <strong>sort()</strong>
   * <strong>ksort()</strong>
   * Les fonctions de tri des tableaux


id: ksort
type: function
doc:
<comment>Description:</comment>
  Trie un tableau en fonction des clés en ordre croissant
  
  Trie <strong>$array</strong> sur place suivant les clés en ordre croissant.
  
  Si deux membres se comparent comme égaux, ils maintiennent leur ordre original. Antérieur à PHP
  8.0.0, leur ordre relatif dans le tableau trié n'est pas défini.
  
  Réinitialise le pointeur interne du tableau au premier élément.

<comment>Param:</comment>
  <info>array</info>  <strong>$array</strong>  Le tableau d'entrée.
  <info>int</info>    <strong>$flags</strong>  Le deuxième paramètre optionnel <strong>$flags</strong> peut être utilisé pour modifier le
                 comportement de tri en utilisant ces valeurs :
                 
                 Type de drapeaux de tri : <info>SORT_REGULAR</info> - compare items normally; the details are
                 described in the comparison operators section<info>SORT_NUMERIC</info> - compare les éléments
                 numériquement<info>SORT_STRING</info> - compare les éléments comme des chaînes de
                 caractères<info>SORT_LOCALE_STRING</info> - compare les éléments comme des chaînes de
                 caractères, basé sur la locale courante. Ceci utilise la locale, qui peut être
                 changée en utilisant <strong>setlocale()</strong> <info>SORT_NATURAL</info> - compare les éléments comme des
                 chaînes de caractères utilisant "l'ordre naturel" comme <strong>natsort()</strong> <info>SORT_FLAG_CASE</info> -
                 peut être combiné (OU bit à bit) avec <info>SORT_STRING</info> ou <info>SORT_NATURAL</info> pour trier les
                 chaînes sans tenir compte de la casse
                 
                 <info>SORT_REGULAR</info> - compare items normally; the details are described in the comparison
                 operators section
                 
                 <info>SORT_NUMERIC</info> - compare les éléments numériquement
                 
                 <info>SORT_STRING</info> - compare les éléments comme des chaînes de caractères
                 
                 <info>SORT_LOCALE_STRING</info> - compare les éléments comme des chaînes de caractères, basé sur
                 la locale courante. Ceci utilise la locale, qui peut être changée en utilisant
                 <strong>setlocale()</strong>
                 
                 <info>SORT_NATURAL</info> - compare les éléments comme des chaînes de caractères utilisant
                 "l'ordre naturel" comme <strong>natsort()</strong>
                 
                 <info>SORT_FLAG_CASE</info> - peut être combiné (OU bit à bit) avec <info>SORT_STRING</info> ou <info>SORT_NATURAL</info>
                 pour trier les chaînes sans tenir compte de la casse

<comment>Return:</comment>
  <info>true</info>  Retourne toujours <info>true</info>.

<comment>See Also:</comment>
   * <strong>sort()</strong>
   * <strong>krsort()</strong>
   * Les fonctions de tri des tableaux


id: lcfirst
type: function
doc:
<comment>Description:</comment>
  Met le premier caractère en minuscule
  
  Retourne une chaîne dont le premier caractère de <strong>$string</strong> a été mis en minuscule, si ce caractère
  est un caractère ASCII dans la plage allant de <return>"A"</return> (0x41) à <return>"Z"</return> (0x5a).

<comment>Param:</comment>
  <info>string</info>  <strong>$string</strong>  La chaîne d'entrée.

<comment>Return:</comment>
  <info>string</info>  Retourne la chaîne résultante.

<comment>See Also:</comment>
   * <strong>ucfirst()</strong>
   * <strong>strtolower()</strong>
   * <strong>strtoupper()</strong>
   * <strong>ucwords()</strong>


id: lcg_value
type: function
doc:
<comment>Description:</comment>
  Générateur de congruence combinée linéaire
  
  <strong>lcg_value()</strong> retourne un nombre pseudo aléatoire, compris entre 0 et 1. <strong>lcg_value()</strong> combine deux
  générateurs de congruence, de périodes respectives <return>2^31 - 85</return> et <return>2^31 - 249</return>. La période de cette
  fonction est le produit de ces deux nombres premiers (soit <return>(2^31 - 85)*(2^31 - 249)</return>).
  
  Cette fonction ne génère pas de valeurs cryptographiquement sûres, et ne doit pas être utilisée à
  des fins cryptographiques, ou à des fins qui exigent que les valeurs renvoyées soient
  indéchiffrables.
  
  Si de l'aléatoire cryptographiquement sûre est requis, le <class>Random\Randomizer</class> peut être utilisé avec
  le moteur <class>Random\Engine\Secure</class>. Pour des cas d'usage simple, les fonctions <strong>random_int()</strong> et
  <strong>random_bytes()</strong> fournissent une API pratique et sûre qui est qui est soutenu par le CSPRNG du
  système d'exploitation.
  
  Mettre à l'échelle la valeur de retour vers un intervalle différent en utilisant la multiplication
  ou l'addition (une transformation affine) peut entraîner un biais dans la valeur résultante car
  les nombres flottants ne sont pas également répartis sur la ligne des nombres. Comme toutes les
  valeurs ne peuvent pas être exactement représentées par un nombre flottant, le résultat de la
  transformation affine peut également donner des valeurs en dehors de l'intervalle demandé.
  
  Utilisez Random\Randomizer::getFloat pour générer un nombre flottant aléatoire dans un intervalle
  arbitraire. Utilisez Random\Randomizer::getInt pour générer un entier aléatoire dans un intervalle
  arbitraire.

<comment>Return:</comment>
  <info>float</info>  Une valeur pseudo aléatoire, dans l'intervalle de 0.0 à 1.0 inclus.

<comment>See Also:</comment>
   * Random\Randomizer::getFloat
   * Random\Randomizer::getInt
   * <strong>random_int()</strong>


id: lchgrp
type: function
doc:
<comment>Description:</comment>
  Change l'appartenance du groupe d'un lien symbolique
  
  Essaie de remplacer le groupe du lien symbolique <strong>$filename</strong> par le groupe <strong>$group</strong>.
  
  Seul le super-utilisateur peut changer le groupe d'un lien symbolique arbitrairement; les autres
  utilisateurs peuvent changer le groupe d'un lien symbolique vers un groupe auquel cet utilisateur
  est membre.

<comment>Param:</comment>
  <info>string</info>      <strong>$filename</strong>  chemin vers le lien symbolique.
  <info>string|int</info>  <strong>$group</strong>     Le groupe, spécifié par son nom ou son numéro.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>chgrp()</strong>
   * <strong>lchown()</strong>
   * <strong>chown()</strong>
   * <strong>chmod()</strong>


id: lchown
type: function
doc:
<comment>Description:</comment>
  Change le propriétaire d'un lien symbolique
  
  Essaie de remplacer le propriétaire du lien symbolique <strong>$filename</strong> par l'utilisateur <strong>$user</strong>
  
  Seul le super-utilisateur peut changer le propriétaire d'un lien symbolique.

<comment>Param:</comment>
  <info>string</info>      <strong>$filename</strong>  Chemin vers le fichier.
  <info>string|int</info>  <strong>$user</strong>      L'utilisateur, par son nom ou son numéro.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>chown()</strong>
   * <strong>lchgrp()</strong>
   * <strong>chgrp()</strong>
   * <strong>chmod()</strong>


id: ldap_8859_to_t61
type: function
doc:
<comment>Description:</comment>
  Convertit les caractères 8859 en caractères t61
  
  Convertit les caractères <return>ISO-8859</return> en caractères <return>t61</return>.
  
  Cette fonction est utile si vous devez utiliser un serveur <return>LDAPv2</return>.

<comment>Param:</comment>
  <info>string</info>  <strong>$value</strong>  Le texte à convertir.

<comment>Return:</comment>
  <info>string|false</info>  Retourne la conversion en <return>t61</return> du texte <strong>$value</strong>,  ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>ldap_t61_to_8859()</strong>


id: ldap_add
type: function
doc:
<comment>Description:</comment>
  Ajoute une entrée dans un dossier LDAP
  
  Ajoute une entrée dans un dossier LDAP.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>      Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>string</info>           <strong>$dn</strong>        Le nom DN de l'entrée LDAP.
  <info>array</info>            <strong>$entry</strong>     Un tableau avec les informations sur la nouvelle entrée. Ces valeurs
                              sont indexées individuellement. En cas de valeurs multiples pour un
                              attribut, elles sont indexées numériquement, à partir de 0.  ]]>
  <info>array|null</info>       <strong>$controls</strong>  Tableau de Contrôles LDAP à envoyer avec la requête.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>ldap_add_ext()</strong>
   * <strong>ldap_delete()</strong>


id: ldap_add_ext
type: function
doc:
<comment>Description:</comment>
  Ajoute une entrée dans un dossier LDAP
  
  Réalise la même chose que la fonction <strong>ldap_add()</strong> mais retourne une instance <class>LDAP\Result</class> à analyser
  avec <strong>ldap_parse_result()</strong>.

<comment>Return:</comment>
  <info>LDAP\Result|false</info>  Retourne une instance de <class>LDAP\Result</class>, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>ldap_add()</strong>
   * <strong>ldap_parse_result()</strong>


id: ldap_bind
type: function
doc:
<comment>Description:</comment>
  Authentification au serveur LDAP
  
  Authentification au serveur LDAP avec le RDN et le mot de passe spécifiés.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>      Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>string|null</info>      <strong>$dn</strong>        
  <info>string|null</info>      <strong>$password</strong>  

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>ldap_bind_ext()</strong>
   * <strong>ldap_unbind()</strong>


id: ldap_bind_ext
type: function
doc:
<comment>Description:</comment>
  Lie un dossier LDAP
  
  Réalise la même chose que la fonction <strong>ldap_bind()</strong> mais retourne une instance <class>LDAP\Result</class> à
  analyser avec <strong>ldap_parse_result()</strong>.

<comment>Return:</comment>
  <info>LDAP\Result|false</info>  Retourne une instance de <class>LDAP\Result</class>, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>ldap_bind()</strong>
   * <strong>ldap_parse_result()</strong>


id: ldap_close
type: function
doc:
<comment>Description:</comment>
  Alias de ldap_unbind
  
  Cette fonction est un alias de :  <strong>ldap_unbind()</strong>.


id: ldap_compare
type: function
doc:
<comment>Description:</comment>
  Compare une entrée avec des valeurs d'attributs
  
  Sert à comparer la valeur <strong>$value</strong> de l'attribut <strong>$attribute</strong> à la valeur du même attribut de l'entrée
  <strong>$dn</strong>.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>       Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>string</info>           <strong>$dn</strong>         Le DN de l'entrée LDAP.
  <info>string</info>           <strong>$attribute</strong>  Le nom de l'attribut.
  <info>string</info>           <strong>$value</strong>      La valeur comparée.
  <info>array|null</info>       <strong>$controls</strong>   Tableau de Contrôles LDAP à envoyer avec la requête.

<comment>Return:</comment>
  <info>bool|int</info>  Retourne <info>true</info> si la valeur <strong>$value</strong> correspond, sinon, retourne <info>false</info>. Retourne -1 si une
            erreur survient.


id: ldap_connect
type: function
doc:
<comment>Description:</comment>
  Connexion à un serveur LDAP
  
  À partir de PHP 8.3.0, la signature suivante est obsolète.
  
  Crée une instance <class>LDAP\Connection</class> et vérifie si l'<strong>$uri</strong> donnée est plausible.
  
  Cette fonction n'ouvre pas de connexion. Il vérifie si  les paramètres donnés sont plausibles et
  peuvent être utilisés pour ouvrir une connexion dès qu'on en a besoin.

<comment>Param:</comment>
  <info>string|null</info>  <strong>$uri</strong>   Un URI LDAP complet de la forme <return>LDAP://hostname:port</return> ou <return>LDAPS://hostname:port</return>
                      pour le chiffrement SSL.
                      
                      Vous pouvez également fournir plusieurs URI LDAP séparés par un espace comme
                      une chaîne
                      
                      Notez que <return>hostname:port</return> n'est pas un URI LDAP pris en charge car le schéma est
                      manquant.
  <info>string|null</info>  <strong>$host</strong>  Le nom d'hôte à se connecter.
  <info>int</info>          <strong>$port</strong>  Le port utilisé pour la connexion.

<comment>Return:</comment>
  <info>LDAP\Connection|false</info>  Retourne une instance de <class>LDAP\Connection</class> lorsque l'URI LDAP semble
                         plausible. Il s'agit d'un contrôle syntaxique des paramètres fournis, mais
                         le serveur(s) ne sera pas contacté !  Si la vérification syntaxique échoue,
                         elle retourne <info>false</info>. <strong>ldap_connect()</strong> retournera sinon une instance de
                         <class>LDAP\Connection</class> car elle ne se connectera pas mais initialisera uniquement
                         les paramètres de connexion. Actuellement, la connexion intervient avec le
                         prochain appel aux fonctions <return>ldap_*</return>, habituellement avec la fonction
                         <strong>ldap_bind()</strong>.
                         
                         Sans argument, alors l'instance <class>LDAP\Connection</class> de la dernière connexion
                         déjà ouverte sera retourné.

<comment>See Also:</comment>
   * <strong>ldap_bind()</strong>


id: ldap_connect_wallet
type: function
doc:
<comment>Description:</comment>
  Connect to an LDAP server
  
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Param:</comment>
  <info>string|null</info>  <strong>$uri</strong>        
  <info>string</info>       <strong>$wallet</strong>     
  <info>string</info>       <strong>$password</strong>   
  <info>int</info>          <strong>$auth_mode</strong>  

<comment>Return:</comment>
  <info>LDAP\Connection|false</info>  

<comment>See Also:</comment>
   * <strong>ldap_connect()</strong>


id: ldap_control_paged_result
type: function
doc:
<comment>Description:</comment>
  Envoi un contrôle de pagination LDAP
  
  Active la pagination LDAP en envoyant le contrôle de pagination (taille de la page, cookie,...).

<comment>Param:</comment>
  <info>resource</info>  <strong>$link</strong>        Une ressource LDAP, retourné par <strong>ldap_connect()</strong>.
  <info>int</info>       <strong>$pagesize</strong>    Le nombre d'entrées par page.
  <info>bool</info>      <strong>$iscritical</strong>  Indique si la pagination est critique ou non. Si vaut <info>true</info>, et si le
                         serveur ne supporte pas la pagination, la recherche ne retournera aucun
                         résultat.
  <info>string</info>    <strong>$cookie</strong>      Une structure opaque envoyée par le serveur
                         (<strong>ldap_control_paged_result_response()</strong>).

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>ldap_control_paged_result_response()</strong>
   * RFC2696 : Extension de contrôle LDAP pour
     une manipulation simplifiée des résultats paginés


id: ldap_control_paged_result_response
type: function
doc:
<comment>Description:</comment>
  Récupère le cookie de pagination LDAP
  
  Récupère les informations de pagination envoyées par le serveur.

<comment>Param:</comment>
  <info>resource</info>  <strong>$link</strong>       Une ressource LDAP, retourné par <strong>ldap_connect()</strong>.
  <info>resource</info>  <strong>$result</strong>     
  <info>string</info>    <strong>$cookie</strong>     Une structure opaque envoyée par le serveur.
  <info>int</info>       <strong>$estimated</strong>  Le nombre estimé d'entrées à récupérer.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>ldap_control_paged_result()</strong>
   * RFC2696 : Extension de contrôle LDAP pour
     une manipulation simplifiée des résultats paginés


id: ldap_count_entries
type: function
doc:
<comment>Description:</comment>
  Compte le nombre d'entrées après une recherche
  
  Retourne le nombre d'entrées trouvées dans le résultat <strong>$result_identifier</strong>, sur la connexion
  <strong>$link_identifier</strong>.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>    Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>LDAP\Result</info>      <strong>$result</strong>  Une instance <class>LDAP\Result</class>, retourné par <strong>ldap_list()</strong> ou <strong>ldap_search()</strong>.

<comment>Return:</comment>
  <info>int</info>  Retourne le nombre d'entrées dans le résultat, ou <info>false</info> si une erreur survient.


id: ldap_count_references
type: function
doc:
<comment>Description:</comment>
  Counts the number of references in a search result
  
  Counts the number of references in a search result.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>    Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>LDAP\Result</info>      <strong>$result</strong>  Une instance <class>LDAP\Result</class>, retourné par <strong>ldap_list()</strong> ou <strong>ldap_search()</strong>.

<comment>Return:</comment>
  <info>int</info>  Returns the number of references in a search result.

<comment>See Also:</comment>
   * <strong>ldap_connect()</strong>


id: ldap_delete
type: function
doc:
<comment>Description:</comment>
  Efface une entrée dans un dossier
  
  Efface une entrée spécifique d'un dossier LDAP.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>      Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>string</info>           <strong>$dn</strong>        Le nom DN de l'entrée LDAP.
  <info>array|null</info>       <strong>$controls</strong>  Tableau de Contrôles LDAP à envoyer avec la requête.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>ldap_delete_ext()</strong>
   * <strong>ldap_add()</strong>


id: ldap_delete_ext
type: function
doc:
<comment>Description:</comment>
  Supprime une entrée d'un dossier
  
  Réalise la même chose que la fonction <strong>ldap_delete()</strong> mais retourne une instance <class>LDAP\Result</class> à
  analyser avec <strong>ldap_parse_result()</strong>.

<comment>Return:</comment>
  <info>LDAP\Result|false</info>  Retourne une instance de <class>LDAP\Result</class>, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>ldap_delete()</strong>
   * <strong>ldap_parse_result()</strong>


id: ldap_dn2ufn
type: function
doc:
<comment>Description:</comment>
  Convertit un DN en format UFN (User Friendly Naming)
  
  Convertit le DN <strong>$dn</strong> dans un format plus lisible humainement, en supprimant les types des noms.

<comment>Param:</comment>
  <info>string</info>  <strong>$dn</strong>  Le DN de l'entrée LDAP.

<comment>Return:</comment>
  <info>string|false</info>  Retourne l'UFN,  ou <info>false</info> si une erreur survient.


id: ldap_err2str
type: function
doc:
<comment>Description:</comment>
  Convertit un numéro d'erreur LDAP en message d'erreur
  
  Retourne le message lisible expliquant l'erreur dont le numéro est <strong>$errno</strong>. Bien que les numéros
  d'erreur LDAP soient standardisés, différentes bibliothèques retournent des messages différents ou
  même des textes d'erreur localisés. N'utilisez jamais les messages d'erreur pour identifier une
  erreur, mais bien les numéros.

<comment>Param:</comment>
  <info>int</info>  <strong>$errno</strong>  Le numéro de l'erreur.

<comment>Return:</comment>
  <info>string</info>  Retourne le message d'erreur, sous la forme d'une chaîne de caractères.

<comment>See Also:</comment>
   * <strong>ldap_errno()</strong>
   * <strong>ldap_error()</strong>


id: ldap_errno
type: function
doc:
<comment>Description:</comment>
  Retourne le numéro d'erreur LDAP de la dernière commande exécutée
  
  Retourne le numéro d'erreur standard, généré par la dernière commande LDAP, pour la connexion
  <strong>$link_identifier</strong>. Ce numéro peut être converti en message textuel avec <strong>ldap_err2str()</strong>.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>  Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.

<comment>Return:</comment>
  <info>int</info>  Retourne le numéro d'erreur LDAP généré par la dernière commande.

<comment>See Also:</comment>
   * <strong>ldap_err2str()</strong>
   * <strong>ldap_error()</strong>


id: ldap_error
type: function
doc:
<comment>Description:</comment>
  Retourne le message LDAP de la dernière commande LDAP
  
  Retourne le message d'erreur lié à la connexion <strong>$ldap</strong>. Même si les numéros d'erreur LDAP sont
  standardisés, différentes bibliothèques retournent différents messages, ou parfois, des messages
  en langue locale. Ne vous fiez pas au message d'erreur, mais bien au numéro d'erreur.
  
  À moins que vous n'abaissiez suffisamment le niveau d'erreur dans php.ini, ou que vous ne
  préfixiez vos commandes LDAP avec <return>@</return> pour supprimer les affichages, les erreurs LDAP s'afficheront
  aussi dans la sortie HTML.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>  Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.

<comment>Return:</comment>
  <info>string</info>  Retourne un message d'erreur LDAP.

<comment>See Also:</comment>
   * <strong>ldap_err2str()</strong>
   * <strong>ldap_errno()</strong>


id: ldap_escape
type: function
doc:
<comment>Description:</comment>
  Échappe une chaîne pour l'utiliser dans un filtre LDAP ou un DN
  
  Échappe la chaîne <strong>$value</strong> pour l'utiliser dans le contexte impliqué par le paramètre <strong>$flags</strong>.

<comment>Param:</comment>
  <info>string</info>  <strong>$value</strong>   La valeur à échapper.
  <info>string</info>  <strong>$ignore</strong>  Les caractères à ignorer pendant l'échappement.
  <info>int</info>     <strong>$flags</strong>   Le contexte dans lequel la chaîne échappée sera utilisée : <info>LDAP_ESCAPE_FILTER</info>
                   pour les filtres à utiliser avec <strong>ldap_search()</strong>, ou <info>LDAP_ESCAPE_DN</info> pour les DNs.
                   Si aucun drapeau n'est passé, tous les caractères sont échappés.

<comment>Return:</comment>
  <info>string</info>  Retourne la chaîne échappée.


id: ldap_exop
type: function
doc:
<comment>Description:</comment>
  Performs an extended operation
  
  Performs an extended operation on the specified <strong>$ldap</strong> with <strong>$request_oid</strong> the OID of the operation
  and <strong>$request_data</strong> the data.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>           Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>string</info>           <strong>$request_oid</strong>    The extended operation request OID. You may use one of
                                   <info>LDAP_EXOP_START_TLS</info>, <info>LDAP_EXOP_MODIFY_PASSWD</info>, <info>LDAP_EXOP_REFRESH</info>,
                                   <info>LDAP_EXOP_WHO_AM_I</info>, <info>LDAP_EXOP_TURN</info>, or a string with the OID of
                                   the operation you want to send.
  <info>string</info>           <strong>$request_data</strong>   The extended operation request data. May be NULL for some
                                   operations like <info>LDAP_EXOP_WHO_AM_I</info>, may also need to be BER
                                   encoded.
  <info>array</info>            <strong>$controls</strong>       Array of LDAP Controls to send with the request.
  <info>string</info>           <strong>$response_data</strong>  Will be filled with the extended operation response data if
                                   provided. If not provided you may use ldap_parse_exop on the
                                   result object later to get this data.
  <info>string</info>           <strong>$response_oid</strong>   Will be filled with the response OID if provided, usually equal
                                   to the request OID.

<comment>Return:</comment>
  <info>mixed</info>  When used with <strong>$response_data</strong>, returns <info>true</info> on success or <info>false</info> on error. When used without
         <strong>$response_data</strong>, returns a result identifier or <info>false</info> on error.

<comment>See Also:</comment>
   * <strong>ldap_parse_result()</strong>
   * <strong>ldap_parse_exop()</strong>
   * <strong>ldap_exop_whoami()</strong>
   * <strong>ldap_exop_refresh()</strong>
   * <strong>ldap_exop_passwd()</strong>


id: ldap_exop_passwd
type: function
doc:
<comment>Description:</comment>
  PASSWD extended operation helper
  
  Performs a PASSWD extended operation.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>          Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>string</info>           <strong>$user</strong>          dn of the user to change the password of.
  <info>string</info>           <strong>$old_password</strong>  The old password of this user. May be ommited depending of server
                                  configuration.
  <info>string</info>           <strong>$new_password</strong>  The new password for this user. May be omitted or empty to have a
                                  generated password.
  <info>array</info>            <strong>$controls</strong>      If provided, a password policy request control is send with the
                                  request and this is filled with an array of LDAP Controls returned
                                  with the request.

<comment>Return:</comment>
  <info>string|bool</info>  Returns the generated password if <strong>$new_password</strong> is empty or omitted. Otherwise
               returns <info>true</info> on success and <info>false</info> on failure.

<comment>See Also:</comment>
   * <strong>ldap_exop()</strong>
   * <strong>ldap_parse_exop()</strong>


id: ldap_exop_refresh
type: function
doc:
<comment>Description:</comment>
  Refresh extended operation helper
  
  Performs a Refresh extended operation and returns the data.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>  Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>string</info>           <strong>$dn</strong>    dn of the entry to refresh.
  <info>int</info>              <strong>$ttl</strong>   Time in seconds (between 1 and 31557600) that the client requests that the
                          entry exists in the directory before being automatically removed.

<comment>Return:</comment>
  <info>int|false</info>  From RFC: The responseTtl field is the time in seconds which the server chooses to have
             as the time-to-live field for that entry.  It must not be any smaller than that which
             the client requested, and it may be larger. However, to allow servers to maintain a
             relatively accurate directory, and to prevent clients from abusing the dynamic
             extensions, servers are permitted to shorten a client-requested time-to-live value,
             down to a minimum of 86400 seconds (one day).
              <info>false</info> will be returned on error.

<comment>See Also:</comment>
   * <strong>ldap_exop()</strong>


id: ldap_exop_sync
type: function
doc:
<comment>Description:</comment>
  Performs an extended operation
  
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>           Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>string</info>           <strong>$request_oid</strong>    
  <info>string</info>           <strong>$request_data</strong>   
  <info>array</info>            <strong>$controls</strong>       
  <info>string</info>           <strong>$response_data</strong>  
  <info>string</info>           <strong>$response_oid</strong>   

<comment>Return:</comment>
  <info>LDAP\Result|bool</info>  

<comment>See Also:</comment>
   * <strong>ldap_exop()</strong>


id: ldap_exop_whoami
type: function
doc:
<comment>Description:</comment>
  WHOAMI extended operation helper
  
  Performs a WHOAMI extended operation and returns the data.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>  Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.

<comment>Return:</comment>
  <info>string|false</info>  The data returned by the server, or <info>false</info> on error.

<comment>See Also:</comment>
   * <strong>ldap_exop()</strong>


id: ldap_explode_dn
type: function
doc:
<comment>Description:</comment>
  Sépare les différents composants d'un DN
  
  Sert à extraire les différents composants du DN <strong>$dn</strong>. Chaque composant s'appelle un Nom Distingué
  Relatif (Relative Distinguished Name ou encore RDN).

<comment>Param:</comment>
  <info>string</info>  <strong>$dn</strong>           Le nom DN de l'entrée LDAP.
  <info>int</info>     <strong>$with_attrib</strong>  Sert à préciser si les RDN sont retournés seuls, ou bien avec leurs
                        attributs. Pour obtenir les attributs en même temps que les RDN (au format
                        attribut=valeur), donnez à <strong>$with_attrib</strong> la valeur de <return>0</return> et, sinon, donnez lui
                        la valeur de <return>1</return>.

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau de tous les composants DN,  ou <info>false</info> si une erreur survient. Le
               premier élément du tableau a une clé <return>count</return> et représente le nombre de valeurs
               retournées ; les autres éléments sont les composants DN indexés numériquement.


id: ldap_first_attribute
type: function
doc:
<comment>Description:</comment>
  Retourne le premier attribut
  
  Retourne le premier attribut de l'entrée fournie. Les autres attributs sont lus grâce à la
  fonction <strong>ldap_next_attribute()</strong>, appelée aussi souvent que nécessaire.
  
  Similairement à la lecture des entrées, les attributs sont lus les uns après les autres, pour une
  entrée.

<comment>Param:</comment>
  <info>LDAP\Connection</info>   <strong>$ldap</strong>   Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>LDAP\ResultEntry</info>  <strong>$entry</strong>  Une instance <class>LDAP\ResultEntry</class>.

<comment>Return:</comment>
  <info>string|false</info>  Retourne le premier attribut de l'entrée en cas de succès, et <info>false</info> si une erreur
                survient.

<comment>See Also:</comment>
   * <strong>ldap_next_attribute()</strong>
   * <strong>ldap_get_attributes()</strong>


id: ldap_first_entry
type: function
doc:
<comment>Description:</comment>
  Retourne la première entrée
  
  Retourne la première entrée du résultat. Celles qui suivent seront lues grâce à la fonction
  <strong>ldap_next_entry()</strong>, en l'appelant aussi souvent que nécessaire.
  
  Les entrées d'un résultat LDAP sont lues séquentiellement avec les fonctions <strong>ldap_first_entry()</strong> et
  <strong>ldap_next_entry()</strong>.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>    Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>LDAP\Result</info>      <strong>$result</strong>  Une instance <class>LDAP\Result</class>, retourné par <strong>ldap_list()</strong> ou <strong>ldap_search()</strong>.

<comment>Return:</comment>
  <info>LDAP\ResultEntry|false</info>  Retourne une instance de <class>LDAP\ResultEntry</class>, ou <info>false</info> si une erreur
                          survient.

<comment>See Also:</comment>
   * <strong>ldap_get_entries()</strong>


id: ldap_first_reference
type: function
doc:
<comment>Description:</comment>
  Retourne la première référence
  
  Cette fonction est actuellement non documentée ; seule la liste des arguments est disponible.

<comment>Return:</comment>
  <info>LDAP\ResultEntry|false</info>  


id: ldap_free_result
type: function
doc:
<comment>Description:</comment>
  Libère la mémoire du résultat
  
  Libère toute la mémoire allouée en interne pour stocker le résultat <strong>$result_identifier</strong>. Si l'appel
  de cette fonction est omis, toute la mémoire sera libérée automatiquement à la fin du script.
  
  Typiquement, toute la mémoire allouée pour le résultat LDAP est libérée à la fin du script. Si le
  script effectue des recherches intensives, qui retournent des résultats de grandes taille,
  <strong>ldap_free_result()</strong> peut être utilisée pour réduire la consommation de mémoire.

<comment>Param:</comment>
  <info>LDAP\Result</info>  <strong>$result</strong>  Une instance <class>LDAP\Result</class>, retourné par <strong>ldap_list()</strong> ou <strong>ldap_search()</strong>.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.


id: ldap_get_attributes
type: function
doc:
<comment>Description:</comment>
  Lit les attributs d'une entrée
  
  Lit les attributs et les valeurs pour une entrée d'un résultat de recherche.
  
  Une fois que vous avez repéré une entrée dans un dossier, vous pouvez obtenir plus d'informations
  sur elle avec cette fonction. Elle pourrait être utilisée dans le cadre d'une application qui
  cartographie les dossiers et les entrées. Dans de nombreuses applications, vous recherchez des
  entrées ayant un attribut précis, sans vous soucier des autres attributs.

<comment>Param:</comment>
  <info>LDAP\Connection</info>   <strong>$ldap</strong>   Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>LDAP\ResultEntry</info>  <strong>$entry</strong>  Une instance <class>LDAP\ResultEntry</class>.

<comment>Return:</comment>
  <info>array</info>  Retourne le détail des informations d'une entrée sous la forme d'un tableau
         multidimensionnel.

<comment>See Also:</comment>
   * <strong>ldap_first_attribute()</strong>
   * <strong>ldap_next_attribute()</strong>


id: ldap_get_dn
type: function
doc:
<comment>Description:</comment>
  Lit le DN d'une entrée
  
  Lit le DN d'une entrée d'un résultat.

<comment>Param:</comment>
  <info>LDAP\Connection</info>   <strong>$ldap</strong>   Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>LDAP\ResultEntry</info>  <strong>$entry</strong>  Une instance <class>LDAP\ResultEntry</class>.

<comment>Return:</comment>
  <info>string|false</info>  Retourne le DN de l'entrée du résultat, ou <info>false</info> si une erreur survient.


id: ldap_get_entries
type: function
doc:
<comment>Description:</comment>
  Lit toutes les entrées du résultat
  
  Lit toutes les entrées du résultat fourni, ainsi que les attributs et les valeurs multiples.

<comment>Param:</comment>
  <info>LDAP\Connection</info>  <strong>$ldap</strong>    Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>LDAP\Result</info>      <strong>$result</strong>  Une instance <class>LDAP\Result</class>, retourné par <strong>ldap_list()</strong> ou <strong>ldap_search()</strong>.

<comment>Return:</comment>
  <info>array|false</info>  Retourne toutes les entrées du résultat sous la forme d'un tableau multidimensionnel,
               ou <info>false</info> si une erreur survient.
               
               La structure du tableau est la suivante. L'index d'attribut est converti en
               minuscules (les attributs sont sensibles à la casse pour les serveurs de dossiers,
               mais ne le sont pas lorsqu'ils sont utilisés comme index de tableaux).

<comment>See Also:</comment>
   * <strong>ldap_first_entry()</strong>
   * <strong>ldap_next_entry()</strong>


id: ldap_get_option
type: function
doc:
<comment>Description:</comment>
  Lit/écrit la valeur courante d'une option
  
  Définit la valeur <strong>$value</strong> à l'option spécifié.

<comment>Param:</comment>
  <info>LDAP\Connection</info>   <strong>$ldap</strong>    Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>int</info>               <strong>$option</strong>  Le paramètre <strong>$option</strong> peut prendre l'une des valeurs suivantes :
                             OptionTypeDisponible
                             depuis<info>LDAP_OPT_DEREF</info><info>int</info><info>LDAP_OPT_SIZELIMIT</info><info>int</info><info>LDAP_OPT_TIMELIMIT</info><info>int</info><info>LDAP_OPT_NETWORK_TIMEOUT</info><info>int</info><info>LDAP_OPT_PROTOCOL_VERSION</info><info>int</info><info>LDAP_OPT_ERROR_NUMBER</info><info>int</info><info>LDAP_OPT_DIAGNOSTIC_MESSAGE</info><info>string</info><info>LDAP_OPT_REFERRALS</info><info>int</info><info>LDAP_OPT_RESTART</info><info>int</info><info>LDAP_OPT_HOST_NAME</info><info>string</info><info>LDAP_OPT_ERROR_STRING</info><info>string</info><info>LDAP_OPT_MATCHED_DN</info><info>string</info><info>LDAP_OPT_SERVER_CONTROLS</info><info>array</info><info>LDAP_OPT_CLIENT_CONTROLS</info><info>array</info><info>LDAP_OPT_X_KEEPALIVE_IDLE</info><info>int</info>7.1<info>LDAP_OPT_X_KEEPALIVE_PROBES</info><info>int</info>7.1<info>LDAP_OPT_X_KEEPALIVE_INTERVAL</info><info>int</info>7.1<info>LDAP_OPT_X_TLS_CACERTDIR</info>string7.1<info>LDAP_OPT_X_TLS_CACERTFILE</info><info>string</info>7.1<info>LDAP_OPT_X_TLS_CERTFILE</info><info>string</info>7.1<info>LDAP_OPT_X_TLS_CIPHER_SUITE</info><info>string</info>7.1<info>LDAP_OPT_X_TLS_CRLCHECK</info><info>int</info>7.1<info>LDAP_OPT_X_TLS_CRL_NONE</info><info>int</info>7.1<info>LDAP_OPT_X_TLS_CRL_PEER</info><info>int</info>7.1<info>LDAP_OPT_X_TLS_CRL_ALL</info><info>int</info>7.1<info>LDAP_OPT_X_TLS_CRLFILE</info><info>string</info>7.1<info>LDAP_OPT_X_TLS_DHFILE</info><info>string</info>7.1<info>LDAP_OPT_X_TLS_KEYFILE</info><info>string</info>7.1<info>LDAP_OPT_X_TLS_PACKAGE</info><info>string</info>7.1<info>LDAP_OPT_X_TLS_PROTOCOL_MIN</info><info>int</info>7.1<info>LDAP_OPT_X_TLS_RANDOM_FILE</info><info>string</info>7.1<info>LDAP_OPT_X_TLS_REQUIRE_CERT</info><info>int</info>
  <info>array|string|int</info>  <strong>$value</strong>   Valeur à définir pour l'option.

<comment>Return:</comment>
  <info>bool</info>  Cette fonction retourne <info>true</info> en cas de succès ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>ldap_set_option()</strong>


id: ldap_get_values
type: function
doc:
<comment>Description:</comment>
  Lit toutes les valeurs d'une entrée LDAP
  
  Lit toutes les valeurs de l'attribut d'une entrée dans un résultat.
  
  L'appel de cette fonction requiert une <strong>$entry</strong> et doit donc être précédée d'une recherche LDAP, et
  de l'une des fonctions permettant d'accéder à une entrée.
  
  Votre application doit contenir des informations permettant de lire certains attributs (comme
  "nom" ou "mail"), ou bien vous devrez utiliser la fonction <strong>ldap_get_attributes()</strong> pour savoir quels
  sont les attributs qui existent pour une entrée donnée.

<comment>Param:</comment>
  <info>LDAP\Connection</info>   <strong>$ldap</strong>       Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>LDAP\ResultEntry</info>  <strong>$entry</strong>      Une instance <class>LDAP\ResultEntry</class>.
  <info>string</info>            <strong>$attribute</strong>  

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau de valeurs pour l'attribut, ou <info>false</info> en cas d'erreur. Le nombre
               de valeurs retournées est disponible à l'index 'count' du tableau retourné. Les
               valeurs sont accessibles individuellement, avec les index numériques du tableau.
               L'indexation commence à <return>0</return>.
               
               LDAP permet plus d'une entrée par attribut, ce qui permet de stocker plusieurs
               adresses emails par personne, tout en n'utilisant qu'une étiquette "mail" :
               return_value["count"] = nombre de valeurs de l'attribut return_value[0] = première
               valeur de l'attribut return_value[i] = i-ième valeur de l'attribut

<comment>See Also:</comment>
   * <strong>ldap_get_values_len()</strong>


id: ldap_get_values_len
type: function
doc:
<comment>Description:</comment>
  Lit toutes les valeurs binaires d'une entrée
  
  Lit toutes les valeurs binaires d'une entrée d'un résultat.
  
  Cette fonction s'utilise exactement comme la fonction <strong>ldap_get_values()</strong>, hormis le fait qu'elle
  gère les données binaires, et non les chaînes de caractères.

<comment>Param:</comment>
  <info>LDAP\Connection</info>   <strong>$ldap</strong>       Une instance <class>LDAP\Connection</class>, retourné par <strong>ldap_connect()</strong>.
  <info>LDAP\ResultEntry</info>  <strong>$entry</strong>      Une instance <class>LDAP\ResultEntry</class>.
  <info>string</info>            <strong>$attribute</strong>  

<comment>Return:</comment>
  <info>array|false</info>  Retourne un tableau de valeurs pour l'attribut en cas de succès, et <info>false</info> en cas
               d'erreur. Les valeurs sont accessibles individuellement, avec les index numériques du
               tableau. L'indexation commence à <return>0</return>. Le nombre de valeurs retournées est disponible à
               l'index 'count' du tableau retourné.

<comment>See Also:</comment>
   * <strong>ldap_get_values()</strong>


id: ldap_list
type: function
doc:
<comment>Description:</comment>
  Recherche dans un niveau
  
  Effectue une recherche avec le filtre <strong>$filter</strong> dans le dossier <strong>$base_dn</strong> avec l'option
  <info>LDAP_SCOPE_ONELEVEL</info>.
  
  <info>LDAP_SCOPE_ONELEVEL</info> signifie que la recherche ne peut retourner des entrées que dans le niveau qui
  est immédiatement sous le niveau <strong>$base</strong> (c'est l'équivalent de la commande ls, pour obtenir la
  liste des fichiers et dossiers du dossier courant).
  
  Il est également possible d'effectuer des recherches parallèles. Dans ce cas, le premier argument
  doit être un tableau des
  instances de <class>LDAP\Connection</class>, plutôt qu'une seule.
  Si les recherches ne devraient pas utiliser le même nom distingué (DN) de base et filtre, un
  tableau de DN de base et/ou un tableau de filtre peuvent être passé comme arguments à la place.
  Ces tableaux doivent être de la même taille que le tableau des instances de <class>LDAP\Connection</class>,
  
  puisque les premières entrées des tableaux sont utilisées pour une recherche, les secondes pour
  une autre, et ainsi de suite.
  Lors de recherches parallèles, un tableau des instances de <class>LDAP\Result</class> est retourné, sauf en cas
  d'erreur, où la valeur de retour sera <info>false</info>.

<comment>Param:</comment>
  <info>LDAP\Connection|array</info>  <strong>$ldap</strong>             Une instance <class>LDAP\Connection</class>, retourné par
                                           <strong>ldap_connect()</strong>.
  <info>array|string</info>           <strong>$base</strong>             La base DN du dossier.
  <info>array|string</info>           <strong>$filter</strong>           
  <info>array</info>                  <strong>$attributes</strong>       Un tableau d'attributs requis, e.g. array("mail", "sn",
                                           "cn"). Notez que le "dn" est toujours retourné, quelque
                                           soit le type de l'attribut demandé.
                                           
                                           L'utilisation de ce paramètre est plus efficace que
                                           l'action par défaut (qui est de retourner tous les
                                           attributs ainsi que leurs valeurs associées).
                                           L'utilisation de ce paramètre doit pour cette raison être
                                           considéré comme une bonne pratique.
  <info>int</info>                    <strong>$attributes_only</strong>  Doit être défini à <return>1</return> si seuls les types des attributs
                                           sont demandés. S'il est défini à <return>0</return>, les types et les
                                           valeurs des attributs sont récupérés, ce qui correspond
                                           au comportement par défaut.
  <info>int</info>                    <strong>$sizelimit</strong>        Vous permet de limiter le nombre d'entrées à récupérer.
                                           Le fait de définir ce paramètre à <return>0</return> signifie qu'il n'y
                                           aura aucune limite.
                                           
                                           Ce paramètre ne peut pas écraser la configuration côté
                                           serveur. Vous pouvez cependant positionner une valeur
                                           inférieure.
                                           
                                           Quelques dossiers serveurs peuvent être configurés afin
                                           de ne retourner qu'un nombre d'entrées données. Si ce
                                           comportement survient, le serveur indique qu'il n'a
                                           retourné qu'un jeu de résultats partiel. Ce comportement
                                           intervient également si vous utilisez ce paramètre pour
                                           limiter le nombre d'entrées récupérées.
  <info>int</info>                    <strong>$timelimit</strong>        Définit le nombre maximal de secondes permis pour la
                                           recherche. Le fait de définir ce paramètre à <return>0</return> signifie
                                           qu'il n'y a pas de limite.
                                           
                                           Ce paramètre ne peut pas écraser la configuration côté
                                           serveur mais vous pouvez l'utiliser pour être plus
                                           restrictif.
  <info>int</info>                    <strong>$deref</strong>            Spécifie le nombre d'alias qui doivent être gérés pendant
                                           la recherche. Il peut être un parmi les suivants :
                                           <info>LDAP_DEREF_NEVER</info> - (défaut) les alias ne sont jamais
                                           déréférencés. <info>LDAP_DEREF_SEARCHING</info> - les alias doivent
                                           être déréférencés pendant la recherche mais pas lors de
                                           la localisation de l'objet de base de la recherche.
                                           <info>LDAP_DEREF_FINDING</info> - les alias doivent être déréférencés
                                           lors de la localisation de l'objet de base mais pas
                                           durant la recherche. <info>LDAP_DEREF_ALWAYS</info> - les alias
                                           doivent toujours être déréférencés.
                                           
                                           <info>LDAP_DEREF_NEVER</info> - (défaut) les alias ne sont jamais
                                           déréférencés.
                                           
                                           <info>LDAP_DEREF_SEARCHING</info> - les alias doivent être
                                           déréférencés pendant la recherche mais pas lors de la
                                           localisation de l'objet de base de la recherche.
                                           
                                           <info>LDAP_DEREF_FINDING</info> - les alias doivent être déréférencés
                                           lors de la localisation de l'objet de base mais pas
                                           durant la recherche.
                                           
                                           <info>LDAP_DEREF_ALWAYS</info> - les alias doivent toujours être
                                           déréférencés.
  <info>array|null</info>             <strong>$controls</strong>         Tableau de Contrôles LDAP à envoyer avec la requête.

<comment>Return:</comment>
  <info>LDAP\Result|array|false</info>  Retourne une instance de <class>LDAP\Result</class>, un tableau des instances de
                           <class>LDAP\Result</class>, ou <info>false</info> si une erreur survient.

<comment>See Also:</comment>
   * <strong>ldap_search()</strong>


