PHPBuilder.com, the best resource for PHP tutorials, templates, PHP manuals, content management systems, scripts, classes and more.

Index: phpdoc/fr/functions/zlib.xml diff -u phpdoc/fr/functions/zlib.xml:1.1 phpdoc/fr/functions/zlib.xml:1.2 --- phpdoc/fr/functions/zlib.xml:1.1 Fri Jul 21 03:27:50 2000 +++ phpdoc/fr/functions/zlib.xml Mon Oct 30 05:45:00 2000 @@ -1,525 +1,616 @@ - - Compression - Zlib - - - Ce module utilise les fonctions de la librairie zlib - (zlib) de Jean-loup Gailly et Mark Adler pour - lire et écrire, de manière transparente, des fichiers compressés avec gzip (.gz). - Il faut utiliser la librairie zlib, de version >= 1.0.9. - - - Ce module contient des versions de la plus part des fonctions du chapitre - système de fichier. Mais celles-ci - fonctionnent non seulement avec des fichiers compressés, mais aussi des fichiers - décompressés (hormis les fonctions utilisant les sockets). - - - - Petit exemple - - Ouvre un fichier temporaire, écrit un texte et puis affiche deux fois le contenu. - - - - Petit exemple - -<?php - $filename = tempnam('/tmp', 'zlibtest').'.gz'; - print "<html>\n<head></head>\n<body>\n<pre>\n"; - $s = "Only a test, test, test, test, test, test, test, test!\n"; - // ouvre un fichier en écriture, avec compression maximale - $zp = gzopen($filename, "w9"); - // écrit la chaîne dans le fichier - gzwrite($zp, $s); - // ferme le fichier - gzclose($zp); - // ouvre en lecture - $zp = gzopen($filename, "r"); - // lis 3 caractères - print gzread($zp, 3); - // Affiche le reste du fichier - gzpassthru($zp); - print "\n"; - // ouvre le fichier, et affiche le contenu (deuxième passe) - if (readgzfile($filename) != strlen($s)) { - echo "Error with zlib functions!"; - } - unlink($filename); - print "<pre>\n</h1></body>\n</html>\n"; -?> - - - - - - - - gzclose - Ferme un pointeur sur un fichier compressé. - - - Description - - int gzclose - int zp - - - gzclose ferme le pointeur zp. - - - - Retourne TRUE ou FALSE, suivant le succès ou l'echec. - - - - Le pointeur de fichier compressé doit être valide, et doit référencer un - fichier qui a été ouvert par gzopen. - - - - - - - - - gzeof - Teste la fin d'un fichier compressé. - - - Description - - int gzeof - int zp - - - Retourne TRUE si le pointeur interne du fichier compressé est à la fin du fichier, - sinon retourne FALSE. - - - - Le pointeur de fichier compressé doit être valide, et doit référencer un - fichier qui a été ouvert par gzopen. - - - - - - - - - gzfile - Lit la totalité d'un fichier compressé dans un tableau. - - - Description - - array gzfile - string filename - int use_include_path - - - Identique à readgzfile, mais gzfile - retourne un tableau. - - - - Vous pouvez aussi utiliser le deuxième paramètre optionnel en le mettant à "1", si - vous voulez rechercher le fichier dans le dossier - include_path. - - - - Voir aussi readgzfile, et gzopen. - - - - - - - - gzgetc - Lit un caractère d'un fichier compressé. - - - Description - - string gzgetc - int zp - - - Retourne une chaîne décompressée, qui contient un caractère unique, lu depuis le - fichier référencé par le pointeur zp. Retourne FALSE - à la fin du fichier (voir gzeof). - - -Le pointeur de fichier compressé doit être valide, et doit référencer un fichier qui a été ouvert par gzopen. - - Voir aussi - gzopen, et - gzgets. - - - - - - - - gzgets - Lit une ligne d'un fichier compressé - - - Description - - string gzgets - int zp - int length - - - -Retourne une chaîne décompressée, de longueur inférieure ou égale à length - 1 octets, lue depuis de fichier référencé par le pointeur de fichier fp. La lecture s'interromp lorsque length - 1 octets ont été lus, ou bien lorsqu'une nouvelle ligne a été rencontrée, ou bien lorsque la fin du fichier a été atteinte. - - - Si une erreur survient, retourne false. - - Le pointeur de fichier compressé doit être valide, et doit référencer un fichier qui a été ouvert par -gzopen. - - Voir aussi gzopen, - gzgetc, et fgets. - - - - - - - - gzgetss - Lit une ligne d'un fichier compressé et supprime les balises HTML - - - Description - - string gzgetss - int zp - int length - string allowable_tags - - -Identique à gzgets, mais gzgetss essaie de supprimer toutes -les balises HTML et PHP du texte lu. - - - Vous pouvez utiliser le troisième argument optionnel pour indiquer les balises qui -ne doivent pas être supprimées. - - - allowable_tags a été ajouté dans PHP 3.0.13, PHP4B3. - - - - Voir aussi gzgets, - gzopen, et strip_tags. - - - - - - - - gzopen - Ouvre un fichier compressé - - - Description - - int gzopen - string filename - string mode - int use_include_path - - -Ouvre un fichier compressé avec gzip (.gz) pour le lire ou l'écrire. -Le paramètre de mode est le même que dans fopen ("rb" ou "wb") -mais il peut aussi inclure un niveau de compression ("wb9") ou une stratégie: 'f' pour les données filtrées, comme dans "wb6f", 'h' pour Huffman seul , comme dans "wb1h". (Voir la description de deflateInit2 dans zlib.h pour plus de détails a propos des paramètres de stratégie). - - - -Gzopen peut être utilisé pour ouvrir des fichiers qui ne sont pas au format gzip; -dans ce cas, gzread lira directement le fichier, sans appliquer de décompression. - - - -Gzopen retourne un pointeur de fichier sur le fichier ouvert. Ce pointeur sera nécessaire pour toutes les opérations ultérieures sur ce fichier. Les opéraitions de compression/décompression seront transparaentes. - - - Si l'ouverture échoue, la fonction retourne FALSE. - - - You can use the optional third parameter and set it to "1", if - you want to search for the file in the include_path, too. - - - Exemple gzopen() - -$fp = gzopen("/tmp/file.gz", "r"); - - - - Voir aussi gzclose. - - - - - - - - gzpassthru - Lit toutes les informations restantes d'un fichier compressé - - - Description - - int gzpassthru - int zp - - -Lit toutes les informations d'un fichier compressé jusqu'à EOF et écrit le résultat décompressé dans la sortie standard. - - - - Si une erreur survient, retourne FALSE. - - -Le pointeur de fichier doit être valide, et avoir été ouvert par gzopen. - - -Le fichier pointé est refermé par gzpassthru ce qui le rends inutilisable -pour les opérations ultérieures. - - - - - - - - gzputs - Ecrit dans un fichier compressé - - - Description - - int gzputs - int zp - string str - int length - - - - gzputsest un alias de gzwrite, et lui est identique en tous points. - - - - - - - - gzread - Lit un fichier compressé en mode binaire - - - Description - - string gzread - int zp - int length - - - gzread lit jusqu'à length octets -depuis le fichier compressé référencé par zp. La -lecture stoppe lorsque length octets décompressés ont été lus, -ou que la fin du fichier a été trouvée. - - - - - -// lis le contenu d'un fichier compressé et le met dans une chaîne -$filename = "/usr/local/something.txt.gz"; -$zd = gzopen( $filename, "r" ); -$contents = gzread( $zd, 10000 ); -gzclose( $zd ); - - - - - Voir aussi gzwrite, gzopen, - gzgets, gzgetss, - gzfile, et gzpassthru. - - - - - - - gzrewind - Replace le pointeur courant au début du fichier - - - Description - - int gzrewind - int zp - - Positionne le pointeur interne du fichier au début du fichier compressé. - - Si une erreur survient, retourne 0. - Le pointeur de fichier doit être valide, et avoir été retourné par la fonction gzopen. - - Voir aussi gzseek et gztell. - - - - - - - gzseek - Déplace le pointeur courant dans un fichier compressé - - - Description - - int gzseek - int zp - int offset - - - Positionne le pointeur interne du fichier compressé zp à la position donnée en offset. Equivalent à l'appel (en C) de -gzseek( zp, offset, SEEK_SET ). - - -Si le fichier est ouvert en lecture seule, cette fonction émulée peut être extrêmement lente. Si le fichier est ouvert en lecture, seul le déplacement avant (forward seek) sont acceptés. gzseek compresse alors une séquence de zéro jusqu'à la nouvelle position. - - - -Retourne 0 en cas de succès, sinon retourne -1. Notez positionner le pointeur au delà de la fin du fichier est une erreur. - - - Voir aussi gztell et - gzrewind. - - - - - - - - gztell - Retourne la position courante du pointeur interne - - - Description - - int gztell - int zp - - -Retourne la position du pointeur interne du fichier référencé par zp, i.e., son offset en octets depuis le début du fichier. - - -Si une erreur survient, retourne FALSE. - - -Le pointeur de fichier doit être valide, et doit avoir été retourné par la fonction gzopen. - - Voir aussi gzopen, - gzseek et gzrewind. - - - - - - - gzwrite - Ecrit un fichier compressé en mode binaire - - - Description - - int gzwrite - int zp - string string - int length - - - gzwrite écrit le contenu de la chaîne string dans -le fichier compressé référencé par le pointeur zp. -Si l'argument length est donné, l'écriture cessera après avoir -écrit length octets (non compressé), ou bien si -la fin de la chaîne a été atteinte. - - - -Notez que si l'argument length est donnée, alors -l'option magic_quotes_runtime - sera ignorée et les slashes ne seront pas supprimés de la chaîne string. - - - Voir aussi gzread, gzopen, - et gzputs. - - - - - - readgzfile - Affiche un fichier compressé - - - Description - - int readgzfile - string filename - int use_include_path - - Lit un fichier, le décompresse et l'écrit dans la sortie standard. - - - Readgzfile() peut être utilisé pour lire un fichier qui n'est pas au format gzip, car dans ce cas, la décompression est omise, et le fichier est directement affiché. - - Retourne le nombre d'octets (non compressé) lus depuis le fichier. -Si une erreur survient, retourne FALSE, et à moins que la fonction n'ai été appelée -avec <email protected>, l'erreur est affichée. - - Le fichier filename sera ouvert et son contenu sera écrit danas la sortie standard. - - - - Vous pouvez utiliser le paramètre optionnel en le mettant à "1", si vous -voulez rechercher le fichier dans le dossier include_path. - - - Voir aussi gzpassthru, - gzfile, et gzopen. - - - - - - - + + Zlib (Compression) + Zlib + + + Ce module utilise les fonctions de la librairie zlib + (zlib) de Jean-loup Gailly et Mark Adler pour + lire et écrire, de manière transparente, des fichiers + compressés avec gzip (.gz). + Il faut utiliser la librairie zlib, de version >= 1.0.9. + + + Ce module contient des versions de la plus part des fonctions du chapitre + système de fichier. + Mais celles-ci fonctionnent non seulement avec des fichiers + compressés, mais aussi des fichiers décompressés + (hormis les fonctions utilisant les sockets). + + + + Petit exemple + + Ouvre un fichier temporaire, écrit un texte et puis affiche deux + fois le contenu. + + + + Petit exemple + +<?php + $filename = tempnam('/tmp', 'zlibtest').'.gz'; + print "<html>\n<head></head>\n<body>\n<pre>\n"; + $s = "Only a test, test, test, test, test, test, test, test!\n"; + // ouvre un fichier en écriture, avec compression maximale + $zp = gzopen($filename, "w9"); + // écrit la chaîne dans le fichier + gzwrite($zp, $s); + // ferme le fichier + gzclose($zp); + // ouvre en lecture + $zp = gzopen($filename, "r"); + // lis 3 caractères + print gzread($zp, 3); + // Affiche le reste du fichier + gzpassthru($zp); + print "\n"; + // ouvre le fichier, et affiche le contenu (deuxième passe) + if (readgzfile($filename) != strlen($s)) { + echo "Error with zlib functions!"; + } + unlink($filename); + print "<pre>\n</h1></body>\n</html>\n"; +?> + + + + + + + + gzclose + Ferme un pointeur sur un fichier compressé. + + + Description + + int gzclose + int zp + + + gzclose ferme le pointeur zp. + + + + Retourne TRUE ou FALSE, suivant le succès ou l'echec. + + + + Le pointeur de fichier compressé doit être valide, et doit référencer un + fichier qui a été ouvert par gzopen. + + + + + + + + + gzeof + Teste la fin d'un fichier compressé. + + + Description + + int gzeof + int zp + + + Retourne TRUE si le pointeur interne du fichier compressé est à la fin du fichier, + sinon retourne FALSE. + + + + Le pointeur de fichier compressé doit être valide, et doit référencer un + fichier qui a été ouvert par gzopen. + + + + + + + + + gzfile + Lit la totalité d'un fichier compressé dans un tableau. + + + Description + + array gzfile + string filename + int use_include_path + + + Identique à readgzfile, mais gzfile + retourne un tableau. + + + + Vous pouvez aussi utiliser le deuxième paramètre optionnel en le mettant à "1", si + vous voulez rechercher le fichier dans le dossier + include_path. + + + + Voir aussi readgzfile, et gzopen. + + + + + + + + gzgetc + Lit un caractère d'un fichier compressé. + + + Description + + string gzgetc + int zp + + + Retourne une chaîne décompressée, qui contient un caractère unique, lu depuis le + fichier référencé par le pointeur zp. Retourne FALSE + à la fin du fichier (voir gzeof). + + +Le pointeur de fichier compressé doit être valide, et doit référencer un fichier qui a été ouvert par gzopen. + + Voir aussi + gzopen, et + gzgets. + + + + + + + + gzgets + Lit une ligne d'un fichier compressé + + + Description + + string gzgets + int zp + int length + + + +Retourne une chaîne décompressée, de longueur inférieure ou égale à length - 1 octets, lue depuis de fichier référencé par le pointeur de fichier fp. La lecture s'interromp lorsque length - 1 octets ont été lus, ou bien lorsqu'une nouvelle ligne a été rencontrée, ou bien lorsque la fin du fichier a été atteinte. + + + Si une erreur survient, retourne false. + + Le pointeur de fichier compressé doit être valide, et doit référencer un fichier qui a été ouvert par +gzopen. + + Voir aussi gzopen, + gzgetc, et fgets. + + + + + + + + gzgetss + Lit une ligne d'un fichier compressé et supprime les balises HTML + + + Description + + string gzgetss + int zp + int length + string allowable_tags + + +Identique à gzgets, mais gzgetss essaie de supprimer toutes +les balises HTML et PHP du texte lu. + + + Vous pouvez utiliser le troisième argument optionnel pour indiquer les balises qui +ne doivent pas être supprimées. + + + allowable_tags a été ajouté dans PHP 3.0.13, PHP4B3. + + + + Voir aussi gzgets, + gzopen, et strip_tags. + + + + + + + + gzopen + Ouvre un fichier compressé + + + Description + + int gzopen + string filename + string mode + int use_include_path + + +Ouvre un fichier compressé avec gzip (.gz) pour le lire ou l'écrire. +Le paramètre de mode est le même que dans fopen ("rb" ou "wb") +mais il peut aussi inclure un niveau de compression ("wb9") ou une stratégie: 'f' pour les données filtrées, comme dans "wb6f", 'h' pour Huffman seul , comme dans "wb1h". (Voir la description de deflateInit2 dans zlib.h pour plus de détails a propos des paramètres de stratégie). + + + +Gzopen peut être utilisé pour ouvrir des fichiers qui ne sont pas au format gzip; +dans ce cas, gzread lira directement le fichier, sans appliquer de décompression. + + + +Gzopen retourne un pointeur de fichier sur le fichier ouvert. Ce pointeur sera nécessaire pour toutes les opérations ultérieures sur ce fichier. Les opéraitions de compression/décompression seront transparaentes. + + + Si l'ouverture échoue, la fonction retourne FALSE. + + + You can use the optional third parameter and set it to "1", if + you want to search for the file in the include_path, too. + + + Exemple gzopen() + +$fp = gzopen("/tmp/file.gz", "r"); + + + + Voir aussi gzclose. + + + + + + + + gzpassthru + Lit toutes les informations restantes d'un fichier compressé + + + Description + + int gzpassthru + int zp + + +Lit toutes les informations d'un fichier compressé jusqu'à EOF et écrit le résultat décompressé dans la sortie standard. + + + + Si une erreur survient, retourne FALSE. + + +Le pointeur de fichier doit être valide, et avoir été ouvert par gzopen. + + +Le fichier pointé est refermé par gzpassthru ce qui le rends inutilisable +pour les opérations ultérieures. + + + + + + + + gzputs + Ecrit dans un fichier compressé + + + Description + + int gzputs + int zp + string str + int length + + + + gzputsest un alias de gzwrite, et lui est identique en tous points. + + + + + + + + gzread + Lit un fichier compressé en mode binaire + + + Description + + string gzread + int zp + int length + + + gzread lit jusqu'à length octets +depuis le fichier compressé référencé par zp. La +lecture stoppe lorsque length octets décompressés ont été lus, +ou que la fin du fichier a été trouvée. + + + + + +// lis le contenu d'un fichier compressé et le met dans une chaîne +$filename = "/usr/local/something.txt.gz"; +$zd = gzopen( $filename, "r" ); +$contents = gzread( $zd, 10000 ); +gzclose( $zd ); + + + + + Voir aussi gzwrite, gzopen, + gzgets, gzgetss, + gzfile, et gzpassthru. + + + + + + + gzrewind + Replace le pointeur courant au début du fichier + + + Description + + int gzrewind + int zp + + Positionne le pointeur interne du fichier au début du fichier compressé. + + Si une erreur survient, retourne 0. + Le pointeur de fichier doit être valide, et avoir été retourné par la fonction gzopen. + + Voir aussi gzseek et gztell. + + + + + + + gzseek + Déplace le pointeur courant dans un fichier compressé + + + Description + + int gzseek + int zp + int offset + + + Positionne le pointeur interne du fichier compressé zp à la position donnée en offset. Equivalent à l'appel (en C) de +gzseek( zp, offset, SEEK_SET ). + + +Si le fichier est ouvert en lecture seule, cette fonction émulée peut être extrêmement lente. Si le fichier est ouvert en lecture, seul le déplacement avant (forward seek) sont acceptés. gzseek compresse alors une séquence de zéro jusqu'à la nouvelle position. + + + +Retourne 0 en cas de succès, sinon retourne -1. Notez positionner le pointeur au delà de la fin du fichier est une erreur. + + + Voir aussi gztell et + gzrewind. + + + + + + + + gztell + Retourne la position courante du pointeur interne + + + Description + + int gztell + int zp + + +Retourne la position du pointeur interne du fichier référencé par zp, i.e., son offset en octets depuis le début du fichier. + + +Si une erreur survient, retourne FALSE. + + +Le pointeur de fichier doit être valide, et doit avoir été retourné par la fonction gzopen. + + Voir aussi gzopen, + gzseek et gzrewind. + + + + + + + gzwrite + Ecrit un fichier compressé en mode binaire + + + Description + + int gzwrite + int zp + string string + int length + + + gzwrite écrit le contenu de la chaîne string dans +le fichier compressé référencé par le pointeur zp. +Si l'argument length est donné, l'écriture cessera après avoir +écrit length octets (non compressé), ou bien si +la fin de la chaîne a été atteinte. + + + +Notez que si l'argument length est donnée, alors +l'option magic_quotes_runtime + sera ignorée et les slashes ne seront pas supprimés de la chaîne string. + + + Voir aussi gzread, gzopen, + et gzputs. + + + + + + readgzfile + Affiche un fichier compressé + + + Description + + int readgzfile + string filename + int use_include_path + + Lit un fichier, le décompresse et l'écrit dans la sortie standard. + + + Readgzfile() peut être utilisé pour lire un fichier qui n'est pas au format gzip, car dans ce cas, la décompression est omise, et le fichier est directement affiché. + + Retourne le nombre d'octets (non compressé) lus depuis le fichier. +Si une erreur survient, retourne FALSE, et à moins que la fonction n'ai été appelée +avec <email protected>, l'erreur est affichée. + + Le fichier filename sera ouvert et son contenu sera écrit danas la sortie standard. + + + + Vous pouvez utiliser le paramètre optionnel en le mettant à "1", si vous +voulez rechercher le fichier dans le dossier include_path. + + + Voir aussi gzpassthru, + gzfile, et gzopen. + + + + + + + gzcompress + Compresse une chaˆne avec Gz + + + Description + + + string gzcompress + string data + int + level + + + + + Cette fonction retourne la version compressé GZ de la chaîne + data, ou false en cas d'erreur. Le paramètre + level peut prendre des valeurs depuis 0 (pas de + compression) jusqu'à 9 (compression maximum). + + + Voir aussi gzuncompress. + + + + + + + gzuncompress + Décompresse une chaîne gz-compressée + + + Description + + + string gzuncompress + string data + int + length + + + + + gzuncompress prend la chaîne data + en entrée (compressée par gzcompress) et retourne + la chaîne originale, ou bien FALSE en cas d'erreur. Cette fonction + retournera une erreur si la taille de la chaîne décompressée est plus de + 256 fois la longueur de la chaîne compressée data + ou plus que le paramètre optionnel length. + + + Voir aussi gzcompress. + + + + + + + gzuncompress + D�compresse une cha$ine gz-compress�e + + + Description + + + string gzuncompress + string data + int + length + + + + + gzuncompress prend la cha�ne data + compress�e par gzcompress et retourne la cha�ne + originale d�compress�e, ou FALSE en cas d'erreur. + Cette fonctoin retourne une erreur si la cha�ne d�compress�e fait plus + de 256 fois la longueur de la cha�ne data ou plus de + length octets (optionnel). + + + Voir aussi gzcompress. + + + + + + +