cvs: phpdoc-fr /reference/zlib configure.xml constants.xml ini.xml reference.xml /reference/zlib/functions gzclose.xml gzcompress.xml gzdeflate.xml
gzencode.xml gzeof.xml gzfile.xml gzgetc.xml gzgets.xml gzgetss.xml gzinflate.xml gzopen.xml
| From: | Mehdi Achour | Date: | Fri, 27 Feb 2004 18:07:53 +0000 |
| Subject: | cvs: phpdoc-fr /reference/zlib configure.xml constants.xml ini.xml reference.xml /reference/zlib/functions gzclose.xml gzcompress.xml gzdeflate.xml gzencode.xml gzeof.xml gzfile.xml gzgetc.xml gzgets.xml gzgetss.xml gzinflate.xml gzopen.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-1891@lists.php.net to get a copy of this message | ||
didou Fri Feb 27 13:07:53 2004 EDT
Modified files:
/phpdoc-fr/reference/zlib configure.xml constants.xml ini.xml
reference.xml
/phpdoc-fr/reference/zlib/functions gzclose.xml gzcompress.xml
gzdeflate.xml gzencode.xml
gzeof.xml gzfile.xml gzgetc.xml
gzgets.xml gzgetss.xml
gzinflate.xml gzopen.xml
Log:
sync the first part
# ne pas toucher ce chapitre, j'ai pas fini, merci :)
http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/configure.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-fr/reference/zlib/configure.xml diff -u phpdoc-fr/reference/zlib/configure.xml:1.3 phpdoc-fr/reference/zlib/configure.xml:1.4 --- phpdoc-fr/reference/zlib/configure.xml:1.3 Wed Feb 25 07:41:59 2004 +++ phpdoc-fr/reference/zlib/configure.xml Fri Feb 27 13:07:52 2004 @@ -1,17 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <section id="zlib.installation"> &reftitle.install; <para> - Le support de Zlib dans &php; n'est pas activé par défaut. - Vous devez compiler &php; avec l'option + Le support de Zlib dans &php; n'est pas activé par défaut. + Vous devez compiler &php; avec l'option <option role="configure">--with-zlib[=DIR]</option>. </para> &windows.builtin; <note> <simpara> - Le support intégré de zlib est disponible depuis PHP 4.3.0. + Le support intégré de zlib est disponible depuis &php; 4.3.0. </simpara> </note> </section> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/constants.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-fr/reference/zlib/constants.xml diff -u phpdoc-fr/reference/zlib/constants.xml:1.2 phpdoc-fr/reference/zlib/constants.xml:1.3 --- phpdoc-fr/reference/zlib/constants.xml:1.2 Wed Feb 25 07:41:59 2004 +++ phpdoc-fr/reference/zlib/constants.xml Fri Feb 27 13:07:52 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> <section id="zlib.constants"> &reftitle.constants; &extension.constants; @@ -8,18 +8,18 @@ <varlistentry> <term> <constant>FORCE_GZIP</constant> - (<link linkend="language.types.integer">entier</link>) + (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>FORCE_DEFLATE</constant> - (<link linkend="language.types.integer">entier</link>) + <constant>FORCE_DEFLATE</constant> + (<type>integer</type>) </term> <listitem> <simpara> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/ini.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/zlib/ini.xml diff -u phpdoc-fr/reference/zlib/ini.xml:1.5 phpdoc-fr/reference/zlib/ini.xml:1.6 --- phpdoc-fr/reference/zlib/ini.xml:1.5 Wed Feb 25 07:41:59 2004 +++ phpdoc-fr/reference/zlib/ini.xml Fri Feb 27 13:07:52 2004 @@ -1,19 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> <section id="zlib.configuration"> &reftitle.runtime; &extension.runtime; <para> - L'extension zlib offre l'option de comprésser de manière transparente les - pages PHP à la volée, si le navigateur du visiteur le support. Voici donc + L'extension zlib offre l'option de compresser de manière transparente les + pages &php; à la volée, si le navigateur du visiteur le supporte. Voici donc les trois options à utiliser dans le &php.ini;. - <table> - &ini.table.title; - <tgroup cols="3"> - <thead> - &ini.table.top; - </thead> + <table> + &ini.table.title; + <tgroup cols="3"> + <thead> + &ini.table.top; + </thead> <tbody> <row> <entry>zlib.output_compression</entry> @@ -34,74 +34,75 @@ </tgroup> </table> &ini.table.bottom; -</para> + </para> &ini.descriptions.title; <para> - <variablelist> - <varlistentry id="ini.zlib.output-compression"> - <term> - <parameter>zlib.output_compression</parameter> - <type>booléen</type>/<type>entier</type> - </term> - <listitem> - <para> - Active ou pas la compression transparente des pages. Si cette - option est mise à "On" dans &php.ini; ou dans la configuration - Apache, les pages sont compressées si le navigateur envoie un - en-tête "Accept-Encoding: gzip" ou "deflate". - Les en-têtes "Content-Encoding: gzip" (respectivement "deflate") et - "Vary: Accept-Encoding" sont ajoutés dans la page envoyée au navigateur. - </para> - <para> - Vous pouvez utiliser <function>ini_set</function> pour désactiver - cette option dans votre script, si les en-têtes n'ont pas encore été - envoyé. Si vous émettez un en-tête de type - "Content-Type: image/", la compression sera désactivée aussi (afin - de parer à un bug de Netscape). Vous pouvez le réactiver en - ajoutant la ligne "ini_set('zlib.output_compression', 'On')" - après que les en-têtes aient été envoyés. - </para> - <para> - Cette option accepte aussi des valeurs entières au lieu des booléens, - "On"/"Off", ce qui vous permet de configurer la taille du buffer de sortie - (par défaut, il vaut 4ko). - </para> - <note> + <variablelist> + <varlistentry id="ini.zlib.output-compression"> + <term> + <parameter>zlib.output_compression</parameter> + <type>booléen</type>/<type>entier</type> + </term> + <listitem> + <para> + Active ou pas la compression transparente des pages. Si cette + option est mise à "On" dans &php.ini; ou dans la configuration + Apache, les pages sont compressées si le navigateur envoie un + en-tête "Accept-Encoding: gzip" ou "deflate". + Les en-têtes "Content-Encoding: gzip" (respectivement "deflate") et + "Vary: Accept-Encoding" sont ajoutés dans la page envoyée au navigateur. + </para> + <para> + Vous pouvez utiliser <function>ini_set</function> pour désactiver + cette option dans votre script, si les en-têtes n'ont pas encore été + envoyés. Si vous émettez un en-tête de type + "Content-Type: image/", la compression sera désactivée aussi (afin + de parer à un bogue de Netscape). Vous pouvez le réactiver en + ajoutant la ligne "ini_set('zlib.output_compression', 'On')" + après que les en-têtes qui ajoutent le Content-type de l'image aient + été envoyés. + </para> + <para> + Cette option accepte aussi des valeurs entières au lieu des booléens, + "On"/"Off", ce qui vous permet de configurer la taille du tampon de sortie + (par défaut, il vaut 4ko). + </para> + <note> + <para> + <link linkend="ini.output-handler">output_handler</link> doit être + laissée à vide si cette option est activée. Sinon, vous devez + utiliser zlib.output_handler. + </para> + </note> + </listitem> + </varlistentry> + + <varlistentry id="ini.zlib.output-compression-level"> + <term> + <parameter>zlib.output_compression_level</parameter> + <type>integer</type> + </term> + <listitem> + <para> + Niveau de compression utilisé pour la compression de sortie. + </para> + </listitem> + </varlistentry> + + <varlistentry id="ini.zlib.output-handler"> + <term> + <parameter>zlib.output_handler</parameter> + <type>string</type> + </term> + <listitem> <para> - <link linkend="ini.output-handler">output_handler</link> doit être - laissé à vide si cette option est activée. Sinon, vous devez - utiliser zlib.output_handler. + Vous ne pouvez pas spécifier de gestionnaire de sortie supplémentaire si + zlib.output_compression est activée. Cette configuration est la même que + <link linkend="ini.output-handler">output_handler</link> mais dans un + ordre différent. </para> - </note> - </listitem> - </varlistentry> - - <varlistentry id="ini.zlib.output-compression-level"> - <term> - <parameter>zlib.output_compression_level</parameter> - <type>integer</type> - </term> - <listitem> - <para> - Niveau de compression utilisé pour la compression de sortie. - </para> - </listitem> - </varlistentry> - - <varlistentry id="ini.zlib.output-handler"> - <term> - <parameter>zlib.output_handler</parameter> - <type>string</type> - </term> - <listitem> - <para> - Vous ne pouvez pas spécifier de gestionnaire de sortie supplémentaire si - zlib.output_compression est activée. Cette configuration est la même que - <link linkend="ini.output-handler">output_handler</link> mais dans un - ordre différent. - </para> - </listitem> - </varlistentry> + </listitem> + </varlistentry> </variablelist> </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/reference.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc-fr/reference/zlib/reference.xml diff -u phpdoc-fr/reference/zlib/reference.xml:1.8 phpdoc-fr/reference/zlib/reference.xml:1.9 --- phpdoc-fr/reference/zlib/reference.xml:1.8 Wed Feb 25 07:41:59 2004 +++ phpdoc-fr/reference/zlib/reference.xml Fri Feb 27 13:07:52 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.14 Maintainer: didou Status: ready --> <reference id="ref.zlib"> <title>Compression Zlib</title> <titleabbrev>Zlib</titleabbrev> @@ -9,26 +9,27 @@ <section id="zlib.intro"> &reftitle.intro; <para> - Ce module donne accès aux fichiers compressés avec l'utilitaire - gzip, grâce à des fonctions semblables aux fonctions d'accès - aux <link linkend="ref.filesystem">fichiers</link>, qui fonctionnent - avec les fichiers compressés ou non (mais pas avec les sockets). + Ce module vous permet de lire et ecrire de manière transparente + des fichiers compressés gzip (.gz), avec la plupart des fonctions + <link linkend="ref.filesystem">fichier</link> qui fonctionnent + avec les fichiers compressés en gzip (et les fichiers décompressés + aussi, mais pas avec les sockets). </para> <note> <para> La version 4.0.4 a introduit la version étendue de <function>fopen</function> - pour les fichiesr compressés avec GZ. Vous pouvez utiliser le préfixe spécial + pour les fichiers compressés avec GZ. Vous pouvez utiliser le préfixe spécial <literal>zlib:</literal> dans les URL pour accéder directement et de manière transparente aux fichiers compressés par GZ, avec toutes - les fonctions f* habituelles. + les fonctions f*() habituelles. </para> <para> - En version 4.3.0, ce préfixe spécial est remplacé par + En version 4.3.0, ce préfixe spécial est remplacé par <literal>zlib://</literal> pour éviter les ambiguités - avec les fichiers contenant des deux points <literal>:</literal>. + avec les noms de fichiers contenant des <literal>:</literal>. </para> <para> - Cette fonctionnalité requiert une librarie C qui fournisse la fonction + Cette fonctionnalité requière une librarie C qui fournit la fonction <literal>fopencookie()</literal>. A ma connaissance, la librairie GNU libc est la seule à fournir cette fonctionnalité. </para> @@ -67,8 +68,8 @@ <![CDATA[ <?php -$filename = tempnam ('/tmp', 'zlibtest').'.gz'; -print "<html>\n<head></head>\n<body>\n<pre>\n"; +$filename = tempnam('/tmp', 'zlibtest') . '.gz'; +echo "<html>\n<head></head>\n<body>\n<pre>\n"; $s = "C'est juste un test, test, test, test, test, test, test, test!\n"; // ouvre le fichier en écriture avec la compression maximale @@ -84,20 +85,20 @@ $zp = gzopen($filename, "r"); // lit 3 caractères -print gzread($zp, 3); +echo gzread($zp, 3); // affiche le reste du fichier, puis le ferme gzpassthru($zp); gzclose($zp); -print "\n"; +echo "\n"; // ouvre le fichier et affiche le fichier une seconde fois if (readgzfile($filename) != strlen($s)) { - echo "Erreur avec les fonctions zlib!"; + echo "Erreur avec les fonctions zlib!"; } unlink($filename); -print "</pre>\n</h1></body>\n</html>\n"; +echo "</pre>\n</body>\n</html>\n"; ?> ]]> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzclose.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/zlib/functions/gzclose.xml diff -u phpdoc-fr/reference/zlib/functions/gzclose.xml:1.6 phpdoc-fr/reference/zlib/functions/gzclose.xml:1.7 --- phpdoc-fr/reference/zlib/functions/gzclose.xml:1.6 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzclose.xml Fri Feb 27 13:07:53 2004 @@ -1,11 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzclose"> <refnamediv> <refname>gzclose</refname> - <refpurpose>Ferme un fichier compressé gzip</refpurpose> + <refpurpose>Ferme un pointeur sur fichier gz ouvert</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -14,16 +13,19 @@ <methodparam><type>resource</type><parameter>zp</parameter></methodparam> </methodsynopsis> <para> - <function>gzclose</function> referme le fichier compressé + <function>gzclose</function> referme le fichier compressé <parameter>zp</parameter>. </para> <para> &return.success; </para> <para> - <parameter>zp</parameter> doit être un fichier compressé valide, + <parameter>zp</parameter> doit être un pointeur valide, retourné par la fonction <function>gzopen</function>. </para> + <para> + Voir aussi <function>gzopen</function>. + </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzcompress.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc-fr/reference/zlib/functions/gzcompress.xml diff -u phpdoc-fr/reference/zlib/functions/gzcompress.xml:1.9 phpdoc-fr/reference/zlib/functions/gzcompress.xml:1.10 --- phpdoc-fr/reference/zlib/functions/gzcompress.xml:1.9 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzcompress.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.4 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <refentry id="function.gzcompress"> <refnamediv> <refname>gzcompress</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzdeflate.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc-fr/reference/zlib/functions/gzdeflate.xml diff -u phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.9 phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.10 --- phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.9 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzdeflate.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.11 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzdeflate"> <refnamediv> <refname>gzdeflate</refname> @@ -16,14 +15,13 @@ </methodsynopsis> <para> <function>gzdeflate</function> compresse la chaîne <parameter>data</parameter> - avec la méthode DEFLATE, ou &false; si une erreur survient. Le - paramètre optionnel <parameter>level</parameter> peut prendre des valeurs - comprises entre 0 (pas de compression) et 9 (compression maximale). Par - défaut, le niveau de compression est le niveau de la librairie - Zlib. + avec la méthode DEFLATE. Cette fonction retourne &false; si une erreur survient. + Le paramètre optionnel <parameter>level</parameter> peut prendre des valeurs + comprises entre 0 (pas de compression) et 9 (compression maximale). Par + défaut, le niveau de compression est le niveau de la librairie Zlib. </para> <para> - Pour plus de détails sur l'algorithme de compression DEFALTE, reportez-vous + Pour plus de détails sur l'algorithme de compression DEFALTE, reportez-vous à la RFC <ulink url="&url.rfc;1951">DEFLATE Compressed Data Format Specification version 1.3</ulink> (RFC 1951). </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzencode.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc-fr/reference/zlib/functions/gzencode.xml diff -u phpdoc-fr/reference/zlib/functions/gzencode.xml:1.10 phpdoc-fr/reference/zlib/functions/gzencode.xml:1.11 --- phpdoc-fr/reference/zlib/functions/gzencode.xml:1.10 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzencode.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.4 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzencode"> <refnamediv> <refname>gzencode</refname> @@ -15,15 +14,13 @@ <methodparam choice="opt"><type>int</type><parameter>level</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>encoding_mode</parameter></methodparam> </methodsynopsis> - <para> + <para> <function>gzencode</function> retourne la version compressée de la chaîne <parameter>data</parameter>, compatible avec le résultat - de la commande <command>gzip</command>. Cette fonction - retourne &false; si une erreur survient. Le paramètre optionnel - <parameter>level</parameter> peut prendre des valeurs comprises entre 0 - (pas de compression) et 9 (compression maximale). Par - défaut, le niveau de compression est le niveau de la librairie - Zlib. + de la commande <command>gzip</command> ou &false; si une erreur survient. + Le paramètre optionnel <parameter>level</parameter> peut prendre une valeur + comprise entre 0 (pas de compression) et 9 (compression maximale). Par + défaut, le niveau de compression est le niveau de la librairie Zlib. </para> <para> Vous pouvez aussi utiliser les constantes <constant>FORCE_GZIP</constant> @@ -34,11 +31,11 @@ sans la somme de contrôle finale CRC32. <note> <para> - <parameter>level</parameter> a été ajouté en PHP 4.2. Avant + <parameter>level</parameter> a été ajouté en &php; 4.2. Avant cette version <function>gzencode</function> n'utilisait que le paramètre <parameter>data</parameter> et optionnellement <parameter>encoding_mode</parameter>. - </para> + </para> </note> </para> <para> @@ -49,18 +46,18 @@ <programlisting role="php"> <![CDATA[ <?php - $data = implode("", file("bigfile.txt")); - $gzdata = gzencode($data, 9); - $fp = fopen("bigfile.txt.gz", "w"); - fwrite($fp, $gzdata); - fclose($fp); +$data = implode("", file("bigfile.txt")); +$gzdata = gzencode($data, 9); +$fp = fopen("bigfile.txt.gz", "w"); +fwrite($fp, $gzdata); +fclose($fp); ?> ]]> </programlisting> </example> </para> <para> - Pour plus de détails sur le format de fichier GZIP, reportez-vous + Pour plus de détails sur le format de fichier GZIP, reportez-vous à la RFC <ulink url="&url.rfc;1952">GZIP file format specification version 4.3</ulink> (RFC 1952). </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzeof.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-fr/reference/zlib/functions/gzeof.xml diff -u phpdoc-fr/reference/zlib/functions/gzeof.xml:1.7 phpdoc-fr/reference/zlib/functions/gzeof.xml:1.8 --- phpdoc-fr/reference/zlib/functions/gzeof.xml:1.7 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzeof.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <refentry id="function.gzeof"> <refnamediv> <refname>gzeof</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzfile.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/zlib/functions/gzfile.xml diff -u phpdoc-fr/reference/zlib/functions/gzfile.xml:1.5 phpdoc-fr/reference/zlib/functions/gzfile.xml:1.6 --- phpdoc-fr/reference/zlib/functions/gzfile.xml:1.5 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzfile.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> <refentry id="function.gzfile"> <refnamediv> <refname>gzfile</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzgetc.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc-fr/reference/zlib/functions/gzgetc.xml diff -u phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.8 phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.9 --- phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.8 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzgetc.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzgetc"> <refnamediv> <refname>gzgetc</refname> @@ -15,9 +14,8 @@ </methodsynopsis> <para> <function>gzgetc</function> retourne une chaîne contenant un - caractère unique (décompressé), lu dans le - fichier représenté par - <parameter>zp</parameter>. <function>gzgetc</function> retourne + caractère unique (décompressé), lu dans le fichier représenté par + <parameter>zp</parameter>. <function>gzgetc</function> retourne &false; si la fin du fichier est atteinte (contrairement à <function>gzeof</function>). </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzgets.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/zlib/functions/gzgets.xml diff -u phpdoc-fr/reference/zlib/functions/gzgets.xml:1.6 phpdoc-fr/reference/zlib/functions/gzgets.xml:1.7 --- phpdoc-fr/reference/zlib/functions/gzgets.xml:1.6 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzgets.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <refentry id="function.gzgets"> <refnamediv> <refname>gzgets</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzgetss.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-fr/reference/zlib/functions/gzgetss.xml diff -u phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.7 phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.8 --- phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.7 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzgetss.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzgetss"> <refnamediv> <refname>gzgetss</refname> @@ -19,10 +18,10 @@ <function>gzgetss</function> est identique à la fonction <function>gzgets</function>, hormis le fait que <function>gzgetss</function> supprime toutes les balises HTML et - PHP dans le texte lu. + &php; dans le texte lu. </para> <para> - Vous pouvez utiliser le troisième paramètre optionnel + Vous pouvez utiliser le troisième paramètre optionnel <parameter>allowable_tags</parameter> pour indiquer les balises que vous souhaitez conserver. <note> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzinflate.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/zlib/functions/gzinflate.xml diff -u phpdoc-fr/reference/zlib/functions/gzinflate.xml:1.6 phpdoc-fr/reference/zlib/functions/gzinflate.xml:1.7 --- phpdoc-fr/reference/zlib/functions/gzinflate.xml:1.6 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzinflate.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.11 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzinflate"> <refnamediv> <refname>gzinflate</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzopen.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-fr/reference/zlib/functions/gzopen.xml diff -u phpdoc-fr/reference/zlib/functions/gzopen.xml:1.7 phpdoc-fr/reference/zlib/functions/gzopen.xml:1.8 --- phpdoc-fr/reference/zlib/functions/gzopen.xml:1.7 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzopen.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> <refentry id="function.gzopen"> <refnamediv> <refname>gzopen</refname> @@ -17,32 +16,32 @@ </methodsynopsis> <para> <function>gzopen</function> ouvre le fichier <parameter>filename</parameter>, - compressé avec l'utilitaire gzip, en écriture ou en lecture. + compressé avec l'utilitaire gzip, en écriture ou en lecture. Le paramètre de mode <parameter>mode</parameter> prend les mêmes - valeurs que dans la fonction <function>fopen</function> ("rb" ou "wb"), + valeurs que pour la fonction <function>fopen</function> ("rb" ou "wb"), mais il accepte aussi un entier, qui représente un niveau de compression ("wb9") ou une heuristique : "f" pour filtrer les données - "wb6f", 'h' pour la compression Huffman seulement "wb1h". + "wb6f", 'h' pour la compression Huffman seulement "wb1h". (voir aussi la description de deflateInit2 dans zlib.h pour plus d'informations sur le paramètre d'heuristique). </para> <para> <function>gzopen</function> peut aussi servir pour lire des - fichiers qui ne sont pas compressés. Dans ce cas, + fichiers qui ne sont pas au format gzip. Dans ce cas, <function>gzread</function> lira le fichier, sans décompression. </para> <para> <function>gzopen</function> retourne une ressource de fichier. Tout ce que vous lirez à partir de ce pointeur sera décompressé à la - volée de manière transparente. + volée de manière transparente, tout ce que vous écrirez sera compressé. </para> <para> - Si l'ouverture du fichier échoue, <function>gzopen</function> + Si l'ouverture du fichier échoue, <function>gzopen</function> retourne &false;. </para> <para> - Vous pouvez utiliser le troisième paramètre optionnel - en lui donnant la valeur de <literal>1</literal>, si vous voulez + Vous pouvez utiliser le troisième paramètre optionnel + en lui donnant la valeur de <literal>1</literal>, si vous voulez rechercher le fichier dans l'<link linkend="ini.include-path">include_path</link>. </para> <para> @@ -51,15 +50,14 @@ <programlisting role="php"> <![CDATA[ <?php - $fp = gzopen ("/tmp/file.gz", "r"); +$fp = gzopen("/tmp/file.gz", "r"); ?> ]]> </programlisting> </example> </para> <para> - Voir aussi - <function>gzclose</function>. + Voir aussi <function>gzclose</function>. </para> </refsect1> </refentry>
http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/configure.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-fr/reference/zlib/configure.xml diff -u phpdoc-fr/reference/zlib/configure.xml:1.3 phpdoc-fr/reference/zlib/configure.xml:1.4 --- phpdoc-fr/reference/zlib/configure.xml:1.3 Wed Feb 25 07:41:59 2004 +++ phpdoc-fr/reference/zlib/configure.xml Fri Feb 27 13:07:52 2004 @@ -1,17 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <section id="zlib.installation"> &reftitle.install; <para> - Le support de Zlib dans &php; n'est pas activé par défaut. - Vous devez compiler &php; avec l'option + Le support de Zlib dans &php; n'est pas activé par défaut. + Vous devez compiler &php; avec l'option <option role="configure">--with-zlib[=DIR]</option>. </para> &windows.builtin; <note> <simpara> - Le support intégré de zlib est disponible depuis PHP 4.3.0. + Le support intégré de zlib est disponible depuis &php; 4.3.0. </simpara> </note> </section> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/constants.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-fr/reference/zlib/constants.xml diff -u phpdoc-fr/reference/zlib/constants.xml:1.2 phpdoc-fr/reference/zlib/constants.xml:1.3 --- phpdoc-fr/reference/zlib/constants.xml:1.2 Wed Feb 25 07:41:59 2004 +++ phpdoc-fr/reference/zlib/constants.xml Fri Feb 27 13:07:52 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> <section id="zlib.constants"> &reftitle.constants; &extension.constants; @@ -8,18 +8,18 @@ <varlistentry> <term> <constant>FORCE_GZIP</constant> - (<link linkend="language.types.integer">entier</link>) + (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>FORCE_DEFLATE</constant> - (<link linkend="language.types.integer">entier</link>) + <constant>FORCE_DEFLATE</constant> + (<type>integer</type>) </term> <listitem> <simpara> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/ini.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/zlib/ini.xml diff -u phpdoc-fr/reference/zlib/ini.xml:1.5 phpdoc-fr/reference/zlib/ini.xml:1.6 --- phpdoc-fr/reference/zlib/ini.xml:1.5 Wed Feb 25 07:41:59 2004 +++ phpdoc-fr/reference/zlib/ini.xml Fri Feb 27 13:07:52 2004 @@ -1,19 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: didou Status: ready --> <section id="zlib.configuration"> &reftitle.runtime; &extension.runtime; <para> - L'extension zlib offre l'option de comprésser de manière transparente les - pages PHP à la volée, si le navigateur du visiteur le support. Voici donc + L'extension zlib offre l'option de compresser de manière transparente les + pages &php; à la volée, si le navigateur du visiteur le supporte. Voici donc les trois options à utiliser dans le &php.ini;. - <table> - &ini.table.title; - <tgroup cols="3"> - <thead> - &ini.table.top; - </thead> + <table> + &ini.table.title; + <tgroup cols="3"> + <thead> + &ini.table.top; + </thead> <tbody> <row> <entry>zlib.output_compression</entry> @@ -34,74 +34,75 @@ </tgroup> </table> &ini.table.bottom; -</para> + </para> &ini.descriptions.title; <para> - <variablelist> - <varlistentry id="ini.zlib.output-compression"> - <term> - <parameter>zlib.output_compression</parameter> - <type>booléen</type>/<type>entier</type> - </term> - <listitem> - <para> - Active ou pas la compression transparente des pages. Si cette - option est mise à "On" dans &php.ini; ou dans la configuration - Apache, les pages sont compressées si le navigateur envoie un - en-tête "Accept-Encoding: gzip" ou "deflate". - Les en-têtes "Content-Encoding: gzip" (respectivement "deflate") et - "Vary: Accept-Encoding" sont ajoutés dans la page envoyée au navigateur. - </para> - <para> - Vous pouvez utiliser <function>ini_set</function> pour désactiver - cette option dans votre script, si les en-têtes n'ont pas encore été - envoyé. Si vous émettez un en-tête de type - "Content-Type: image/", la compression sera désactivée aussi (afin - de parer à un bug de Netscape). Vous pouvez le réactiver en - ajoutant la ligne "ini_set('zlib.output_compression', 'On')" - après que les en-têtes aient été envoyés. - </para> - <para> - Cette option accepte aussi des valeurs entières au lieu des booléens, - "On"/"Off", ce qui vous permet de configurer la taille du buffer de sortie - (par défaut, il vaut 4ko). - </para> - <note> + <variablelist> + <varlistentry id="ini.zlib.output-compression"> + <term> + <parameter>zlib.output_compression</parameter> + <type>booléen</type>/<type>entier</type> + </term> + <listitem> + <para> + Active ou pas la compression transparente des pages. Si cette + option est mise à "On" dans &php.ini; ou dans la configuration + Apache, les pages sont compressées si le navigateur envoie un + en-tête "Accept-Encoding: gzip" ou "deflate". + Les en-têtes "Content-Encoding: gzip" (respectivement "deflate") et + "Vary: Accept-Encoding" sont ajoutés dans la page envoyée au navigateur. + </para> + <para> + Vous pouvez utiliser <function>ini_set</function> pour désactiver + cette option dans votre script, si les en-têtes n'ont pas encore été + envoyés. Si vous émettez un en-tête de type + "Content-Type: image/", la compression sera désactivée aussi (afin + de parer à un bogue de Netscape). Vous pouvez le réactiver en + ajoutant la ligne "ini_set('zlib.output_compression', 'On')" + après que les en-têtes qui ajoutent le Content-type de l'image aient + été envoyés. + </para> + <para> + Cette option accepte aussi des valeurs entières au lieu des booléens, + "On"/"Off", ce qui vous permet de configurer la taille du tampon de sortie + (par défaut, il vaut 4ko). + </para> + <note> + <para> + <link linkend="ini.output-handler">output_handler</link> doit être + laissée à vide si cette option est activée. Sinon, vous devez + utiliser zlib.output_handler. + </para> + </note> + </listitem> + </varlistentry> + + <varlistentry id="ini.zlib.output-compression-level"> + <term> + <parameter>zlib.output_compression_level</parameter> + <type>integer</type> + </term> + <listitem> + <para> + Niveau de compression utilisé pour la compression de sortie. + </para> + </listitem> + </varlistentry> + + <varlistentry id="ini.zlib.output-handler"> + <term> + <parameter>zlib.output_handler</parameter> + <type>string</type> + </term> + <listitem> <para> - <link linkend="ini.output-handler">output_handler</link> doit être - laissé à vide si cette option est activée. Sinon, vous devez - utiliser zlib.output_handler. + Vous ne pouvez pas spécifier de gestionnaire de sortie supplémentaire si + zlib.output_compression est activée. Cette configuration est la même que + <link linkend="ini.output-handler">output_handler</link> mais dans un + ordre différent. </para> - </note> - </listitem> - </varlistentry> - - <varlistentry id="ini.zlib.output-compression-level"> - <term> - <parameter>zlib.output_compression_level</parameter> - <type>integer</type> - </term> - <listitem> - <para> - Niveau de compression utilisé pour la compression de sortie. - </para> - </listitem> - </varlistentry> - - <varlistentry id="ini.zlib.output-handler"> - <term> - <parameter>zlib.output_handler</parameter> - <type>string</type> - </term> - <listitem> - <para> - Vous ne pouvez pas spécifier de gestionnaire de sortie supplémentaire si - zlib.output_compression est activée. Cette configuration est la même que - <link linkend="ini.output-handler">output_handler</link> mais dans un - ordre différent. - </para> - </listitem> - </varlistentry> + </listitem> + </varlistentry> </variablelist> </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/reference.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc-fr/reference/zlib/reference.xml diff -u phpdoc-fr/reference/zlib/reference.xml:1.8 phpdoc-fr/reference/zlib/reference.xml:1.9 --- phpdoc-fr/reference/zlib/reference.xml:1.8 Wed Feb 25 07:41:59 2004 +++ phpdoc-fr/reference/zlib/reference.xml Fri Feb 27 13:07:52 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.14 Maintainer: didou Status: ready --> <reference id="ref.zlib"> <title>Compression Zlib</title> <titleabbrev>Zlib</titleabbrev> @@ -9,26 +9,27 @@ <section id="zlib.intro"> &reftitle.intro; <para> - Ce module donne accès aux fichiers compressés avec l'utilitaire - gzip, grâce à des fonctions semblables aux fonctions d'accès - aux <link linkend="ref.filesystem">fichiers</link>, qui fonctionnent - avec les fichiers compressés ou non (mais pas avec les sockets). + Ce module vous permet de lire et ecrire de manière transparente + des fichiers compressés gzip (.gz), avec la plupart des fonctions + <link linkend="ref.filesystem">fichier</link> qui fonctionnent + avec les fichiers compressés en gzip (et les fichiers décompressés + aussi, mais pas avec les sockets). </para> <note> <para> La version 4.0.4 a introduit la version étendue de <function>fopen</function> - pour les fichiesr compressés avec GZ. Vous pouvez utiliser le préfixe spécial + pour les fichiers compressés avec GZ. Vous pouvez utiliser le préfixe spécial <literal>zlib:</literal> dans les URL pour accéder directement et de manière transparente aux fichiers compressés par GZ, avec toutes - les fonctions f* habituelles. + les fonctions f*() habituelles. </para> <para> - En version 4.3.0, ce préfixe spécial est remplacé par + En version 4.3.0, ce préfixe spécial est remplacé par <literal>zlib://</literal> pour éviter les ambiguités - avec les fichiers contenant des deux points <literal>:</literal>. + avec les noms de fichiers contenant des <literal>:</literal>. </para> <para> - Cette fonctionnalité requiert une librarie C qui fournisse la fonction + Cette fonctionnalité requière une librarie C qui fournit la fonction <literal>fopencookie()</literal>. A ma connaissance, la librairie GNU libc est la seule à fournir cette fonctionnalité. </para> @@ -67,8 +68,8 @@ <![CDATA[ <?php -$filename = tempnam ('/tmp', 'zlibtest').'.gz'; -print "<html>\n<head></head>\n<body>\n<pre>\n"; +$filename = tempnam('/tmp', 'zlibtest') . '.gz'; +echo "<html>\n<head></head>\n<body>\n<pre>\n"; $s = "C'est juste un test, test, test, test, test, test, test, test!\n"; // ouvre le fichier en écriture avec la compression maximale @@ -84,20 +85,20 @@ $zp = gzopen($filename, "r"); // lit 3 caractères -print gzread($zp, 3); +echo gzread($zp, 3); // affiche le reste du fichier, puis le ferme gzpassthru($zp); gzclose($zp); -print "\n"; +echo "\n"; // ouvre le fichier et affiche le fichier une seconde fois if (readgzfile($filename) != strlen($s)) { - echo "Erreur avec les fonctions zlib!"; + echo "Erreur avec les fonctions zlib!"; } unlink($filename); -print "</pre>\n</h1></body>\n</html>\n"; +echo "</pre>\n</body>\n</html>\n"; ?> ]]> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzclose.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/zlib/functions/gzclose.xml diff -u phpdoc-fr/reference/zlib/functions/gzclose.xml:1.6 phpdoc-fr/reference/zlib/functions/gzclose.xml:1.7 --- phpdoc-fr/reference/zlib/functions/gzclose.xml:1.6 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzclose.xml Fri Feb 27 13:07:53 2004 @@ -1,11 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzclose"> <refnamediv> <refname>gzclose</refname> - <refpurpose>Ferme un fichier compressé gzip</refpurpose> + <refpurpose>Ferme un pointeur sur fichier gz ouvert</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -14,16 +13,19 @@ <methodparam><type>resource</type><parameter>zp</parameter></methodparam> </methodsynopsis> <para> - <function>gzclose</function> referme le fichier compressé + <function>gzclose</function> referme le fichier compressé <parameter>zp</parameter>. </para> <para> &return.success; </para> <para> - <parameter>zp</parameter> doit être un fichier compressé valide, + <parameter>zp</parameter> doit être un pointeur valide, retourné par la fonction <function>gzopen</function>. </para> + <para> + Voir aussi <function>gzopen</function>. + </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzcompress.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc-fr/reference/zlib/functions/gzcompress.xml diff -u phpdoc-fr/reference/zlib/functions/gzcompress.xml:1.9 phpdoc-fr/reference/zlib/functions/gzcompress.xml:1.10 --- phpdoc-fr/reference/zlib/functions/gzcompress.xml:1.9 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzcompress.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.4 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <refentry id="function.gzcompress"> <refnamediv> <refname>gzcompress</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzdeflate.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc-fr/reference/zlib/functions/gzdeflate.xml diff -u phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.9 phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.10 --- phpdoc-fr/reference/zlib/functions/gzdeflate.xml:1.9 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzdeflate.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.11 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzdeflate"> <refnamediv> <refname>gzdeflate</refname> @@ -16,14 +15,13 @@ </methodsynopsis> <para> <function>gzdeflate</function> compresse la chaîne <parameter>data</parameter> - avec la méthode DEFLATE, ou &false; si une erreur survient. Le - paramètre optionnel <parameter>level</parameter> peut prendre des valeurs - comprises entre 0 (pas de compression) et 9 (compression maximale). Par - défaut, le niveau de compression est le niveau de la librairie - Zlib. + avec la méthode DEFLATE. Cette fonction retourne &false; si une erreur survient. + Le paramètre optionnel <parameter>level</parameter> peut prendre des valeurs + comprises entre 0 (pas de compression) et 9 (compression maximale). Par + défaut, le niveau de compression est le niveau de la librairie Zlib. </para> <para> - Pour plus de détails sur l'algorithme de compression DEFALTE, reportez-vous + Pour plus de détails sur l'algorithme de compression DEFALTE, reportez-vous à la RFC <ulink url="&url.rfc;1951">DEFLATE Compressed Data Format Specification version 1.3</ulink> (RFC 1951). </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzencode.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc-fr/reference/zlib/functions/gzencode.xml diff -u phpdoc-fr/reference/zlib/functions/gzencode.xml:1.10 phpdoc-fr/reference/zlib/functions/gzencode.xml:1.11 --- phpdoc-fr/reference/zlib/functions/gzencode.xml:1.10 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzencode.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.4 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzencode"> <refnamediv> <refname>gzencode</refname> @@ -15,15 +14,13 @@ <methodparam choice="opt"><type>int</type><parameter>level</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>encoding_mode</parameter></methodparam> </methodsynopsis> - <para> + <para> <function>gzencode</function> retourne la version compressée de la chaîne <parameter>data</parameter>, compatible avec le résultat - de la commande <command>gzip</command>. Cette fonction - retourne &false; si une erreur survient. Le paramètre optionnel - <parameter>level</parameter> peut prendre des valeurs comprises entre 0 - (pas de compression) et 9 (compression maximale). Par - défaut, le niveau de compression est le niveau de la librairie - Zlib. + de la commande <command>gzip</command> ou &false; si une erreur survient. + Le paramètre optionnel <parameter>level</parameter> peut prendre une valeur + comprise entre 0 (pas de compression) et 9 (compression maximale). Par + défaut, le niveau de compression est le niveau de la librairie Zlib. </para> <para> Vous pouvez aussi utiliser les constantes <constant>FORCE_GZIP</constant> @@ -34,11 +31,11 @@ sans la somme de contrôle finale CRC32. <note> <para> - <parameter>level</parameter> a été ajouté en PHP 4.2. Avant + <parameter>level</parameter> a été ajouté en &php; 4.2. Avant cette version <function>gzencode</function> n'utilisait que le paramètre <parameter>data</parameter> et optionnellement <parameter>encoding_mode</parameter>. - </para> + </para> </note> </para> <para> @@ -49,18 +46,18 @@ <programlisting role="php"> <![CDATA[ <?php - $data = implode("", file("bigfile.txt")); - $gzdata = gzencode($data, 9); - $fp = fopen("bigfile.txt.gz", "w"); - fwrite($fp, $gzdata); - fclose($fp); +$data = implode("", file("bigfile.txt")); +$gzdata = gzencode($data, 9); +$fp = fopen("bigfile.txt.gz", "w"); +fwrite($fp, $gzdata); +fclose($fp); ?> ]]> </programlisting> </example> </para> <para> - Pour plus de détails sur le format de fichier GZIP, reportez-vous + Pour plus de détails sur le format de fichier GZIP, reportez-vous à la RFC <ulink url="&url.rfc;1952">GZIP file format specification version 4.3</ulink> (RFC 1952). </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzeof.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-fr/reference/zlib/functions/gzeof.xml diff -u phpdoc-fr/reference/zlib/functions/gzeof.xml:1.7 phpdoc-fr/reference/zlib/functions/gzeof.xml:1.8 --- phpdoc-fr/reference/zlib/functions/gzeof.xml:1.7 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzeof.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <refentry id="function.gzeof"> <refnamediv> <refname>gzeof</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzfile.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-fr/reference/zlib/functions/gzfile.xml diff -u phpdoc-fr/reference/zlib/functions/gzfile.xml:1.5 phpdoc-fr/reference/zlib/functions/gzfile.xml:1.6 --- phpdoc-fr/reference/zlib/functions/gzfile.xml:1.5 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzfile.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.2 Maintainer: didou Status: ready --> <refentry id="function.gzfile"> <refnamediv> <refname>gzfile</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzgetc.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc-fr/reference/zlib/functions/gzgetc.xml diff -u phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.8 phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.9 --- phpdoc-fr/reference/zlib/functions/gzgetc.xml:1.8 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzgetc.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzgetc"> <refnamediv> <refname>gzgetc</refname> @@ -15,9 +14,8 @@ </methodsynopsis> <para> <function>gzgetc</function> retourne une chaîne contenant un - caractère unique (décompressé), lu dans le - fichier représenté par - <parameter>zp</parameter>. <function>gzgetc</function> retourne + caractère unique (décompressé), lu dans le fichier représenté par + <parameter>zp</parameter>. <function>gzgetc</function> retourne &false; si la fin du fichier est atteinte (contrairement à <function>gzeof</function>). </para> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzgets.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/zlib/functions/gzgets.xml diff -u phpdoc-fr/reference/zlib/functions/gzgets.xml:1.6 phpdoc-fr/reference/zlib/functions/gzgets.xml:1.7 --- phpdoc-fr/reference/zlib/functions/gzgets.xml:1.6 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzgets.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.3 Maintainer: didou Status: ready --> <refentry id="function.gzgets"> <refnamediv> <refname>gzgets</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzgetss.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-fr/reference/zlib/functions/gzgetss.xml diff -u phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.7 phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.8 --- phpdoc-fr/reference/zlib/functions/gzgetss.xml:1.7 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzgetss.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzgetss"> <refnamediv> <refname>gzgetss</refname> @@ -19,10 +18,10 @@ <function>gzgetss</function> est identique à la fonction <function>gzgets</function>, hormis le fait que <function>gzgetss</function> supprime toutes les balises HTML et - PHP dans le texte lu. + &php; dans le texte lu. </para> <para> - Vous pouvez utiliser le troisième paramètre optionnel + Vous pouvez utiliser le troisième paramètre optionnel <parameter>allowable_tags</parameter> pour indiquer les balises que vous souhaitez conserver. <note> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzinflate.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/zlib/functions/gzinflate.xml diff -u phpdoc-fr/reference/zlib/functions/gzinflate.xml:1.6 phpdoc-fr/reference/zlib/functions/gzinflate.xml:1.7 --- phpdoc-fr/reference/zlib/functions/gzinflate.xml:1.6 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzinflate.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.11 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.4 Maintainer: didou Status: ready --> <refentry id="function.gzinflate"> <refnamediv> <refname>gzinflate</refname> http://cvs.php.net/diff.php/phpdoc-fr/reference/zlib/functions/gzopen.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-fr/reference/zlib/functions/gzopen.xml diff -u phpdoc-fr/reference/zlib/functions/gzopen.xml:1.7 phpdoc-fr/reference/zlib/functions/gzopen.xml:1.8 --- phpdoc-fr/reference/zlib/functions/gzopen.xml:1.7 Wed Feb 25 07:42:00 2004 +++ phpdoc-fr/reference/zlib/functions/gzopen.xml Fri Feb 27 13:07:53 2004 @@ -1,7 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> -<!-- splitted from ./en/functions/zlib.xml, last change in rev 1.2 --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.5 Maintainer: didou Status: ready --> <refentry id="function.gzopen"> <refnamediv> <refname>gzopen</refname> @@ -17,32 +16,32 @@ </methodsynopsis> <para> <function>gzopen</function> ouvre le fichier <parameter>filename</parameter>, - compressé avec l'utilitaire gzip, en écriture ou en lecture. + compressé avec l'utilitaire gzip, en écriture ou en lecture. Le paramètre de mode <parameter>mode</parameter> prend les mêmes - valeurs que dans la fonction <function>fopen</function> ("rb" ou "wb"), + valeurs que pour la fonction <function>fopen</function> ("rb" ou "wb"), mais il accepte aussi un entier, qui représente un niveau de compression ("wb9") ou une heuristique : "f" pour filtrer les données - "wb6f", 'h' pour la compression Huffman seulement "wb1h". + "wb6f", 'h' pour la compression Huffman seulement "wb1h". (voir aussi la description de deflateInit2 dans zlib.h pour plus d'informations sur le paramètre d'heuristique). </para> <para> <function>gzopen</function> peut aussi servir pour lire des - fichiers qui ne sont pas compressés. Dans ce cas, + fichiers qui ne sont pas au format gzip. Dans ce cas, <function>gzread</function> lira le fichier, sans décompression. </para> <para> <function>gzopen</function> retourne une ressource de fichier. Tout ce que vous lirez à partir de ce pointeur sera décompressé à la - volée de manière transparente. + volée de manière transparente, tout ce que vous écrirez sera compressé. </para> <para> - Si l'ouverture du fichier échoue, <function>gzopen</function> + Si l'ouverture du fichier échoue, <function>gzopen</function> retourne &false;. </para> <para> - Vous pouvez utiliser le troisième paramètre optionnel - en lui donnant la valeur de <literal>1</literal>, si vous voulez + Vous pouvez utiliser le troisième paramètre optionnel + en lui donnant la valeur de <literal>1</literal>, si vous voulez rechercher le fichier dans l'<link linkend="ini.include-path">include_path</link>. </para> <para> @@ -51,15 +50,14 @@ <programlisting role="php"> <![CDATA[ <?php - $fp = gzopen ("/tmp/file.gz", "r"); +$fp = gzopen("/tmp/file.gz", "r"); ?> ]]> </programlisting> </example> </para> <para> - Voir aussi - <function>gzclose</function>. + Voir aussi <function>gzclose</function>. </para> </refsect1> </refentry>